# Proton Bridge MCP

> Proton Bridge MCP is an open-source MCP server for communication. Let an AI assistant search, file and draft Proton Mail locally through Proton Bridge. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted
- **Website:** https://considus.com/proton-bridge-mcp/
- **Repository:** https://github.com/considus/proton-bridge-mcp
- **MCP Registry name:** com.considus/proton-bridge-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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)

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/proton-bridge-mcp
