Skip to content
MCP server

Proton Safe MCP

Read Proton Mail and prepare confirmed drafts, with no send, delete or move tools

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Linux, CLI, self-hosted
Runs
Locally
Version
2.3.2
Listing updated
2 days ago

About Proton Safe MCP

Proton Safe MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

The design starts from one worry: a message can carry hostile instructions, and an agent that reads mail and can also send it is one injection away from trouble. So this server has no SMTP client, no send tool, and no delete, move or raw attachment download. A test asserts that no send_message tool exists.

It connects to Proton through the official Proton Mail Bridge on 127.0.0.1 over stdio. It can search and read messages, extract bounded text from received PDF, TXT and CSV attachments, and create drafts only after the exact recipients, subject, body and attachments are confirmed in the conversation. Outgoing attachments (PDF, DOCX, XLSX, PPTX, TXT, CSV, PNG, JPEG) arrive as checksummed base64 chunks, and the Bridge password is kept in the OS keyring.

There is also a guided desktop installer for Ubuntu 24.04, version 2.3.2; a Windows build is not available yet. It needs Proton Mail Bridge and a compatible paid Proton plan. The author notes that mail a cloud model reads is sent to that provider.

Install

Run in a terminal

claude mcp add proton-safe-mcp --env PROTON_BRIDGE_USER='<PROTON_BRIDGE_USER>' -- uvx proton-safe-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "proton-safe-mcp": {
      "command": "uvx",
      "args": [
        "proton-safe-mcp"
      ],
      "env": {
        "PROTON_BRIDGE_USER": "<PROTON_BRIDGE_USER>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "proton-safe-mcp": {
      "command": "uvx",
      "args": [
        "proton-safe-mcp"
      ],
      "env": {
        "PROTON_BRIDGE_USER": "<PROTON_BRIDGE_USER>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "proton-safe-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "proton-safe-mcp"
      ],
      "env": {
        "PROTON_BRIDGE_USER": "<PROTON_BRIDGE_USER>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "proton-safe-mcp": {
      "command": "uvx",
      "args": [
        "proton-safe-mcp"
      ],
      "env": {
        "PROTON_BRIDGE_USER": "<PROTON_BRIDGE_USER>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "proton-safe-mcp": {
      "command": "uvx",
      "args": [
        "proton-safe-mcp"
      ],
      "env": {
        "PROTON_BRIDGE_USER": "<PROTON_BRIDGE_USER>"
      }
    }
  }
}

Configuration

  • PROTON_BRIDGE_USERProton address configured in Proton Mail BridgeRequired
  • PROTON_IMAP_PORTLocal IMAP port shown by Proton Mail Bridge

What it does

No send capability
Drafts are reviewed and sent by you in Proton Mail.
Search and read mail
Reads use BODY.PEEK so messages are not marked read.
Bounded attachment text
Extracts text from PDF, TXT and CSV without exposing raw bytes.
Confirmed drafts
Draft creation needs explicit confirmation of the exact content.
Verified uploads
Chunked attachments with declared size and SHA-256 checks.
Guided installer
A desktop app sets up Bridge and the assistant connection on Ubuntu.

Good for

  • Find an email thread and summarise it
  • Prepare a reply draft for review
  • Pull key text out of a received PDF
  • Attach a document to a draft safely

Pricing

Open source

Free and open source; requires a paid Proton plan for Bridge

Prices change. Check fbossiere.github.io before you buy.

Proton Safe MCP FAQ

Can it send email?

No. There is no send tool; you press Send in Proton Mail.

What do I need?

Proton Mail Bridge and a compatible paid Proton plan.

Is mail sent to an AI provider?

If you use a cloud model, the content it reads goes to that provider.

Which OS has the installer?

Ubuntu 24.04 64-bit; Windows is not available yet.

Is Proton Safe MCP free?

Yes. Proton Safe MCP is open source, so you can use and self-host it for free.

How do I add Proton Safe MCP to Claude Code?

Run this command in your terminal: claude mcp add proton-safe-mcp --env PROTON_BRIDGE_USER='<PROTON_BRIDGE_USER>' -- uvx proton-safe-mcp

What are the best alternatives to Proton Safe MCP?

The closest alternatives to Proton Safe MCP are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

Alternatives to Proton Safe MCP

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

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

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

    MCP server

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

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media