Pidgeon

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.

  1. 01 · Install the plugin

    The MCP server and the Pidgeon skill together, cloned where Cursor reads local plugins. Reload Cursor afterwards.

    Terminal
    git clone https://github.com/pidgeon-ai/pidgeon-plugins.git ~/.cursor/plugins/local/pidgeon
  2. 02 · 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.

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "pidgeon": {
          "url": "https://pidgeon.ai/api/mcp"
        }
      }
    }
  3. 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.

    Paste
    https://pidgeon.ai/api/mcp
  4. 04 · Or connect with a key

    For an agent with nobody there to sign in. Cursor fills ${env:PIDGEON_API_KEY} from your environment.

    ~/.cursor/mcp.json
    {
      "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.

From hello to world in two minutes.

Free, and not a trial. No card, and nothing expires.

Get started