Agenticmail MCP Server

by agenticmailio.github.agenticmail/mcpv0.5.59

Email and SMS for AI agents via a local mail server: disposable inboxes, sending and receiving email, and fetching verification codes.

236Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active26d ago

Install Agenticmail MCP server

claude mcp add agenticmail -e AGENTICMAIL_API_KEY='<agenticmail-api-key>' -e AGENTICMAIL_MASTER_KEY='<agenticmail-master-key>' -- npx -y @agenticmail/mcp

{
  "mcpServers": {
    "agenticmail": {
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "<agenticmail-api-key>",
        "AGENTICMAIL_MASTER_KEY": "<agenticmail-master-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "agenticmail": {
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "<agenticmail-api-key>",
        "AGENTICMAIL_MASTER_KEY": "<agenticmail-master-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "agenticmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "<agenticmail-api-key>",
        "AGENTICMAIL_MASTER_KEY": "<agenticmail-master-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "agenticmail": {
      "command": "npx",
      "args": [
        "-y",
        "@agenticmail/mcp"
      ],
      "env": {
        "AGENTICMAIL_API_KEY": "<agenticmail-api-key>",
        "AGENTICMAIL_MASTER_KEY": "<agenticmail-master-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
AGENTICMAIL_API_KEY	—	yes	Per-agent API key issued when you create the agent. Scopes every tool call to that agent's mailbox and outbound. Either AGENTICMAIL_API_KEY or AGENTICMAIL_MASTER_KEY must be set.
AGENTICMAIL_MASTER_KEY	—	yes	Master key for admin operations (creating agents, listing all accounts, deleting agents). Set this when the MCP client needs admin tools; otherwise prefer the per-agent AGENTICMAIL_API_KEY.
AGENTICMAIL_API_URL	—	—	Base URL of the AgenticMail HTTP API. Defaults to http://127.0.0.1:3100 (the port the local CLI binds). Override when the API runs on a different host or port.

Freshness

Active — last maintenance signal 26d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-13 · 26d ago · GitHub
Latest release
2026-06-05 · 4mo ago · GitHub · agenticmail-cli-v0.9.104
Package published
no data · npm/PyPI
Registry entry updated
2026-05-08 · 5mo ago · official registry · v0.5.59

FAQ

›How do I install the Agenticmail MCP server in Claude Code?

Run: claude mcp add agenticmail -e AGENTICMAIL_API_KEY='<agenticmail-api-key>' -e AGENTICMAIL_MASTER_KEY='<agenticmail-master-key>' -- npx -y @agenticmail/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Agenticmail require an API key?

Yes. It expects AGENTICMAIL_API_KEY, AGENTICMAIL_MASTER_KEY, of which 2 are secrets.

›Can I use Agenticmail as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Agenticmail in the official MCP registry?

Yes, as io.github.agenticmail/mcp.