Integrations · Claude Code
Give Claude Code its own inbox
Add Pidgeon to Claude Code and sign in, and it can create an address, read the code a sign-up emails it, and answer mail in the thread.
01 · Set it up
4 steps, about two minutes.
01 · Add the server
Add --scope user to have it in every project, or --scope project to share it through .mcp.json.
claude mcp add --transport http pidgeon https://pidgeon.ai/api/mcp02 · Sign in
In Claude Code, open /mcp, pick pidgeon and sign in in the browser. You choose what it can do — read, read and send, or full access — and which address it reaches, or every address if you own the account. That becomes an API key under Developers → API keys → Connected apps, and Disconnect there ends it.
/mcp03 · Or install the plugin
The MCP server and the Pidgeon skill together. Leave the API key it asks for empty and Claude Code signs you in as above; enter one for an agent with nobody there to sign in, and it stays in the credential store.
/plugin marketplace add pidgeon-ai/pidgeon-plugins /plugin install pidgeon@pidgeon04 · Or connect with a key
For an agent with nobody there to sign in. The key comes from PIDGEON_API_KEY.
claude mcp add --transport http pidgeon https://pidgeon.ai/api/mcp \ --header "Authorization: Bearer $PIDGEON_API_KEY"
02 · Questions
Pidgeon in Claude Code
- Do I need an API key?
- Not to connect: the client signs you in to Pidgeon, and the access you choose there becomes a key the client holds for you. A key of your own is for an agent with nobody there to sign in — read from your environment, so it never lands in a config file. Either can be scoped to one address and one level of access.
- How do I disconnect a client?
- Under Developers → API keys → Connected apps. Disconnect ends its access on the client’s next call, and nothing else you have connected is affected.
- Can my agent sign itself up?
- Yes. Paste “Read pidgeon.ai/skill.md and get yourself an email address.” into the agent. It creates the account with two HTTP calls and asks you for the six-digit code Pidgeon emails you.
- What can the agent do once it is connected?
- Create addresses, read and search mail, wait for the next message with any verification code already extracted, send and reply in threads, label and file messages, and hand a thread to a person. Every inbound message carries a Pidgeon Firewall verdict.
- Is there a Claude Code plugin?
- Yes: pidgeon-ai/pidgeon-plugins on GitHub. It installs the hosted MCP server and the Pidgeon skill. The API key it asks for is optional: leave it empty and you sign in.
03 · Elsewhere