Proton Mail Bridge MCP und CLI

Proton Mail für Claude Desktop, richtig umgesetzt.

🌉 Proton Mail Bridge MCP ist eine Local-First Proton Mail-Integration für Claude Desktop und Terminal. Sie ermöglicht es Ihnen, Proton Mail über Proton Bridge zu lesen, zu durchsuchen, Entwürfe zu erstellen, zu senden, zu synchronisieren und zu verwalten – mit einem vollständigen MCP-Server und einer echten CLI.

Nach der Einrichtung verwendet Claude Desktop eine stabile lokale Installation dieses MCP auf Ihrem Computer. Es ist nicht auf ein Repo, einen Workspace oder einen Chat-Ordner beschränkt.

Einfach ausgedrückt:

Installieren Sie Proton Mail Bridge MCP auf Ihrem Computer
Verbinden Sie es mit Claude Desktop

Sie müssen die MCP-Interna nicht verstehen, um es zu nutzen. Wenn Proton Bridge bereits auf Ihrem Rechner läuft, ist die Einrichtung unkompliziert.

60-Sekunden-Einrichtung

Wenn Proton Bridge bereits auf Ihrem Rechner läuft:

git clone https://github.com/googlarz/proton-mail-bridge-mcp.git
cd proton-mail-bridge-mcp
npm install
npm run setup:claude-desktop

Dann:

Lassen Sie Proton Bridge geöffnet
Starten Sie Claude Desktop neu
Öffnen Sie einen beliebigen Chat und wählen Sie + -> Connectors -> proton-mail-bridge

Wenn Sie zusätzlich einen schnellen Gesundheitscheck über das Terminal wünschen:

npm run check:claude-desktop
proton-mail-bridge doctor --json

Verwenden Sie die in dieser README gezeigten npm run ...-Befehle.

Das ist wichtig, da die Einrichtungs- und Installer-Einstiegspunkte in der erstellten dist/-Ausgabe liegen und die npm-Skripte bereits korrekt auf die richtigen Dateien verweisen.

Warum Leute es nutzen

Verfolgen Sie Proton Mail direkt aus Claude Desktop, ohne das Tool wechseln zu müssen.
Durchsuchen Sie Rechnungen, Reise-E-Mails, Dokumente und Threads schneller.
Entwürfe erstellen, antworten, weiterleiten und über Proton Bridge senden.
Nutzen Sie dasselbe Backend von Claude Desktop oder direkt aus dem Terminal.
Diagnostizieren Sie Probleme bei der Einrichtung von Claude Desktop und Proton Bridge schnell.

Warum existiert dieses Projekt?

Claude hat einen nativen Gmail-Connector, aber derzeit keinen nativen Proton Mail-Connector. Dieses Projekt schließt diese Lücke für Proton-Nutzer.

Die ursprüngliche protonmail-pro-mcp-Idee war vielversprechend, aber die Codebasis, von der ich ausging, war so nicht nutzbar. Ich habe sie zu einem funktionierenden MCP-Server umgebaut, die fehlenden Teile implementiert und eine lange Liste von Verbesserungen hinzugefügt, damit es im Alltag tatsächlich nützlich ist.

Was es gut kann:

Echte Proton-Unterstützung durch Proton Bridge.
Lese- und Schreibvorgänge: Entwürfe, Senden, Antworten, Weiterleiten, Archivieren, Papierkorb, Wiederherstellen.
Zugriff auf Anhangsinhalte und Speichern von Dateien.
Lokale Indizierung, Thread-Triage, Follow-up-Ansichten und Hintergrundaktualisierung.
Local-First Claude Desktop-Einrichtung, die nach der Installation systemweit verfügbar ist.
Eine echte CLI für Synchronisierung, Suche, Lesen, Diagnose, Wartung von Claude Desktop und vollständige Ausführung von MCP-Tools über das Terminal.

Was Sie erwartet:

Es läuft lokal auf Ihrem Rechner neben Proton Bridge.
Es lässt sich in Claude Desktop integrieren, ist aber kein offizieller Claude-Connector.
Quell-Links stammen aus der MCP-Ebene, nicht von nativen Proton-Webmail-Links.
Nach der Installation kann Claude Desktop es in all Ihren Chats auf diesem Computer verwenden.

Vertrauen und Sicherheit

Läuft lokal auf Ihrem Rechner.
Kommuniziert mit Proton Mail über Proton Bridge auf Ihrem Rechner.
Erfordert kein gehostetes Mail-Relay oder einen Remote-URL-Dienst.
Kann im schreibgeschützten Modus ausgeführt werden, wenn Sie sicherere Standardeinstellungen bevorzugen.
Unterstützt *_FILE und *_COMMAND für Geheimnisse, wenn Sie keine Rohdaten in der Konfiguration speichern möchten.
Führt Sende- oder Postfachänderungen nur aus, wenn Sie diese Funktionen explizit nutzen.

