Integrations

An inbox, wherever your agent runs.

Pidgeon is an MCP server your agent connects to. Add it once and the agent can create an address, wait for mail, read the code in it and answer in the thread.

01 · Coding agents

Set up in two minutes.

Add the URL and sign in: you choose what the agent can do and which address it reaches. Claude Code, Codex, Cursor and Gemini CLI also install it as a plugin, with the Pidgeon skill.

pidgeon-ai/pidgeon-plugins on GitHub

Claude Code: Set up Claude Code; Add Pidgeon to Claude Code and sign in, and it can create an address, read the code a sign-up emails it, and answer mail in the thread.
Cursor: Set up Cursor; 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.
Codex: Set up Codex; 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.
VS Code: Set up VS Code; Add Pidgeon to VS Code’s MCP config and sign in, and Copilot’s agent mode gets an address of its own.
OpenClaw: Set up OpenClaw; Install the Pidgeon channel and sign in, and email to your agent’s address starts an OpenClaw conversation and is answered in the thread.
Hermes: Set up Hermes; Install the Pidgeon plugin, and email to your agent’s address starts a Hermes conversation and is answered in the thread.

02 · Other agents

Anything that speaks MCP.

The same hosted server. Most sign in; the rest take an API key from your environment.

Claude and ChatGPT

Config

# Add a custom connector with this URL, then sign in
https://pidgeon.ai/api/mcp

OpenAI Agents SDK

The guide

Python example

TypeScript example

Python

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="pidgeon",
    params={
        "url": "https://pidgeon.ai/api/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['PIDGEON_API_KEY']}"},
    },
) as pidgeon:
    agent = Agent(name="Mailbox assistant", mcp_servers=[pidgeon])

LangChain

The guide

Python example

Python

# pip install langchain-pidgeon
from langchain.agents import create_agent
from langchain_pidgeon import PidgeonToolkit

agent = create_agent(
    "anthropic:claude-sonnet-5-5",
    tools=PidgeonToolkit().get_tools(),
)

Google ADK

The guide

Python example

Python

from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

pidgeon = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://pidgeon.ai/api/mcp",
        headers={"Authorization": f"Bearer {os.environ['PIDGEON_API_KEY']}"},
    ),
)
root_agent = Agent(model="gemini-flash-latest", name="mailbox_assistant", tools=[pidgeon])

Gemini CLI

Terminal

# The MCP server and the skill. Leave the key setting empty to sign in
gemini extensions install https://github.com/pidgeon-ai/pidgeon-plugins

# then, in Gemini CLI:
/mcp auth pidgeon

Windsurf and Devin

Config

{
  "mcpServers": {
    "pidgeon": {
      "serverUrl": "https://pidgeon.ai/api/mcp",
      "headers": { "Authorization": "Bearer ${env:PIDGEON_API_KEY}" }
    }
  }
}

Any MCP client

Terminal

PIDGEON_API_KEY=pgn_live_… npx -y @pidgeon-ai/mcp init

03 · No account yet

Let the agent sign itself up.

Paste this into any agent that can read a web page. It creates the account, asks you for the six-digit code Pidgeon emails you, and keeps its key.

Paste into your agent

Read pidgeon.ai/skill.md and get yourself an email address.

From hello to world in two minutes.

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

Get started