Integrations · Claude Code
Give Claude Code its own inbox
Install the Pidgeon plugin in Claude Code, and it can create an address, read the code a sign-up emails it, and answer mail in the thread.
01 · Set it up
3 steps, about two minutes.
01 · Get an API key
Sign up and create a key, or paste this line into the agent and let it sign itself up — it asks you for a six-digit code from your inbox and keeps the key it gets.
Read pidgeon.ai/skill.md and get yourself an email address.02 · Install the plugin
In Claude Code. It asks for your API key once and keeps it in the credential store, and installs the hosted MCP server and the Pidgeon skill together.
/plugin marketplace add pidgeon-ai/pidgeon-plugins /plugin install pidgeon@pidgeon03 · Or add the server directly
Without the plugin: one command, with the key in PIDGEON_API_KEY. 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/mcp \ --header "Authorization: Bearer $PIDGEON_API_KEY"
02 · Questions
Pidgeon in Claude Code
- Do I need an API key?
- Yes, today. The MCP server authenticates with a Pidgeon API key sent as a bearer token, read from your environment so it never lands in a config file. A key can be scoped to one address and one level of access.
- 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, and asks for your API key once. You still need a key: the server does not have a sign-in flow yet.
03 · Elsewhere