Verifizierte Funktionen

Diese Pfade wurden live mit einer echten Proton Bridge-Einrichtung getestet:

IMAP-Verbindung und Ordnerauflistung
SMTP-Verbindung und Senden
Vollständiges Lesen von Nachrichten
Lokale Indizierung und inkrementelle Synchronisierung
Thread-Ansichten, Zusammenfassungen und Follow-up-Workflows
Remote-Entwurfs-Synchronisierung mit Proton Drafts
Auflistung und Speichern von Anhängen
CLI-Befehle sowie generische MCP-Tool-Aufrufe

Was es tut

Verbindet Claude mit Proton Mail über Proton Bridge IMAP und SMTP.
Liest Ordner, Nachrichten und Anhänge.
Durchsucht Live-Mails und lokal indizierte Mails.
Erstellt, aktualisiert, synchronisiert und sendet Entwürfe.
Sendet E-Mails, antwortet und leitet weiter.
Markiert als gelesen/ungelesen, setzt Sterne, verschiebt, archiviert, löscht, stellt wieder her.
Erstellt einen lokalen SQLite-Index mit Prüfpunkten für die inkrementelle Synchronisierung.
Überwacht Postfachänderungen mit IMAP IDLE-fähiger Aktualisierung.
Rekonstruiert normalisierte Labels und Threads aus IMAP-Daten.
Klassifiziert mehr Anhangstypen, einschließlich eingebetteter Bilder, Kalendereinladungen, Archive und Signaturdateien.
Generiert umsetzbare Thread-Ansichten, Posteingangs-Zusammenfassungen, Follow-up-Kandidaten, Meeting-Vorbereitungen, Dokumenten-Finder-Ansichten und Thread-Briefings.
Unterstützt sicherere Trockenlauf-Vorschauen für Stapel- und Thread-Postfachaktionen.
Gibt MCP-Ressourcen-Links und strukturierte Quell-Metadaten für nachgelagertes Rendering im Zitationsstil aus.

Gut zu wissen

Es verwendet Proton Bridge. Warum: Dieses Projekt verbindet sich über den lokalen IMAP- und SMTP-Zugriff, den Proton Bridge bereitstellt.
Es läuft lokal. Warum: Proton Bridge läuft normalerweise auf Ihrem eigenen Rechner, daher ist dieser MCP-Server ebenfalls für den lokalen Betrieb konzipiert.
Threads und Labels werden aus IMAP-Daten rekonstruiert. Warum: Proton-native Thread- und Label-Objekte sind hier über einen offiziellen Claude-Connector-Pfad nicht verfügbar.
Die Handhabung von Anhängen ist breit gefächert, aber keine Magie. Warum: Die gängigen Fälle funktionieren gut, einschließlich Kalendereinladungen und gängiger Dokument-/Bildanhänge, aber E-Mail-MIME-Formate können bei verschiedenen Absendern und Clients dennoch unübersichtlich sein.

Was noch fehlt und warum

Kein Remote-URL-Connector von Haus aus. Warum: Das aktuelle Produkt kommuniziert mit Proton Bridge auf Ihrem eigenen Rechner, und Proton Bridge ist normalerweise lokal, kein gehosteter Dienst.
Kein offizieller Claude-Authentifizierungsfluss oder native Proton-Deep-Links. Warum: Diese erfordern plattformseitige Unterstützung von Anthropic und eine reichhaltigere Provider-Unterstützung von Proton, als IMAP und SMTP bieten können.
Kein echtes Proton-natives Konversationsmodell. Warum: Dieses Projekt rekonstruiert Threads und Labels aus Bridge-Mail-Daten, anstatt eine reichhaltigere Proton-spezifische API aufzurufen.
Ein nativeres Proton-Erlebnis ist später noch möglich. Warum: Wenn Proton einen besseren öffentlichen Integrationspfad oder eine sauberere Local/Hosted-Bridge-Geschichte veröffentlicht, kann dieses Projekt näher an das native Gmail-Erlebnis heranrücken. Ich warte darauf, dass sich dieses Ökosystem verbessert.

Bevor Sie beginnen

Sie benötigen:

Claude Desktop
Node.js 18 oder neuer
Ein Proton-Konto
Proton Bridge installiert und angemeldet
Etwa 10 Minuten Zeit

Von Proton Bridge benötigen Sie:

IMAP-Host
IMAP-Port
SMTP-Host
SMTP-Port
Benutzername
Bridge-Passwort

Für die meisten lokalen Bridge-Setups sind die Standardwerte:

IMAP-Host: 127.0.0.1
IMAP-Port: 1143
SMTP-Host: 127.0.0.1
SMTP-Port: 1025

🚀 Einrichtungsübersicht

Die Einrichtung besteht aus zwei Teilen:

Installation des lokalen MCP-Servers
Verbindung mit Claude Desktop

Der normale Weg ist der geführte Einrichtungsassistent. Der manuelle Weg ist nur für Benutzer gedacht, die mehr Kontrolle wünschen.

Wichtig:

Der Repo-Ordner wird nur zum Installieren oder Aktualisieren des MCP benötigt
Claude Desktop selbst verwendet nach der Einrichtung eine stabile, systemweite Laufzeitumgebung
Dies ist also für die allgemeine Nutzung von Claude Desktop auf Ihrem Computer gedacht, nicht nur für einen Projektordner

Teil 1: Installieren Sie Proton Mail Bridge MCP auf Ihrem Computer

1. 🔐 Öffnen Sie Proton Bridge

Öffnen Sie Proton Bridge und stellen Sie sicher, dass Ihr Konto verbunden ist.

Öffnen Sie in Bridge die Postfachdetails oder die Ansicht "E-Mail-Client konfigurieren" und kopieren Sie:

IMAP-Host und IMAP-Port
SMTP-Host und SMTP-Port
Benutzername
Bridge-Passwort

Lassen Sie Proton Bridge geöffnet. Schließen Sie es nicht, während Sie dieses MCP verwenden.

2. 📥 Laden Sie das Projekt herunter

git clone https://github.com/googlarz/proton-mail-bridge-mcp.git
cd proton-mail-bridge-mcp
npm install

Wenn Sie möchten, können Sie den Quellcode auch vom neuesten GitHub-Release herunterladen, anstatt das Repo zu klonen.

Wenn npm auf Ihrem Rechner nicht existiert, installieren Sie zuerst Node.js 18+ und führen Sie die Befehle dann erneut aus.

An diesem Punkt befinden sich die MCP-Serverdateien auf Ihrem Computer und sind für den Schritt in Claude Desktop bereit.

Sie können das Repo an einen beliebigen Ort klonen. Dieser Ordner wird für die Installation und Updates verwendet. Claude Desktop bleibt nach Abschluss der Einrichtung nicht an diesen Ordner gebunden.

Teil 2: Weisen Sie Claude Desktop an, es zu verwenden

3. 🪄 Richten Sie Proton Mail Bridge MCP für Claude Desktop ein

npm run setup:claude-desktop

Dieser Befehl installiert nicht die Claude Desktop-App selbst.

Claude Desktop sollte bereits installiert sein.

Was dieser Befehl tut:

Überprüft die Standard-Ports von Proton Bridge
Fragt nach Ihrem Proton Bridge-Benutzernamen und Bridge-Passwort
Verwendet die lokalen Standard-Bridge-Adressen, sofern Sie diese nicht überschreiben
Erstellt diesen MCP-Server
Installiert eine stabile lokale Laufzeitkopie für Claude Desktop außerhalb dieses Repos
Schreibt den Claude Desktop-Konfigurationseintrag, der Claude mitteilt, wie diese installierte Laufzeitumgebung gestartet wird
Speichert die PROTONMAIL_*-Werte, die dieser MCP-Server benötigt, in der lokalen Claude Desktop-Konfiguration
Erstellt ein Backup der alten Claude Desktop-Konfiguration, bevor sie geändert wird

Einfach ausgedrückt:

Dieser Befehl installiert oder aktualisiert die Proton Mail Bridge MCP-Integration für Claude Desktop auf diesem Computer
Er installiert nicht die Claude Desktop-App selbst
Er bindet Claude nicht an den Ordner, aus dem Sie ihn ausgeführt haben

4. 🔁 Starten Sie Claude Desktop neu

Nachdem der Assistent abgeschlossen ist:

Starten Sie Claude Desktop neu
Lassen Sie Proton Bridge geöffnet
Öffnen Sie einen beliebigen Chat in Claude Desktop
Klicken Sie auf die +-Schaltfläche neben dem Chat-Feld und öffnen Sie Connectors
Bestätigen Sie, dass proton-mail-bridge dort erscheint und die Tools verfügbar sind
Wenn Sie einen zweiten Check wünschen, öffnen Sie die Entwicklereinstellungen von Claude Desktop und sehen Sie sich den Status/die Protokolle der MCP-Verbindung an

Wo die stabile Laufzeitumgebung installiert ist:

