Developer-friendly CLI for Mail.td — developer email platform with REST API, WebSocket, and MCP support.

• Instant inboxes — create a random email in one command
• Real-time — watch for new emails via WebSocket
• AI-native — built-in MCP server for Claude Code, Cursor, and other AI tools
• Pro support — custom domains, webhooks, API tokens
• Scriptable — auto JSON output in non-TTY, pipe-friendly

brew install mailtd/tap/mailtd

go install github.com/mailtd/mailtd-cli@latest

curl -fsSL https://raw.githubusercontent.com/mailtd/mailtd-cli/main/install.sh | sh

Download from GitHub Releases.

brew upgrade mailtd

go install github.com/mailtd/mailtd-cli@latest

curl -fsSL https://raw.githubusercontent.com/mailtd/mailtd-cli/main/install.sh | sh

# Authenticate with an API token (created at https://mail.td/pro/dashboard)
mailtd auth login td_xxxxxxxx...

# Create a random email instantly
mailtd quick

# Wait for the first email to arrive
mailtd wait

# Read it
mailtd read <message-id>

Run mailtd as an MCP server so AI tools can manage emails directly:

mailtd mcp

Add to .claude/settings.json:

{
  "mcpServers": {
    "mailtd": {
      "command": "mailtd",
      "args": ["mcp"]
    }
  }
}

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "mailtd": {
      "command": "mailtd",
      "args": ["mcp"]
    }
  }
}

11 tools are exposed: list_domains, create_account, quick_account, whoami, inbox, read_message, delete_message, delete_account, wait_for_email, list_accounts, switch_account.

• API docs: docs.mail.td
• SDKs: Node.js · Python · Go

MIT