# Benethos Mailbox MCP

> Benethos Mailbox MCP is an open-source MCP server for communication. Give an agent access to your mailboxes through a self-hosted service, within token rights. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, API
- **Repository:** https://github.com/benethos-hub/mailbox
- **MCP Registry name:** io.github.benethos-hub/benethos-mailbox-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `server_status`: Reports the state of the mailbox service; always available.

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/benethos-mailbox-mcp
