Lumbox MCP Server

Give your AI agent a real email inbox. This MCP server connects Claude Code, Claude Desktop, Cursor, or any MCP client to Lumbox — create inboxes, wait for OTPs, read and search email, reply on threads, and automate signups end to end.

Quick start

Get an API key at app.lumbox.co → Settings → API Keys.

Claude Code

claude mcp add lumbox --env LUMBOX_API_KEY=ak_your_key -- npx -y @agentmailr/mcp-server

Claude Desktop / Cursor — add to claude_desktop_config.json or .cursor/mcp.json:

{
  "mcpServers": {
    "lumbox": {
      "command": "npx",
      "args": ["-y", "@agentmailr/mcp-server"],
      "env": {
        "LUMBOX_API_KEY": "ak_your_key"
      }
    }
  }
}

What your agent can do

"Create an inbox called support-bot"
"Wait for the verification email and give me the OTP"
"Check the support inbox and reply to the latest ticket"
"Enable auto-reply on this inbox with instructions: you are support for Acme"
"Sign up for notion.so using a fresh inbox and verify the email"

85 tools across:

• Inboxes — create, list, pause/resume, delete, auto-reply configuration
• Email — wait for email, read, search, send, reply, forward, OTP extraction, spam controls, safety checks
• Threads — list, fetch full conversation context, assign agents, routing rules
• Knowledge base — ingest docs, semantic search, ask questions over email + docs
• Browser — drive real signups/logins with the inbox in the loop
• Credential vault — store and use logins, TOTP codes
• Domains, webhooks, contacts, allow/blocklists, meeting bots

Environment variables

| Variable | Default | Description | |----------|---------|-------------| | LUMBOX_API_KEY | (required) | Your API key (ak_...) | | LUMBOX_API_URL | https://api.lumbox.co | API server URL |

Package names

Published under two identical names: @agentmailr/mcp-server and @lumbox/mcp-server. Either works; same code, same version.

Links

• Lumbox
• Dashboard
• Docs

MIT