Courier — Temporary Email Inboxes for AI Agents

Quick Start

# Create a temporary email inbox (5 seconds, no signup, no auth)
curl -X POST https://getcourier.dev/alias \
  -H "Content-Type: application/json" \
  -d '{"purpose":"otp","agent":"my-agent"}'

# Check for received codes and links
curl -s https://getcourier.dev/messages | jq '.messages[] | {subject, codes, links}'

What is Courier?

Courier is inbound email infrastructure for autonomous agents. It gives AI agents disposable email inboxes that receive real SMTP email and automatically extract verification codes, magic links, and authentication URLs.

What it is:

• A temporary email API for AI agents
• An MCP server for agent frameworks
• A zero-dependency Python/Node client
• Real SMTP email reception, not simulation

What it is NOT:

• NOT a notification provider (like Courier push notifications)
• NOT an outbound email service (like SendGrid, Mailgun)
• NOT a human email client (like Gmail, Outlook)
• NOT an email validation service

Why Agents Need It

AI agents can't click "Forgot Password" and wait for an inbox. They can't receive verification codes during signup. Courier solves this:

Service sends email → SMTP port 25 → Courier extracts codes/links → Agent retrieves via API → Continue execution

Framework Integration

Hermes Agent

# ~/.hermes/config.yaml
mcp_servers:
  courier:
    command: "courier-mcp"

Tools available: create_inbox, wait_for_email, extract_otp, extract_magic_link, get_inbox

Claude Desktop

{
  "mcpServers": {
    "courier": {
      "command": "npx",
      "args": ["-y", "courier-mcp"]
    }
  }
}

Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "courier": {
      "command": "npx",
      "args": ["-y", "courier-mcp"]
    }
  }
}

OpenAI Agents SDK / CrewAI / LangGraph / AutoGen / OpenHands

pip install courier-agent-email

from courier_agent import CourierAgent

agent = CourierAgent()
inbox = agent.create_inbox()             # Create inbox
email = agent.wait_for_email(timeout=60)  # Auto-poll for email
otp = agent.extract_otp()                # Extract OTP codes
link = agent.extract_magic_link()        # Extract magic links

OpenClaw

npm install -g courier-mcp
# Add to MCP config: courier-mcp as command

Python (zero dependencies)

pip install courier-agent-email
# Or download single-file: cur

... [View full README on GitHub](https://github.com/antonioac1/courier#readme)