AssistantMail Create your Free account →

Quickstart: Agent email with allowlist & consent

Give each approved agent an address on assistant-mail.ai, while you stay in control of who they can email, how long content is kept, and how much they can send. Built for personal and small-team OpenClaw / Hermes operators who need allowlist, consent, retention, and spend caps—without jumping to AgentMail Developer→Startup pricing ($20→$200/mo) for small fleets.

Create your Free account →

MCP + ClawHub

npx @assistantmail/assistantmail-mcp

MCP setup · ClawHub skill install

Create a Free account

Free is enough to test safely before you scale:

  • 1 agent email
  • 25 emails per day
  • 24-hour email body retention
  • 1-week audit log retention

Free: you approve who your agent can email. Paid: recipients confirm consent before the agent can send.

Create your Free account →

Sign in, then open the dashboard to create addresses, approve recipients, and manage usage.

Get an API key

  1. Open API Keys in the dashboard.
  2. Create a new key.
  3. Copy it immediately — it is only shown once. Keys look like amk_...

Set this as ASSISTANT_MAIL_API_KEY in your MCP client or agent runtime. Mail API routes use a mailboxId (UUID), not the public email address. List mailboxes after connecting to discover IDs.

Install the MCP server (Cursor + Claude Desktop)

Requires Node.js 24+.

npx @assistantmail/assistantmail-mcp

Claude Desktop

{
  "mcpServers": {
    "assistantmail": {
      "command": "npx",
      "args": ["-y", "@assistantmail/assistantmail-mcp"],
      "env": { "ASSISTANT_MAIL_API_KEY": "amk_..." }
    }
  }
}

Cursor / VS Code (.cursor/mcp.json or .vscode/mcp.json)

{
  "servers": {
    "assistantmail": {
      "command": "npx",
      "args": ["-y", "@assistantmail/assistantmail-mcp"],
      "env": { "ASSISTANT_MAIL_API_KEY": "amk_..." }
    }
  }
}

Optional: ASSISTANT_MAIL_API_BASE_URL defaults to https://api.assistant-mail.ai. After connecting, call assistantmail_list_mailboxes first to get mailboxId.

OpenClaw / ClawHub skill

openclaw skills install @assistantmail/assistant-mail

Register the MCP command and set ASSISTANT_MAIL_API_KEY. Skill: https://clawhub.ai/assistantmail/skills/assistant-mail

Works with Hermes via the same MCP server. (Distribution listing — not an official OpenClaw endorsement claim.)

First send (allowlist & consent)

Free: you approve who your agent can email. Paid: recipients confirm consent before the agent can send.

  1. Create Free account → API key
  2. List mailboxes → store mailboxId
  3. Add/confirm recipients as required
  4. Send via MCP assistantmail_send_email or REST

Upgrade to Starter (in-app)

Free $0 (1 agent, 25/day) → Starter $9.99/mo (3 agents, 1,000/mo, 72h retention). Checkout is live in-app. Upgrade from your dashboard:

Upgrade in app

Troubleshooting

  • MCP won’t start: Node 24+; ASSISTANT_MAIL_API_KEY set
  • 401: key amk_... ; recreate in API Keys if lost
  • Can’t find mailbox: list_mailboxes; use UUID not email address
  • Send blocked: allowlist/consent; check list_recipients
  • Empty body: past retention (Free 24h)
  • Hit limits: Free 25/day; upgrade in-app

Privacy: /privacy.html · Terms: /terms.html