Skip to content
MCP server

Benethos Mailbox MCP

Give an agent access to your mailboxes through a self-hosted service, within token rights

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted, CLI, API
Runs
Locally
Version
0.7.4
Listing updated
2 days ago

About Benethos Mailbox MCP

Benethos Mailbox MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

The server is one layer of a four-package project that puts a single REST API in front of mailboxes from many providers. A self-hosted mailbox-service holds the connections and credentials, encrypted with AES-256-GCM, and everything else talks only to that service. This MCP server uses a service token, acts with that user's rights and offers only the mail tools the token allows.

Rights are fine-grained: a grant can restrict an agent to some folders, allow drafts only or sending to named recipients, cap sends per day and expire after a week. Mail content reaches the model marked as foreign text, and every send is recorded in an audit.

Behind the service sit IMAP and SMTP, JMAP such as Fastmail and Stalwart, POP3, Microsoft 365 and Outlook.com over Graph, and Gmail over its API. The project's own status is beta, and the server runs over stdio or Streamable HTTP.

Install

Run in a terminal

claude mcp add benethos-mailbox-mcp --env MAILBOX_SERVICE_TOKEN='<MAILBOX_SERVICE_TOKEN>' -- uvx benethos-mailbox-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "benethos-mailbox-mcp": {
      "command": "uvx",
      "args": [
        "benethos-mailbox-mcp"
      ],
      "env": {
        "MAILBOX_SERVICE_TOKEN": "<MAILBOX_SERVICE_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "benethos-mailbox-mcp": {
      "command": "uvx",
      "args": [
        "benethos-mailbox-mcp"
      ],
      "env": {
        "MAILBOX_SERVICE_TOKEN": "<MAILBOX_SERVICE_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "benethos-mailbox-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "benethos-mailbox-mcp"
      ],
      "env": {
        "MAILBOX_SERVICE_TOKEN": "<MAILBOX_SERVICE_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "benethos-mailbox-mcp": {
      "command": "uvx",
      "args": [
        "benethos-mailbox-mcp"
      ],
      "env": {
        "MAILBOX_SERVICE_TOKEN": "<MAILBOX_SERVICE_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "benethos-mailbox-mcp": {
      "command": "uvx",
      "args": [
        "benethos-mailbox-mcp"
      ],
      "env": {
        "MAILBOX_SERVICE_TOKEN": "<MAILBOX_SERVICE_TOKEN>"
      }
    }
  }
}

Configuration

  • MAILBOX_SERVICE_TOKENAn API token of mailbox-service, made on a user's page in its UI. The server acts with that user's rights.Required
  • MAILBOX_SERVICE_URLThe address of mailbox-service.
  • MAILBOX_SERVICE_ALLOW_HTTPSet to true to send the token over plain http to a service on another machine. Not needed for localhost or https.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

server_status
Reports the state of the mailbox service; always available.

What it does

Many providers, one API
Covers IMAP, JMAP, POP3, Microsoft Graph and Gmail accounts.
Token-scoped tools
Only the tools a token may use are offered.
Send guard rails
Grants can fix recipients and a daily send limit.
Drafts or sending
Rights decide whether the agent may send or only leave drafts.
Audit trail
Records every send by token, recipient and time.
Untrusted mail marking
Message content is flagged to the model as foreign text.

Good for

  • Move invoices from one sender into an accounting folder
  • Forward today's invoices to a tax advisor
  • Summarise a week's mail with attachments and draft a reply
  • Archive newsletters across several accounts

Pricing

Open source

Self-hosted; project is open source

Benethos Mailbox MCP FAQ

Does the agent ever see my mail password?

No. It gets only its own token; the service stores credentials encrypted.

Can I stop it from sending?

Yes. Grants can limit it to drafts, specific recipients and a daily send count.

Which providers work?

IMAP and SMTP hosts, JMAP, POP3, Microsoft 365 and Outlook.com, and Gmail.

Is it production-ready?

The project describes itself as beta.

Is Benethos Mailbox MCP free?

Yes. Benethos Mailbox MCP is open source, so you can use and self-host it for free.

How do I add Benethos Mailbox MCP to Claude Code?

Run this command in your terminal: claude mcp add benethos-mailbox-mcp --env MAILBOX_SERVICE_TOKEN='<MAILBOX_SERVICE_TOKEN>' -- uvx benethos-mailbox-mcp

What are the best alternatives to Benethos Mailbox MCP?

The closest alternatives to Benethos Mailbox MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to Benethos Mailbox MCP

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity