Benethos Mailbox MCP

Name: Benethos Mailbox MCP
Author: benethos-hub

by benethos-hubversion 0.7.0i★ 3iRuns on your computer

Registry nameio.github.benethos-hub/benethos-mailbox-mcp

How to install

What it does

MCP server that gives AI agents your mailboxes through mailbox-service, within its token's rights.

Connects Runs on your computer
Account or key Needs MAILBOX_SERVICE_TOKEN
Category Other

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Download the maker’s installer
Download the maker’s .mcpb file
The .mcpb file comes straight from the maker; we do not change it
Done
Double-click the file, then click Install in the Claude desktop app
Done
Try it
Use Benethos Mailbox MCP and tell me what you can do for me, then show me one thing
✓ If Claude says it is using Benethos Mailbox MCP or shows a Benethos Mailbox MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Benethos Mailbox MCP yet

Benethos Mailbox MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Benethos Mailbox MCP

Steps for Claude →No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone
Steps for Claude Code →You need a Benethos Mailbox MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Steps for Cursor →You need a Benethos Mailbox MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Steps for VS Code →You need a Benethos Mailbox MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Hostinger✓ ChatGPT
World Monitor✓ ChatGPT
Svelte MCP✓ ChatGPT

Works with Claude Code, with some setup first

You need a Benethos Mailbox MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a Benethos Mailbox MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the Benethos Mailbox MCP site ↗
Done
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done

Paste this command and press Enter

claude mcp add --scope user benethos-mailbox --env MAILBOX_SERVICE_TOKEN=your-value --env MAILBOX_SERVICE_URL=your-value --env MAILBOX_SERVICE_ALLOW_HTTP=your-value -- uvx benethos-mailbox-mcp

Replace “your-value” with your key before pressing Enter

Paste the key only into the app’s field, never into a chat or to anyone

Done

Type /mcp in Claude Code
You should see Benethos Mailbox MCP listed as connected
Done
Try it
Use Benethos Mailbox MCP and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using Benethos Mailbox MCP or shows a Benethos Mailbox MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Benethos Mailbox MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a Benethos Mailbox MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the Benethos Mailbox MCP site ↗
Done
Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Fill in your key
In the Benethos Mailbox MCP settings, MAILBOX_SERVICE_TOKEN, MAILBOX_SERVICE_URL, MAILBOX_SERVICE_ALLOW_HTTP is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use Benethos Mailbox MCP and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using Benethos Mailbox MCP or shows a Benethos Mailbox MCP tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Benethos Mailbox MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Sign up and create a Benethos Mailbox MCP key
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Open the Benethos Mailbox MCP site ↗
Done
Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Fill in your key
In the Benethos Mailbox MCP settings, MAILBOX_SERVICE_TOKEN, MAILBOX_SERVICE_URL, MAILBOX_SERVICE_ALLOW_HTTP is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use Benethos Mailbox MCP and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using Benethos Mailbox MCP or shows a Benethos Mailbox MCP tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Benethos Mailbox MCP💬 Discussion →

For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user benethos-mailbox --env MAILBOX_SERVICE_TOKEN=your-value --env MAILBOX_SERVICE_URL=your-value --env MAILBOX_SERVICE_ALLOW_HTTP=your-value -- uvx benethos-mailbox-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "benethos-mailbox": {
      "command": "uvx",
      "args": [
        "benethos-mailbox-mcp"
      ],
      "env": {
        "MAILBOX_SERVICE_TOKEN": "your-value",
        "MAILBOX_SERVICE_URL": "your-value",
        "MAILBOX_SERVICE_ALLOW_HTTP": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "benethos-mailbox": {
      "command": "uvx",
      "args": [
        "benethos-mailbox-mcp"
      ],
      "env": {
        "MAILBOX_SERVICE_TOKEN": "your-value",
        "MAILBOX_SERVICE_URL": "your-value",
        "MAILBOX_SERVICE_ALLOW_HTTP": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "benethos-mailbox": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "benethos-mailbox-mcp"
      ],
      "env": {
        "MAILBOX_SERVICE_TOKEN": "your-value",
        "MAILBOX_SERVICE_URL": "your-value",
        "MAILBOX_SERVICE_ALLOW_HTTP": "your-value"
      }
    }
  }
}

Values you fill in

MAILBOX_SERVICE_TOKEN secret required env
An API token of mailbox-service, made on a user's page in its UI. The server acts with that user's rights.
MAILBOX_SERVICE_URL env
The address of mailbox-service.
MAILBOX_SERVICE_ALLOW_HTTP env
Set to true to send the token over plain http to a service on another machine. Not needed for localhost or https.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub stars i: 3
Downloads per weeki: 111/wk
Licence i: MIT
Connection: Runs on your computer
Transport: stdio
Latest versioni: 0.7.0
Categoryi: Other
Published to registryi: Nov 10, 2026
Code last changedi: Nov 12, 2026
Maker: benethos-hub
Packages: pypi: benethos-mailbox-mcp
mcpb: …/benethos-mailbox-mcp-0.7.0.mcpb
Repo: benethos-hub/mailbox
Website: github.com
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 13, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account benethos-hub, which owns the repo
✓ Pass
Still maintained
Code last changed yesterday
✓ Pass
Has a licence
Uses MIT
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Otheri

More stars than 93% of the other 19479 servers in this category
Published to the registry more recently than 93% of the other 19479 servers in this category
Basic checks equal to or better than 100% of the other 19479 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Benethos Mailbox MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: MAILBOX_SERVICE_TOKEN

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (0.7.0) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv), MCPB on your computer.

What can I use instead?

In the same category: World Monitor, Claude Flow, Windmill

Others in the same category

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 104 tools.

by koala73Widely used★ 90.5KUpdated yesterday

Runs in the cloud✓ service owner · worldmonitor.app

How to connect

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

by ruvnetWidely used↓ 13.5K/wk★ 81.5KUpdated 14 months ago

Runs on your computer

Install

Windmill

Run Windmill scripts and flows and manage jobs, schedules, resources and variables.

by windmill-labsWidely used★ 18.6KUpdated yesterday

Runs in the cloud

How to connect

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Mailbox

One REST API for all your mailboxes, whichever provider they are at, a Python client for it and an MCP server on top. Scripts, tools and AI agents work with your mail through one door you control.

Status: beta, version 0.6.1. Usable with real accounts. A breaking

change of the API or the configuration is announced in the changelog.

Stored data is carried forward by migrations.

Contents

What it is for
Working with an AI agent in your mail
More uses
What it can do today
Providers
The four packages
Getting started
Documentation
Development
Licence

What it is for

Most people and small companies have more than one mail account: a personal address at GMX or web.de, a company mailbox at Microsoft 365, an info@ address at some hoster, maybe a Gmail account. Each speaks its own dialect: IMAP here, Microsoft Graph there. Every tool that wants to work with mail has to learn all of them and has to be given the passwords.

Mailbox turns that around. It has four packages. mailbox-service runs on your own machine or server and holds the connections to all accounts. Everything else talks to that service only, through one REST API that looks the same for every provider. mailbox-client is the Python client of that API, for scripts and apps. mailbox-mcp, the MCP server, builds on the client and opens the service to AI agents. mailbox-common holds what the service and the MCP server share. The service decides who may do what. A script, an app or an AI agent gets a token of its own. That token opens exactly the accounts and operations it was given, nothing more.

That makes a few things simple that are hard otherwise.

Working with an AI agent in your mail

Through the MCP server, Claude or another AI agent works with every account you gave it. A few requests it handles today:

"What came in since last night?"
"Move every invoice from Company XY to the folder Accounting."
"Forward today's invoices to our tax advisor."
"Show me all mail from Company XY between the 1st and the 15th of September."
"Which mails with attachments came this week? Read the invoice and tell me the amount and the due date."
"Sum up the mails about the offer and write a draft reply."
"Mark last week's newsletters as read and move them to the archive."

Its rights decide whether it may send on its own or only leave drafts for a person to send. A grant can also name the recipients it may write to, such as the tax advisor's address alone, and how many mails it may send a day. A mail to anyone else is refused. It can keep the agent to some folders, such as the invoices, and end after a week.

More uses

Controlled access. A bookkeeping tool reads the invoice folder of one account and nothing else. It may neither send nor delete, and it never sees a mail password, only its own token.
Automation across accounts. A script files invoices, archives newsletters and forwards order confirmations. It works the same way for GMX, Microsoft 365 and your own mail server.
Sending with guard rails. A newsletter job sends from info@, to a fixed list of recipients, at most a few times a day.
React instead of polling. Signed webhooks tell your own system about new mail, a ticket tool or an internal dashboard for example.
Traceable. Every send is recorded in the audit: by whom, when and under which grant. So is every sign-in and every change to users, tokens, roles, accounts and webhooks.
One inbox for your own tools. A dashboard or a small internal app lists, searches and answers mail from every account with one client.
Self-hosted. The service stores the credentials encrypted. Mail goes straight from the provider to you, never through a third party's cloud.

What it can do today

Accounts: IMAP with SMTP for sending, set up from the address alone (autodiscovery), JMAP servers such as Fastmail and Stalwart, POP3 for mailboxes without IMAP (the inbox only), Microsoft accounts (Outlook.com, Microsoft 365) over Microsoft Graph with OAuth sign-in, and Gmail over the Gmail API. Credentials are encrypted (AES-256-GCM) under a master key kept outside the database.
Reading: folders, lists and search, one account or all at once, conversations across folders, messages as text and HTML, attachments, the raw source. Message ids stay the same when a message moves, kept by a background sync. A link to an attachment lets another service fetch the file once, without a token.
Writing: read state, stars and keywords, moving, deleting, folders, drafts, and sending with reply, reply to all and forward. A retried send is not sent twice (Idempotency-Key).
Changes: a change feed names each message created, changed or deleted since a point you keep, in IMAP, JMAP, POP3, Microsoft and Gmail accounts, flags set in other mail clients included where the IMAP server offers CONDSTORE. Webhooks post the same events, signed, to a URL of your choice, a host in your local network included.
Users and rights: users, roles and grants per account and per operation, down to folders, grants that expire, API tokens, limits on sending (allowed recipients, sends per day), an audit of every send and an audit of administration.
MCP server: reads, sorts, writes drafts, sends and tells what is new, over stdio or streamable HTTP, offering only the mail tools its token may use, server_status always, and following its rights while it runs. Mail content reaches the model marked as foreign text.
Configuration UI in the browser under /ui: accounts, users, rights, tokens, reading and writing mail, the send audit, webhooks, the status of accounts and sync, the audit of administration, the service log.
Operation: encrypted backup and restore, container images, compose files for operation with HTTPS through Caddy and MCP server instances.

What comes next, and in which order, is in docs/ROADMAP.md.

Providers

Provider	Connected via	Credential	State
GMX, web.de, T-Online, Yahoo, AOL, iCloud, Posteo, mailbox.org, IONOS, Strato, own mail servers	IMAP + SMTP	app password	available
Microsoft 365, Outlook.com	Microsoft Graph	OAuth, through the project's app or your own (setup)	available
Proton Mail	IMAP + SMTP through Proton Mail Bridge	Bridge password	IMAP, not tested
Gmail / Google Workspace	Gmail API, or IMAP + SMTP	OAuth, with your own Google Cloud client (setup), or an app password	available
Fastmail, Stalwart, other JMAP servers	JMAP	API token or password	available
legacy mailboxes without IMAP	POP3 + SMTP: the inbox only, no folders, no read state, no search	password	available

Not supportable: Tuta, which offers no IMAP and no API. Details per provider in docs/CONCEPT.md, section 5.3.

The four packages

Package	What it is	Runs	Read more
`mailbox-service`	the service: REST API, configuration UI, users and rights, accounts, encrypted credentials, provider adapters, background sync	permanently	packages/mailbox-service
`mailbox-client`	the Python client of the REST API, async and sync	inside your own code	packages/mailbox-client
`mailbox-mcp`	the MCP server, on top of `mailbox-client`	per client over stdio, or as a server over HTTP	packages/mailbox-mcp
`mailbox-common`	what the service and the MCP server share	installed with them	packages/mailbox-common

A release publishes all four to PyPI under the same version, as benethos-mailbox-service, benethos-mailbox-client, benethos-mailbox-mcp and benethos-mailbox-common, and the service and the MCP server as container images on ghcr.io. The MCP server is listed in the official MCP Registry as io.github.benethos-hub/benethos-mailbox-mcp, and every release carries it as a Claude Desktop extension, benethos-mailbox-mcp.mcpb. Each package has its own README. It explains how to install, start and configure it, for the service and the MCP server with the container image and the compose file.

The MCP server and the service must have the same version to work

together. Update both at once. The MCP server's tool server_status

shows the service's version and whether it matches its own.

Getting started

Start the service and create the first user: packages/mailbox-service.
Open http://127.0.0.1:8080/ui, sign in as admin with the one-time password, choose a password of your own and connect your accounts.
Give y

Only the beginning is shown; read the rest in the repo

Benethos Mailbox MCP

What it does

Install

Download the maker’s installer

Double-click the file, then click Install in the Claude desktop app

Try it

What you can do instead

Install Python (uv)

Sign up and create a Benethos Mailbox MCP key

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Install Python (uv)

Sign up and create a Benethos Mailbox MCP key

Click this button to open Cursor

Fill in your key

Open the AI chat in Cursor in Agent mode

Try it

Install Python (uv)

Sign up and create a Benethos Mailbox MCP key

Click this button to open VS Code

Fill in your key

Open the AI chat in VS Code in Agent mode

Try it

Installed on your computer

Values you fill in

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Otheri

Common questions

Others in the same category

World Monitor

Claude Flow

Windmill

README from the maker

Mailbox

What it is for

Working with an AI agent in your mail

More uses

What it can do today

Providers

The four packages

Getting started