Integrations · Cursor
Give your Cursor agent its own inbox
Install the Pidgeon plugin in Cursor and sign in, and its agent gets an address of its own — for sign-ups, test mail and real conversations.
01 · Set it up
4 steps, about two minutes.
01 · Install the plugin
The MCP server and the Pidgeon skill together, cloned where Cursor reads local plugins. Reload Cursor afterwards.
git clone https://github.com/pidgeon-ai/pidgeon-plugins.git ~/.cursor/plugins/local/pidgeon02 · Or add only the server
Without the skill: in your global config, or .cursor/mcp.json for one project. The URL is all it needs.
{ "mcpServers": { "pidgeon": { "url": "https://pidgeon.ai/api/mcp" } } }03 · Sign in
Either way, with no key set Cursor marks Pidgeon as needing sign-in. 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. If nothing opens, the MCP logs in the Output panel say why.
https://pidgeon.ai/api/mcp04 · Or connect with a key
For an agent with nobody there to sign in. Cursor fills ${env:PIDGEON_API_KEY} from your environment.
{ "mcpServers": { "pidgeon": { "url": "https://pidgeon.ai/api/mcp", "headers": { "Authorization": "Bearer ${env:PIDGEON_API_KEY}" } } } }
02 · Questions
Pidgeon in Cursor
- 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 Pidgeon in the Cursor Marketplace?
- Not yet. Today you clone the plugin from GitHub or add the server to mcp.json, as above; both connect to the same hosted server.
03 · Elsewhere