All agents

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

  1. Install Plannotator.

    curl -fsSL https://plannotator.ai/install.sh | bash
  2. Open the Inbox. It connects the agents it finds on this computer.

    plannotator inbox

    You should see Windsurf and the Claude app are connected if it finds them. Editors are never changed for you.

  3. 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-inbox server fails to start

An app started from the Dock may not see your shell’s PATH. Put the full path to plannotator in the config. which plannotator prints 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.

Every agent

Built by

With contributions from