Connect your local agent (twin-mcp)
Let Claude Desktop or another local MCP assistant navigate Twin for Mac and prepare drafts or events. Mail and calendar contents are private by default.
If you use Claude Desktop (or another local MCP client) on your Mac alongside your organisation's remote Twin connector, Twin for Mac includes a built-in local app controller (twin-mcp) under Settings › Connect your agent.
It pairs cleanly with your Twin's /mcp/graph connector:
- Your Twin's
/mcp/graphconnector reads your organisation's Twin Graph (Things and certified figures) under your sign-in. - Twin for Mac's local
twin-mcpdrives the running Mac app in front of you: opening the Thing, Channel, or record an answer just cited, switching Tabs, or preparing a reply or calendar event ready for you to check and send or confirm.
What assistants can read
twin-mcp is built around a strict local allow-list over a private Unix socket on your Mac:
- Mail and calendar contents are private by default: With Let assistants on this Mac control Twin on, the assistant only sees "an email" or "an event", not the contents. A separate test mode, Let assistants read and press anything in Twin, stays off unless you turn it on. In test mode, an assistant can read and click through what Twin shows, including your mail and calendar, so leave it off unless you're watching.
- With test mode off, irreversible actions always wait for you: Drafting a message, replying, or creating or joining a calendar event opens ready in front of you ("Prepared, waiting for the person"). Nothing is sent, deleted, or accepted until you confirm it yourself in Twin.
Set it up
Turn on local control in Twin for Mac
Open Twin on your Mac, go to Settings › Connect your agent, and switch on Let assistants on this Mac control Twin. While active, a quiet indicator in Twin's top bar reminds you that local control is on.
Add twin-mcp to your Claude Desktop config
Add /Applications/Twin.app/Contents/MacOS/twin-mcp to ~/Library/Application Support/Claude/claude_desktop_config.json under mcpServers, then quit and reopen Claude Desktop:
{
"mcpServers": {
"twin-app": {
"command": "/Applications/Twin.app/Contents/MacOS/twin-mcp"
}
}
}Verify with a safe first prompt
Ask Claude "Where is my Twin app?" It calls twin_app_state and tells you which section and Tabs are open.
Starter prompts once connected
Ask our Twin which customers have overdue invoices over 30 days, then open the top customer's Thing page right in my Twin for Mac app so I can inspect it.
Claude Desktop. Uses the Twin Graph for the answer, then opens the exact page in Twin for Mac.
Where is my Twin app right now? Open Calendar to this week and prepare a new 30-minute review event tomorrow at 10:00 for me to check and save.
Claude Desktop. Opens ready in Twin for Mac. Nothing sends or saves until you confirm it.
Mail, labels & Calendar
Read personal mail, run deterministic label rules on your Mac, schedule from ⌘K, and bring colleagues into an email only when you choose.
Connect your tools & AI
Use your Twin inside Slack, Microsoft Teams, Microsoft 365 Copilot, ChatGPT, Claude, Claude Code, Codex, and the Twin CLI.