Proton Mail (Bridge)
Unofficial Proton Mail Bridge server: read and draft mail, approve every change
- Pricing
- Open source
- Platforms
- macOS, Linux, Windows
- Runs
- Locally
- Version
- 1.31.0
- Listing updated
- 3 days ago
About Proton Mail (Bridge)
Proton Mail (Bridge) is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
This server runs on your own computer next to Proton Mail Bridge and listens only on 127.0.0.1. Reading is non-destructive: search and read open mailboxes read-only and never mark mail as seen, and a private local index holds message headers but no bodies. Drafts, replies and forwards are created but stay unsent until you send them.
Changes go through two steps. The assistant first previews what a move, trash, archive, label change or unsubscribe would do and gets a single-use, short-lived token bound to exactly those messages. Your client then shows a form with the exact change for you to accept or decline, and the server rechecks the messages before acting. Sending is off by default and needs a saved draft plus approval. Most reversible changes can be undone with undo_action, which needs no token. Permanent deletion reaches only approved drafts, and there is no tool to empty Trash or delete a mailbox.
A setup command, uvx mcp-proton-mail setup, installs the local service and connects Claude Desktop, Claude Code, ChatGPT on the Mac app, Codex, Gemini CLI, Cursor or Grok. A paid Proton plan is required for Bridge. The project says it is unofficial and not affiliated with Proton AG.
Install
Run in a terminal
claude mcp add proton-mail-mcp -- uvx mcp-proton-mailAdd to claude_desktop_config.json
{
"mcpServers": {
"proton-mail-mcp": {
"command": "uvx",
"args": [
"mcp-proton-mail"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"proton-mail-mcp": {
"command": "uvx",
"args": [
"mcp-proton-mail"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"proton-mail-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-proton-mail"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"proton-mail-mcp": {
"command": "uvx",
"args": [
"mcp-proton-mail"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"proton-mail-mcp": {
"command": "uvx",
"args": [
"mcp-proton-mail"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- undo_action
- Reverse a logged change once, without a token or form.
What it does
- Read-only search
- Search, count and read threads and attachments without marking mail as read.
- Draft writing
- Create drafts, replies and forwards that stay unsent.
- Approval tokens
- Moves, deletes and sends need a single-use token tied to the exact messages.
- Undo
- undo_action reverses a logged change once, with no token needed.
- Audit log
- Every write call goes into an append-only log that holds no message bodies.
- Local only
- Runs on 127.0.0.1 under the same login as Proton Mail Bridge.
Good for
- Find a thread from last spring and summarise it
- Draft a reply for review without sending it
- Archive or label a batch of newsletters after previewing the list
- Undo a mailbox cleanup that moved the wrong messages
Pricing
Open source
Free open-source server; requires a paid Proton plan for Bridge
Prices change. Check manajev.com before you buy.
Proton Mail (Bridge) FAQ
Is it official?
No. The project says it is unofficial and not affiliated with or endorsed by Proton AG.
What do I need first?
A paid Proton plan for Bridge, plus uv. It runs on Linux and macOS, with Windows support described as new.
Can the assistant send mail on its own?
No. Sending is off by default, and when enabled it still needs a saved draft and your approval.
Can it empty my Trash?
No. There is no tool to empty Trash or to delete or rename a mailbox.
Is Proton Mail (Bridge) free?
Yes. Proton Mail (Bridge) is open source, so you can use and self-host it for free.
How do I add Proton Mail (Bridge) to Claude Code?
Run this command in your terminal: claude mcp add proton-mail-mcp -- uvx mcp-proton-mail
What are the best alternatives to Proton Mail (Bridge)?
The closest alternatives to Proton Mail (Bridge) are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Proton Mail (Bridge)

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