Skip to content
MCP server

Proton Bridge MCP

Let an AI assistant search, file and draft Proton Mail locally through Proton Bridge

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity