MCP server that gives your AI agent its own email inbox (Pidgeon).
Mailboxes for AI agents. Give your agents a proper mailbox, on a domain you own, so they can run email like you would — pidgeon.ai.
| Package | Install | What it is |
|---|---|---|
@pidgeon-ai/sdk | npm install @pidgeon-ai/sdk | The API client |
@pidgeon-ai/cli | npm install -g @pidgeon-ai/cli | Every endpoint as a command |
@pidgeon-ai/mcp | npx -y @pidgeon-ai/mcp init | The MCP server, for clients that cannot send a header |
A hosted MCP server needs no install at all: point any client that can send a
header at https://pidgeon.ai/api/mcp.
The SDK and the CLI are generated from openapi.json, which
is the contract the API validates against and is published at
https://pidgeon.ai/openapi.json. The application that serves it is closed
source; these clients are not, and this is where they are readable.
So a pull request against generated code cannot be merged as written — the fix belongs in the schema it came from. Open an issue instead and say what is wrong; that is the faster route either way, because a wrong field here is a wrong field in the published contract and in the Python client too.
Issues and questions: open one, or email support@pidgeon.ai. Documentation lives at pidgeon.ai/docs.
MIT licensed.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @pidgeon-ai/mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"ai-pidgeon-mcp": {
"command": "npx",
"args": [
"-y",
"@pidgeon-ai/mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencePidgeon works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.