mailboxkit-mcp

MCP server for MailboxKit — email tools for AI agents.

Exposes MailboxKit inboxes as MCP tools so Claude Code, Cursor, and other MCP-aware agents can send, receive, and search emails.

Quick start

npx mailboxkit-mcp

Or install globally:

npm install -g mailboxkit-mcp
mailboxkit-mcp

Configuration

Set two environment variables:

| Variable | Required | Default | |---|---|---| | MAILBOXKIT_API_KEY | Yes | — | | MAILBOXKIT_BASE_URL | No | https://mailboxkit.com/api/v1 |

Claude Code

Add to your .claude/settings.json:

{
  "mcpServers": {
    "mailboxkit": {
      "command": "npx",
      "args": ["mailboxkit-mcp"],
      "env": {
        "MAILBOXKIT_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "mailboxkit": {
      "command": "npx",
      "args": ["mailboxkit-mcp"],
      "env": {
        "MAILBOXKIT_API_KEY": "your-api-key"
      }
    }
  }
}

Available tools

| Tool | Description | |---|---| | list_inboxes | List all inboxes in the organization | | create_inbox | Create a new inbox | | check_inbox | List recent messages in an inbox | | read_message | Read a specific message (marks it as read) | | send_email | Send an email from an inbox | | reply_to_email | Reply to a received message | | wait_for_email | Poll for a new incoming email (with timeout) | | search_messages | Search messages across inboxes |

Development

npm install
npm run build
npm run dev   # watch mode

License

MIT