MCP server that gives your AI agent its own email inbox (Pidgeon).
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add pidgeon --env PIDGEON_API_KEY='<PIDGEON_API_KEY>' -- npx -y @pidgeon-ai/mcp~/.codex/config.toml
[mcp_servers.pidgeon]
command = "npx"
args = ["-y", "@pidgeon-ai/mcp"]
env = { PIDGEON_API_KEY = "<PIDGEON_API_KEY>" }
# codex mcp add pidgeon --env PIDGEON_API_KEY='<PIDGEON_API_KEY>' -- npx -y @pidgeon-ai/mcp~/.cursor/mcp.json
{
"mcpServers": {
"pidgeon": {
"command": "npx",
"args": [
"-y",
"@pidgeon-ai/mcp"
],
"env": {
"PIDGEON_API_KEY": "<PIDGEON_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"pidgeon": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pidgeon-ai/mcp"
],
"env": {
"PIDGEON_API_KEY": "<PIDGEON_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"pidgeon": {
"command": "npx",
"args": [
"-y",
"@pidgeon-ai/mcp"
],
"env": {
"PIDGEON_API_KEY": "<PIDGEON_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"pidgeon": {
"command": "npx",
"args": [
"-y",
"@pidgeon-ai/mcp"
],
"env": {
"PIDGEON_API_KEY": "<PIDGEON_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"pidgeon": {
"command": "npx",
"args": [
"-y",
"@pidgeon-ai/mcp"
],
"env": {
"PIDGEON_API_KEY": "<PIDGEON_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http pidgeon https://pidgeon.ai/api/mcp --header 'Authorization: Bearer <PIDGEON_API_KEY>'~/.codex/config.toml
[mcp_servers.pidgeon]
url = "https://pidgeon.ai/api/mcp"
bearer_token_env_var = "PIDGEON_API_KEY"
# codex mcp add pidgeon --url https://pidgeon.ai/api/mcp --bearer-token-env-var PIDGEON_API_KEY
# export PIDGEON_API_KEY=<PIDGEON_API_KEY>~/.cursor/mcp.json
{
"mcpServers": {
"pidgeon": {
"url": "https://pidgeon.ai/api/mcp",
"headers": {
"Authorization": "Bearer <PIDGEON_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"pidgeon": {
"type": "http",
"url": "https://pidgeon.ai/api/mcp",
"headers": {
"Authorization": "Bearer <PIDGEON_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"pidgeon": {
"httpUrl": "https://pidgeon.ai/api/mcp",
"headers": {
"Authorization": "Bearer <PIDGEON_API_KEY>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"pidgeon": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pidgeon.ai/api/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <PIDGEON_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"pidgeon": {
"url": "https://pidgeon.ai/api/mcp",
"headers": {
"Authorization": "Bearer <PIDGEON_API_KEY>"
}
}
}
}Environment variables
PIDGEON_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.