macOS: ~/Library/Application Support/Proton Mail Bridge MCP
Linux: ~/.local/share/proton-mail-bridge-mcp
Windows: %APPDATA%\Proton Mail Bridge MCP

🤖 Wie das in Claude Desktop funktioniert

Wenn Sie Claude Desktop bereits geöffnet haben, ist dies das Wichtigste, was Sie zuerst wissen sollten:

Claude Desktop unterstützt auch Remote-Connectors, die nach einer URL fragen.
Dieses Projekt ist kein solcher Connector.
Es funktioniert lokal, da Proton Bridge ebenfalls lokal auf Ihrem Rechner funktioniert.
Die richtige Einrichtung hier ist also der lokale Claude Desktop-Installationsfluss, nicht das Remote-URL-Feld.

Warum das dennoch nützlich ist:

Gmail bietet derzeit das nativste Claude-Erlebnis
Proton-Nutzer haben diesen offiziellen Pfad noch nicht
Dieses Projekt bietet Claude Desktop sofort eine praktische lokale Proton-Integration

Warum es keine Remote-URL zum Einfügen gibt:

Ein Remote-URL-Connector erwartet einen gehosteten MCP-Server
Dieses Projekt erwartet, Proton Bridge auf Ihrem Rechner zu erreichen
Proton Bridge stellt normalerweise lokalen IMAP/SMTP-Zugriff auf 127.0.0.1 bereit
Die einfachste und sicherste Einrichtung ist also lokal, nicht remote

Das bedeutet, der unterstützte Claude Desktop-Pfad im aktuellen Release ist:

npm run setup:claude-desktop für den geführten Flow ohne manuelle Konfiguration
npm run install:claude-desktop für fortgeschrittene oder automatisierte Claude Desktop-Installationen
npm run update:claude-desktop zum Aktualisieren der installierten Claude Desktop-Laufzeitumgebung nach dem Aktualisieren dieses Repos
npm run doctor:claude-desktop um zu bestätigen, dass Claude Desktop immer noch auf eine gültige Proton Mail Bridge MCP-Laufzeitumgebung verweist
der .mcpb lokale Erweiterungspfad, dokumentiert in CLAUDE-DESKTOP-PACKAGING.md

🖥️ CLI

Sie können Proton Mail Bridge MCP auch direkt über das Terminal verwenden.

Dies ist nützlich, wenn Sie:

Proton Bridge testen möchten, ohne Claude Desktop zu öffnen
Schnelle Suchen oder Lesevorgänge mit weniger Schritten durchführen möchten
Synchronisierung und Diagnose skripten möchten
Überprüfen möchten, ob der lokale Mail-Stack funktioniert, bevor Sie Claude bitten, ihn zu verwenden
Die vollständige MCP-Tool-Oberfläche direkt vom Terminal aus aufrufen möchten

Die CLI-Binärdatei ist:

proton-mail-bridge

Oder aus dem Repo:

npm run cli -- help

Hauptbefehle:

proton-mail-bridge status
proton-mail-bridge doctor
proton-mail-bridge sync --folder INBOX --limit 150
proton-mail-bridge search "label:inbox invoice"
proton-mail-bridge search --live --from openai.com
proton-mail-bridge read INBOX::25642
proton-mail-bridge tools
proton-mail-bridge tool get_connection_status
proton-mail-bridge tool search_indexed_emails --args '{"query":"invoice","limit":3}'
proton-mail-bridge claude check
proton-mail-bridge claude install

Die meisten Befehle unterstützen auch --json für maschinenlesbare Ausgaben.

Praktische Beispiele:

# Check whether Proton Bridge and Claude-side wiring are healthy
proton-mail-bridge doctor --json

# Search indexed mail
proton-mail-bridge search "label:inbox invoice" --limit 10

# Read one message
proton-mail-bridge read INBOX::25642

# Call any MCP tool directly from Terminal
proton-mail-bridge tools
proton-mail-bridge tool get_connection_status --json
proton-mail-bridge tool search_indexed_emails --args '{"query":"invoice","limit":3}'

# Check Claude Desktop integration
proton-mail-bridge claude check --json

Wenn Sie möchten, dass die CLI alles erreicht, was der MCP-Server bereitstellt, verwenden Sie:

proton-mail-bridge tools
proton-mail-bridge tool <tool-name> --args '{"key":"value"}'
proton-mail-bridge tool <tool-name> --args-file ./input.json

Das gibt Ihnen zwei Möglichkeiten, dasselbe System zu nutzen:

Claude Desktop verwendet es als MCP-Server
Das Terminal verwendet es als CLI, einschließlich generischer MCP-Tool-Auf

Proton Mail Bridge MCP