Integrations · Codex
Give Codex its own inbox
Add Pidgeon to Codex and sign in, and the agent can create addresses, wait for mail and reply — from the CLI or the IDE extension.
01 · Set it up
4 steps, about two minutes.
01 · Add the server
The CLI and the IDE extension share the config this writes.
codex mcp add pidgeon --url https://pidgeon.ai/api/mcp02 · Sign in
Codex registers itself with Pidgeon and opens the sign-in in your 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.
codex mcp login pidgeon03 · Or install the plugin
The MCP server and the Pidgeon skill together; the last line signs you in. PIDGEON_API_KEY is optional, for an agent with nobody there to sign in.
codex plugin marketplace add pidgeon-ai/pidgeon-plugins codex plugin add pidgeon@pidgeon codex mcp login pidgeon04 · Or connect with a key
For an agent with nobody there to sign in. Put the key in your environment as PIDGEON_API_KEY, and Codex reads the bearer token from the variable you name.
[mcp_servers.pidgeon] url = "https://pidgeon.ai/api/mcp" bearer_token_env_var = "PIDGEON_API_KEY"
02 · Questions
Pidgeon in Codex
- 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 Codex plugin?
- Yes: pidgeon-ai/pidgeon-plugins on GitHub, added with codex plugin marketplace add. It installs the hosted MCP server and the Pidgeon skill and signs you in, or reads a key from PIDGEON_API_KEY when one is set.
03 · Elsewhere