Connectors
Your iPhone is the connector for the apps with no API, like WhatsApp and iMessage. Use Mobster from the agent you already use, give Mobster’s agent the tools of the services you work in, and send what a task finds where you work.
In Mobster for Mac
Settings › Connectors › Add, next to Claude Code, Claude Desktop, Cursor or Codex.
Claude Code, from your terminal
claude mcp add --scope user mobster -- /Applications/Mobster.app/Contents/MacOS/mobster-agent mcpOr pick yours below: each guide has the setup, a first run, and what to do when it doesn’t connect.

Tested: we ran Mobster in it. The rest follow each client’s own docs.
Agents in your terminal
Command-line coding agents. One command adds Mobster to each.
- Tested
Claude Code
by Anthropic
One command adds the server. Claude then checks the screens it writes.
Set-up guide
Codex
by OpenAI
codex mcp add, plus a rule in AGENTS.md so it verifies its work.
Set-up guide
Gemini CLI
by Google
gemini mcp add at user scope, then trust the folder.
Set-up guide
opencode
by opencode
A local server in opencode.json, with a timeout for long runs.
Set-up guide
Goose
Added by hand
A JSON entry in its MCP config, from its docs.
MCP reference
Amp
Added by hand
A JSON entry in its MCP config, from its docs.
MCP reference
Editors and IDEs
The agent inside your editor reads Mobster from the editor’s MCP config.
Cursor
by Anysphere
One button in Mobster for Mac, or an entry in mcp.json.
Set-up guide
VS Code
by Microsoft
For Copilot’s agent mode, in .mcp.json or .vscode/mcp.json.
Set-up guide
Windsurf (Devin Desktop)
by Cognition
Now Devin Desktop: one file for Cascade and Devin Local.
Set-up guide
Zed
Added by hand
A JSON entry in its MCP config, from its docs.
MCP reference
Cline
Added by hand
A JSON entry in its MCP config, from its docs.
MCP reference
Google Antigravity
Added by hand
A JSON entry in its MCP config, from its docs.
The steps
Desktop apps
Chat apps on your Mac that start local MCP servers.
Claude Desktop
by Anthropic
One button in Mobster for Mac, then a restart.
Set-up guide
Any MCP client
Mobster speaks MCP over stdio, so any client that starts a local server can use it: the command is the agent inside Mobster for Mac, /Applications/Mobster.app/Contents/MacOS/mobster-agent, and its one argument is mcp.
{ "mcpServers": { "mobster": { "command": "/ Applications/ Mobster.app/ Contents/ MacOS/ mobster-agent", "args": ["mcp"] } }}Use in tasks
Mobster for Mac’s agent calls a service’s tools during a task, through the vendor’s own MCP server. Each tool is Allow, Ask or Block, and every tool asks first until you choose Allow. The use cases show a task for each.
Linear
Sign in with Linear
Find, create and update issues, then act on your iPhone.
How it works
Notion
Sign in with Notion
Search and read pages and databases, and add pages.
How it works
GitHub
Sign in with GitHub
Read issues and pull requests, and open or comment on them.
How it works
Sentry
Sign in with Sentry
Search issues and errors, and read their stack traces.
How it works
Expo
Sign in with Expo
List EAS builds and workflows, and read TestFlight crashes and reviews.
How it works
Jira
Sign in with Atlassian
Find, create and update Jira issues and Confluence pages.
How it works
Airtable
Sign in with Airtable
Read and write bases, tables and records.
How it works
ClickUp
Sign in with ClickUp
Find and update tasks, docs and time.
How it works
Zapier
Sign in with Zapier
Run actions in the apps your Zapier account connects.
How it works
Your own server
A URL or a command
Any MCP server: a URL, or a command Mobster starts on this Mac.
How it works
Send results
When a task finishes, Mobster for Mac sends its result where you choose: a row in a sheet, a page in Notion, a message, an email, or a file on your Mac.
Google Sheets
A row for each result, in the sheet you pick.
How it works
Notion
A page for each result, in a database you share with Mobster.
How it works
Discord
A message in a channel, through its webhook.
How it works
Email
To your own address, sent by Mail on your Mac.
How it works
A folder on your Mac
Each result added to a CSV or JSON Lines file.
How it works
Zapier, Make and n8n
Signed JSON to a webhook, then on to anything they reach.
How it works
MCP config file location by client
The file each client reads for local MCP servers on a Mac, and the command that adds Mobster to it, from each client’s own documentation as its page cites it.
Every client’s config file and command
| Client | Config file | Add Mobster |
|---|---|---|
| ~/.claude.json for you, or .mcp.json at the repository root for your team | One command, on its page | |
| Codex | ~/.codex/config.toml | One command, on its page |
| Cursor | ~/.cursor/mcp.json, or .cursor/mcp.json in a project | The JSON block, on its page |
| .mcp.json at the workspace root, or ~/.copilot/mcp-config.json | One command, on its page | |
| ~/Library/Application Support/Claude/claude_desktop_config.json | The JSON block, on its page | |
| Gemini CLI | ~/.gemini/settings.json | One command, on its page |
| ~/.config/opencode/opencode.json, or opencode.json in a project | The JSON block, on its page | |
| Windsurf (Devin Desktop) | ~/.config/devin/mcp_config.json | One command, on its page |
Questions
Should I use the app’s button, the one command or a guide?
In Mobster for Mac, Settings › Connectors adds Mobster to Claude Code, Claude Desktop, Cursor and Codex, one button each, under Use Mobster from…. Every other agent takes the same server from its MCP config. Open a client’s guide when you’d rather add it by hand, or when it doesn’t connect.
My agent isn’t listed. Can it use Mobster?
If it can start a local MCP server, yes. Mobster speaks MCP over stdio: the command is /Applications/Mobster.app/Contents/MacOS/mobster-agent, the agent inside Mobster for Mac, and its one argument is mcp. Most clients take the JSON block above.
Does Mobster need its own model key?
Not for your agent. Mobster has no hosted model, and the agents you connect bring their own. Mobster’s own agent runs on your Claude or OpenAI key, or in Mobster for Mac on a plan you already pay for, such as Claude Code, Codex or Gemini CLI.
What runs where?
Everything runs on your Mac: the MCP server, the simulator and the commands. No Mobster server sits between your agent and the phone. A result leaves your Mac only for the destination you chose, and a connector’s tool call only for that service’s own server.
Rather not edit config files?
Mobster for Mac sets up your iPhone and connects your agent in one window, then shows every step it takes.
Each logo is its owner’s trademark, shown only to name the product. Mobster isn’t affiliated with or endorsed by Anthropic, OpenAI, Anysphere, Microsoft, Google, opencode, Cognition, Linear, Notion, GitHub, Sentry, Expo, Atlassian, Airtable, ClickUp and Zapier.
