Pidgeon

Integrations · VS Code

Give GitHub Copilot in VS Code its own inbox

Add Pidgeon to VS Code’s MCP config and sign in, and Copilot’s agent mode gets an address of its own.

01 · Set it up

3 steps, about two minutes.

  1. 01 · Add the server

    In your workspace’s .vscode/mcp.json. The URL is all it needs.

    .vscode/mcp.json
    {
      "servers": {
        "pidgeon": {
          "type": "http",
          "url": "https://pidgeon.ai/api/mcp"
        }
      }
    }
  2. 02 · Sign in

    When the server first starts, VS Code sends you to Pidgeon to 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.

    Paste
    https://pidgeon.ai/api/mcp
  3. 03 · Or connect with a key

    For an agent with nobody there to sign in. VS Code prompts for the key the first time and keeps it in its secret storage, so nothing is written to the file.

    .vscode/mcp.json
    {
      "inputs": [
        { "type": "promptString", "id": "pidgeon-key", "description": "Pidgeon API key", "password": true }
      ],
      "servers": {
        "pidgeon": {
          "type": "http",
          "url": "https://pidgeon.ai/api/mcp",
          "headers": { "Authorization": "Bearer ${input:pidgeon-key}" }
        }
      }
    }

02 · Questions

Pidgeon in VS 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.

From hello to world in two minutes.

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

Get started