courier-mcp

MCP server for durable AI agent email identity infrastructure. Create persistent inboxes, receive OTP codes, extract magic links, handle verification emails — not temporary burner mail.

For Hermes, Claude Code, Cursor, and any MCP-compatible agent framework.

Quick start

npm install -g courier-mcp

Then add to your MCP config:

{
  "mcpServers": {
    "courier": {
      "command": "courier-mcp"
    }
  }
}

Tools

| Tool | Description | |------|-------------| | create_inbox | Create a durable agent email identity. No signup. | | wait_for_email | Poll until an email arrives. Auto-retry. | | extract_otp | Get verification codes from inbox. | | extract_magic_link | Get magic links from inbox. | | get_inbox | Check inbox contents. |

Why agents need this

AI agents can't use Gmail. They can't do OAuth flows. They can't click "verify email" links in a browser.

Courier gives agents durable email identities — not disposable temp inboxes. Your agent's persistent inbox:

• Survives restarts and memory loss
• Uses scoped credentials (read/write/admin per inbox)
• Supports recovery through token rotation and CISO rebind
• Receives real SMTP mail and auto-extracts codes and links
• Provides governed outbound in controlled activation

Credential Storage

After creating an inbox, store credentials immediately in a secure file: ~/.hermes/secrets/courier/<agent_id>.json with chmod 600 permissions.

Store only the file path in memory — never the full token.

Related packages

• courier-protocol — Durable email identity protocol
• courier-agent-email — Python client (pip)

Links

Website: https://getcourier.dev API: https://getcourier.dev/capabilities GitHub: https://github.com/antonioac1/courier