Quickstart — Assistant Mail

1. Create Free + API key

1. Create Free account (button above).
2. Dashboard → API Keys → create → copy amk_... (shown once).
3. Set ASSISTANT_MAIL_API_KEY. Use mailboxId (UUID) from assistantmail_list_mailboxes — not the public address.

2. Install (pick one)

Node 24+

OpenClaw / ClawHub

openclaw skills install @assistantmail/assistant-mail

Then register the same MCP command + API key. Skill: https://clawhub.ai/assistantmail/skills/assistant-mail

MCP (Cursor / Claude Desktop / Hermes)

npx -y @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_..." }
    }
  }
}

3. First send

1. List mailboxes → save mailboxId
2. Approve recipients (Free) / consent (paid)
3. Send via MCP assistantmail_send_email

Stuck?

• MCP won’t start → Node 24+ and ASSISTANT_MAIL_API_KEY set
• 401 → recreate key in API Keys
• Send blocked → check recipients / allowlist
• Empty body → past Free retention window
• Need more quota → Upgrade in app