Proton Bridge MCP
Let an AI assistant search, file and draft Proton Mail locally through Proton Bridge
- Pricing
- Open source
- Platforms
- self-hosted
- Runs
- Locally
- Version
- 2.1.0
- Listing updated
- 3 days ago
About Proton Bridge MCP
Proton Bridge MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
Proton has no API for assistants, so this server sits on top of Proton Mail Bridge, which decrypts mail on your own machine and exposes IMAP and SMTP on the loopback address. Mail never has to leave the computer. It can also point at an ordinary mailbox, though the local-only guarantee then no longer holds.
There are about two dozen tools in three modes, readonly, organise and full, and the modes remove tools rather than guard them. Anything that puts mail on the wire stops and asks for confirmation, and drafts need none. Recipient addresses are tracked by where they were seen, so an address that appeared only inside a message body cannot be written to, which blocks instructions hidden in a PDF from mailing your invoices elsewhere. Every change is appended to an audit log, refusals included.
It reads attachments, including text from PDFs. It does not permanently delete anything, since Trash is as far as it goes, and folders can be created and renamed but not removed. Bridge is a paid Proton feature, and the project says it is unofficial and not affiliated with Proton AG.
Install
Run in a terminal
claude mcp add proton-bridge-mcp -- npx -y https://github.com/Considus/proton-bridge-mcp/releases/download/v2.1.0/proton-bridge-mcp-2.1.0.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"proton-bridge-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Considus/proton-bridge-mcp/releases/download/v2.1.0/proton-bridge-mcp-2.1.0.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"proton-bridge-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Considus/proton-bridge-mcp/releases/download/v2.1.0/proton-bridge-mcp-2.1.0.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"proton-bridge-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/Considus/proton-bridge-mcp/releases/download/v2.1.0/proton-bridge-mcp-2.1.0.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"proton-bridge-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Considus/proton-bridge-mcp/releases/download/v2.1.0/proton-bridge-mcp-2.1.0.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"proton-bridge-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/Considus/proton-bridge-mcp/releases/download/v2.1.0/proton-bridge-mcp-2.1.0.mcpb"
]
}
}
}Tools this server provides (25)
Taken from the project documentation; the running server may differ.
- list_folders
- List folders and labels with counts
- poll_folder
- See what arrived since the last check
- search_mail
- Search mail by text, sender, subject, dates and flags
- get_headers
- Headers with SPF, DKIM and DMARC verdicts
- read_message
- Read a full message
- list_attachments
- List real attachments
- read_attachment
- Extract attachment text, PDFs included
- save_attachment
- Write an attachment to disk temporarily
- purge_attachments
- Delete saved attachments now
- find_thread
- Fetch a whole conversation
- reply
- Reply with correct threading (gated)
- create_draft
- Write a draft without sending
- update_draft
- Replace a draft
- delete_draft
- Move a draft to Trash (gated)
- send_draft
- Send a saved draft (gated)
- unsubscribe
- Report how to unsubscribe
- mark
- Mark read, unread, starred
- apply_label
- Apply labels
- remove_label
- Remove labels (gated)
- move_to_folder
- Move messages to a folder
- create_folder_or_label
- Create a folder or label (gated)
- rename_folder_or_label
- Rename a folder or label (gated)
- delete_label
- Delete labels (gated)
- send
- Send a message (gated)
- forward
- Forward a message (gated)
What it does
- Local-only access
- Works through Proton Mail Bridge on 127.0.0.1 so mail stays on your machine.
- Three permission modes
- Readonly, organise and full modes remove tools instead of guarding them.
- Gated sending
- Send, forward and bulk moves ask for confirmation first; drafts go straight to Drafts.
- Attachment reading
- Extracts text from attachments including PDF invoices.
- Prompt-injection guard
- Addresses seen only in message bodies cannot be used as recipients.
- Audit log
- Every change and refusal is appended to a log.
Good for
- Triage overnight mail and find what needs a reply
- Total invoices from a sender over a quarter
- Bulk file newsletters into a folder after a preview
- Draft a threaded reply without sending it
- Find an old message with an attachment
Pricing
Open source
Free, Apache 2.0; Proton Mail Bridge requires a paid Proton plan
Prices change. Check considus.com before you buy.
Proton Bridge MCP FAQ
Do I need a paid Proton plan?
Yes for Bridge, which is a paid Proton feature; otherwise you can point it at an ordinary mailbox.
Can it delete mail permanently?
No. Trash is as far as it goes, and folders cannot be deleted.
What licence is it?
Apache 2.0, free and open source.
Is it from Proton?
No. It is unofficial and not affiliated with or endorsed by Proton AG.
Is Proton Bridge MCP free?
Yes. Proton Bridge MCP is open source, so you can use and self-host it for free.
How do I add Proton Bridge MCP to Claude Code?
Run this command in your terminal: claude mcp add proton-bridge-mcp -- npx -y https://github.com/Considus/proton-bridge-mcp/releases/download/v2.1.0/proton-bridge-mcp-2.1.0.mcpb
What are the best alternatives to Proton Bridge MCP?
The closest alternatives to Proton Bridge MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Proton Bridge 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