googlarz/proton-mail-bridge-client

🌉 Local-first Proton Mail MCP and CLI through Proton Bridge. Search, read, draft, send, sync, and act on mail from Claude Desktop or Terminal.

33 ★7 forksJavaScriptUpdated 20d ago

What you need to know

CLI plus Claude Desktop MCP server giving full access to Proton Mail via Proton Bridge, with 40+ capabilities including read, search, send, triage, folders, and attachments.

Install

npm install -g proton-mail-bridge-client (or brew tap googlarz/tap)
Requires Proton Bridge installed, signed in, and running
Run proton-mail-bridge-client setup-claude-desktop wizard

Usage

•Add proton-mail-bridge MCP server with PROTONMAIL_USERNAME/PASSWORD (Bridge password) and IMAP/SMTP settings
•Ask Claude to triage inbox, search, draft, reply, archive, manage folders, save attachments
•Or use the full CLI: proton-mail-bridge-client <command> with --json output

Key features

✓76 MCP tools plus full CLI parity
✓Fast local full-text search with SQLite index
✓Safety controls: read-only mode, send gate, destructive-action confirmation, per-action allowlist
✓Privacy-native: mail stays on your machine via local Proton Bridge
✓Ambient new-mail notifications via IMAP IDLE
✓Node 18+, MIT license

Best for

Managing a Proton Mail inbox from Claude Desktop, Cline, or scripts.

Clients: Claude Desktop · Cline

Reviewed 2026-08-11

Topics

claudeclaude-codeemailmcpmodel-context-protocolprivacyproton-bridgeprotonmail

Stars: 33★
Forks: 7
Language: JavaScript
License: MIT
Created: 2026-03-24
Last push: 2026-08-15