agentmail-mcp

AgentMail MCP Server

Connect AgentMail to any MCP-compatible AI client. Three setup options available.

Prerequisites

Get your API key from console.agentmail.to.

---

Option 1: Remote MCP (Simplest)

No installation required. Connect directly to the hosted MCP server.

URL: https://mcp.agentmail.to

Authentication: OAuth 2.0 via Smithery. The remote server does NOT accept an API key in env — it returns 401 Bearer error="invalid_token" and redirects your MCP client through the OAuth authorization server at https://auth.smithery.ai/agentmail. The MCP client handles the browser-based consent flow automatically on first connect.

Add to your MCP client configuration:

{
  "mcpServers": {
    "AgentMail": {
      "url": "https://mcp.agentmail.to"
    }
  }
}

On first use, your MCP client opens a browser window to complete the Smithery OAuth flow; after approval, tokens are cached by the client. If you need API-key auth (no OAuth flow), use Option 2 or Option 3 below instead.

---

Option 2: Local npm Package

Run the MCP server locally via npx.

{
  "mcpServers": {
    "AgentMail": {
      "command": "npx",
      "args": ["-y", "agentmail-mcp"],
      "env": {
        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Tool Selection

Load only specific tools with the --tools argument:

{
  "mcpServers": {
    "AgentMail": {
      "command": "npx",
      "args": [
        "-y",
        "agentmail-mcp",
        "--tools",
        "send_message,reply_to_message,list_inboxes"
      ],
      "env": {
        "AGENTMAIL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

---

Option 3: Local Python Package

Install and run the Python MCP server.

pip install agentmail-mcp

Claude Desktop

Config location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

The server accepts the API key in two ways: via AGENTMAIL_API_KEY env var, or via the --api-key CLI flag. Use whichever works in your MCP client's launcher environment.