Any MCP agent
VS Code and Windsurf and Zed and Goose and JetBrains and the Claude app reach the Inbox through MCP. So does any agent that speaks MCP.
MCP only · Inbox through MCP and it reads your reply when it checks
Set it up
-
Install Plannotator.
curl -fsSL https://plannotator.ai/install.sh | bash -
Open the Inbox. It connects the agents it finds on this computer.
plannotator inboxYou should see Windsurf and the Claude app are connected if it finds them. Editors are never changed for you.
-
Add the Inbox to your agent as a stdio MCP server named
plannotator-inbox. Settings → Agents has the exact step for your app.plannotator inbox mcp
Other ways
VS Code
Use Install in VS Code in Settings → Agents, or run this.
code --add-mcp '{"name":"plannotator-inbox","type":"stdio","command":"plannotator","args":["inbox","mcp"]}' Windsurf
Adds it in every project.
devin mcp add -s user plannotator-inbox -- plannotator inbox mcp Zed
Merge it into Zed’s settings.
~/.config/zed/settings.json{ "context_servers": { "plannotator-inbox": { "command": "plannotator", "args": ["inbox", "mcp"], "env": {} } } } The Claude app
Merge it into mcpServers in Claude → Settings → Developer → Edit Config. Then quit and reopen Claude.
{ "mcpServers": { "plannotator-inbox": { "command": "plannotator", "args": ["inbox", "mcp"] } } } JetBrains
Paste it in Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add.
{ "mcpServers": { "plannotator-inbox": { "command": "plannotator", "args": ["inbox", "mcp"] } } } Goose
Use Add to Goose in Settings → Agents, or Extensions → Add custom extension → Standard IO with this command.
plannotator inbox mcp Check it works
Paste this into your agent.
Send me a test question in the Plannotator Inbox, and read my answer when I tell you I sent it. You should see A question arrives in the Inbox. Answer it and press Send. Tell your agent you sent it and it reads your answer.
Troubleshooting
- The
plannotator-inboxserver fails to start -
An app started from the Dock may not see your shell’s
PATH. Put the full path toplannotatorin the config.which plannotatorprints it. - claude.ai can’t reach the Inbox
-
claude.ai connectors can’t reach this computer. Use the Claude app.
- Your agent only takes an address
-
Use
http://127.0.0.1:<port>/mcp. Prefer the command: the port can change when the Inbox restarts. - Your reply never shows up in the session on its own
-
Nothing can wake an MCP agent: it sees a reply when it reads the thread. Tell it to check the Inbox.
What works
- Inbox tool MCP
- Reply wakes it Not woken
- Start from Inbox No
- Permission cards No
- Plan review No
- Code review No
- Annotate No
- Ask this session No
Examples
- Ask your agent to send you a guided review of its change. Comment on it in the Inbox.