Pidgeon — Claude Code MCP server: what it does, how to install
Supplies AI agents with custom inboxes to receive emails, parse signup codes, and send replies. Helpful when automating registrations or handling inbound threads.
claude mcp add mcp -e PIDGEON_API_KEY=<PIDGEON_API_KEY> -- npx -y @pidgeon-ai/mcpWhat Pidgeon does
Pidgeon exposes email workflows to assistants via the Model Context Protocol. It allows an agent to generate new addresses, inspect entire threads, search messages, and send outbound mail. The await_message tool listens for incoming traffic and automatically isolates verification codes alongside confirmation links.
You can connect to the hosted endpoint at https://pidgeon.ai/api/mcp via OAuth or an API token, or run the local package via npx using @pidgeon-ai/mcp. Local execution demands Node.js and a valid PIDGEON_API_KEY credential. Without proper authentication, endpoints reject calls with HTTP status 401.
What it helps with
- Extract verification codes and activation links from inbound emails
- Generate dedicated email inboxes for automated agents
- Draft replies and manage conversational threads
- Inspect text attachments inside incoming messages
Example prompts for the agent
- Generate a new email address and wait for the verification code
- Check our inbox for messages regarding invoice 104 and draft a reply
- Read the attachment from the latest incoming email
How to install Pidgeon
1Platform CLI
claude mcp add mcp -e PIDGEON_API_KEY=<PIDGEON_API_KEY> -- npx -y @pidgeon-ai/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http mcp https://pidgeon.ai/api/mcp1Platform CLI: remote server
codex mcp add mcp --url https://pidgeon.ai/api/mcp2Platform CLI
codex mcp add mcp --env PIDGEON_API_KEY=<PIDGEON_API_KEY> -- npx -y @pidgeon-ai/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"url": "https://pidgeon.ai/api/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@pidgeon-ai/mcp"
],
"env": {
"PIDGEON_API_KEY": "<PIDGEON_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://pidgeon.ai/api/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pidgeon-ai/mcp"
],
"env": {
"PIDGEON_API_KEY": "<PIDGEON_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mcp https://pidgeon.ai/api/mcp2Platform CLI
gemini mcp add -e PIDGEON_API_KEY=<PIDGEON_API_KEY> mcp npx -y @pidgeon-ai/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Pidgeon
How to install Pidgeon in Claude Code?
Add the hosted HTTP server using claude mcp add --transport http mcp https://pidgeon.ai/api/mcp. Alternatively, run locally via stdio: claude mcp add mcp -e PIDGEON_API_KEY=<PIDGEON_API_KEY> -- npx -y @pidgeon-ai/mcp.
What does Pidgeon do?
It grants models access to an email API through MCP tools. Assistants can inspect mail headers, review conversation history, parse authentication codes, and write responses.
What is required to run Pidgeon?
You need an account or key from pidgeon.ai. For local stdio execution you need Node.js with npx and a PIDGEON_API_KEY, while the hosted URL can authenticate via browser OAuth.
