# Proton Mail (Bridge)

> Proton Mail (Bridge) is an open-source MCP server for communication. Unofficial Proton Mail Bridge server: read and draft mail, approve every change. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, Windows, CLI
- **Website:** https://manajev.com/proton-mail-mcp/
- **Repository:** https://github.com/legalaspro/proton-mail-mcp
- **MCP Registry name:** io.github.legalaspro/proton-mail-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add proton-mail-mcp -- uvx mcp-proton-mail
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proton-mail"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proton-mail"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "proton-mail-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proton-mail"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proton-mail"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proton-mail-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proton-mail"
      ]
    }
  }
}
```

## Tools

- `undo_action`: Reverse a logged change once, without a token or form.

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

- [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-mail-bridge
