Skip to content
MCP server

Proton Mail (Bridge)

Unofficial Proton Mail Bridge server: read and draft mail, approve every change

Runs locallyStatus and history
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-mail

Add to claude_desktop_config.json

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proton-mail"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proton-mail"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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)

  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