agentmail-to/agentmail-mcp

AgentMail has one MCP tool implementation, hosted at:

https://mcp.agentmail.to/mcp

Use that Streamable HTTP endpoint directly when your client supports remote MCP. It provides the current runtime tool catalog and supports the hosted server's existing OAuth and per-request API-key paths. See the AgentMail MCP documentation.

stdio compatibility

The npm stdio bridge requires Node.js 20 or newer:

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

Python users can run the equivalent native bridge:

AGENTMAIL_API_KEY=YOUR_API_KEY uvx agentmail-mcp

Both bridges discover tools and schemas from the hosted server. They do not contain AgentMail SDK, toolkit, REST API, or tool-definition logic. --tools name1,name2 remains available for stdio clients that need a filtered catalog.

Repository

• packages/server: the hosted MCP server and only AgentMail tool implementation
• packages/npm-stdio-bridge: npm agentmail-mcp
• python/stdio-bridge: PyPI agentmail-mcp
• mcp-manifest.json: generated runtime contract
• tests: contract and transport checks
• docs: architecture, compatibility, migration, release, and operations

pnpm install
pnpm build
pnpm test
pnpm check:contract

The old local npm implementation is preserved at legacy-local-v0.2.2. Authentication hardening is a separate project; this consolidation preserves the hosted server's existing behavior.