Benethos Mailbox MCP
Give an agent access to your mailboxes through a self-hosted service, within token rights
- 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-mcpAdd 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.RequiredMAILBOX_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

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity