protonmail-mcp
protonmail-mcp
Geben Sie Ihrem KI-Codierungsagenten Zugriff auf Ihre ProtonMail – suchen, lesen, entwerfen und senden – von Claude Code, Claude Desktop, Cursor oder einem beliebigen MCP-Client.
„Schau in mein Proton und sag mir, was ich heute erledigen muss.“ „Finde Sarahs letzte E-Mail und entwirf eine Antwort, dass Donnerstag um 14 Uhr passt – noch nicht senden.“
Da Proton Ende-zu-Ende-verschlüsselt ist, gibt es keine öffentliche Mail-API – dieses Tool spricht daher mit Proton
Bridge, dem offiziellen lokalen Gateway, das Proton genau dafür bereitstellt. Alles bleibt auf 127.0.0.1;
Ihre entschlüsselte Post verlässt nie Ihren Rechner, und nichts davon ist ein gehosteter Dienst.
Bevor Sie beginnen – die eine Voraussetzung
Sie benötigen Proton Bridge auf demselben Rechner.
Bridge erfordert einen kostenpflichtigen Proton-Tarif (Mail Plus / Proton Unlimited). Kostenlose Proton-Konten können Bridge nicht nutzen und daher auch nicht dieses Tool. Das ist eine Proton-Einschränkung, nicht unsere.
Bridge läuft auf macOS, Windows und Linux (headless über
protonmail-bridge --cliauf Servern).Bridge gibt jedem Konto seinen eigenen generierten IMAP/SMTP-Benutzernamen und ein eigenes Passwort – verwenden Sie diese hier, nicht Ihren normalen Proton-Login.
Related MCP server: ProtonMail MCP Server
Installation
# Claude Code — one line, no global install:
claude mcp add protonmail --scope user -- npx -y protonmail-mcpTeilen Sie ihm dann mit, wie Bridge zu erreichen ist – entweder über Umgebungsvariablen oder eine Konfigurationsdatei.
Konfigurationsdatei (~/.config/protonmail-mcp/config.json):
{
"user": "you@proton.me",
"pass": "your-bridge-generated-password",
"imapPort": 1143,
"smtpPort": 1025
}Oder Umgebungsvariablen: PROTONMAIL_USER, PROTONMAIL_PASS, PROTONMAIL_IMAP_PORT,
PROTONMAIL_SMTP_PORT. (Kopieren Sie config.example.json, um alle Optionen zu sehen.)
Prüfen Sie, dass es funktioniert, bevor Sie es in einen Agenten einbinden:
npx protonmail-mcp doctorDas verbindet sich mit Bridge, authentifiziert sich und listet Ihre Postfächer auf – so zeigt sich jedes Einrichtungsproblem hier mit einer klaren Meldung, anstatt mitten im Gespräch kryptisch zu scheitern.
Andere MCP-Clients
Jeder MCP-Client funktioniert – weisen Sie ihn über stdio auf den Befehl protonmail-mcp hin. Für einen JSON-Konfig-Client
(Claude Desktop, Cursor, …):
{
"mcpServers": {
"protonmail": {
"command": "npx",
"args": ["-y", "protonmail-mcp"],
"env": { "PROTONMAIL_USER": "you@proton.me", "PROTONMAIL_PASS": "…" }
}
}
}Werkzeuge
Lesen (sicher – lassen Sie den Agenten diese ohne Einschränkung ausführen):
Werkzeug | Was es tut |
| Ordner/Labels auflisten |
| Neueste Nachrichten in einem Postfach (Zusammenfassungen) |
| Ungelesene Nachrichten (Zusammenfassungen) |
| Suche nach Text / von / an / Betreff / Datumsbereich |
| Vollständige Nachricht per uid (zitierter Verlauf standardmäßig gekürzt) |
Schreiben (Ihr MCP-Client sollte vor der Ausführung nachfragen):
Werkzeug | Was es tut |
| Einen Entwurf speichern (sendet nie) |
| Antwort im Thread – speichert standardmäßig einen Entwurf, |
| Sendet eine neue E-Mail sofort |
| Lese-Flag umschalten |
| Zwischen Ordnern verschieben |
| In den Papierkorb verschieben (wiederherstellbar, bis geleert) |
Setzen Sie "readOnly": true (oder PROTONMAIL_READONLY=1), um nur die Lese-Werkzeuge zu registrieren – eine harte
Garantie, dass der Agent niemals senden, verschieben oder löschen kann, unabhängig von den Genehmigungseinstellungen des Clients.
Sicherheitsmodell
Die relevanten Schreib-Werkzeuge – send_message, trash_message und reply_to_message mit
send=true – sind so benannt und beschrieben, dass die werkzeugbezogene Genehmigung Ihres MCP-Clients die natürliche Hürde darstellt;
Lesevorgänge fragen nie nach. Bevorzugen Sie Entwerfen gegenüber Senden: Der Agent schreibt, Sie prüfen in Proton, Sie
drücken auf Senden. Für einen unbeaufsichtigten/Headless-Betrieb verwenden Sie readOnly, und es gibt schlicht nichts Gefährliches zu
genehmigen.
Auf Ihrem Telefon
Dies ist ein lokaler Server, daher ist er erreichbar, wo auch immer Ihr Agent ist. Koppeln Sie den Rechner mit BrainBoxx und Sie können das Ganze aus Ihrer Hosentasche erledigen – „schau in mein Proton und sag mir, was erledigt werden muss“ im Zug, Antworten bereits entworfen, wenn Sie nach Hause kommen.
So funktioniert es
MCP client (Claude Code / Cursor / …)
│ MCP over stdio
▼
protonmail-mcp ──IMAP──► 127.0.0.1:1143 ┐
│ ──SMTP──► 127.0.0.1:1025 ├─ Proton Bridge ──► Proton Mail
└── clean JSON in, tool calls out ┘ (local, TLS, your machine only)Bridge präsentiert ein selbstsigniertes Zertifikat auf localhost (erwartet); dieses vertraut ihm standardmäßig für
127.0.0.1. Setzen Sie "allowSelfSigned": false, um die vollständige Überprüfung zu erzwingen, wenn Sie Bridge ein
vertrauenswürdiges Zertifikat gegeben haben.
Lizenz
MIT © 2026 Simon Stark. Nicht verbunden mit oder unterstützt von Proton AG.
Available Tools
8 toolscreate_draftA
Compose a new email and save it to Drafts. Does NOT send — you review and send it yourself in Proton. Can include local file attachments.
Inputs: to (required), subject (required), cc, bcc, +3 more.
download_attachmentA
Save an attachment from a message to disk (into the configured download directory). Identify it by filename or 0-based index (from get_message); if the message has just one attachment, neither is needed. Returns the saved file path.
Inputs: uid (required), index, mailbox, filename.
forwardA
Forward a message to new recipients, carrying its original attachments. Optional intro note via body. Sends immediately unless draft=true. Can add further local file attachments.
Inputs: to (required), uid (required), body, html, +3 more.
get_messageA
Read one full message by uid (from a search result). Quoted reply history and signatures are trimmed by default for readability; pass full=true to keep everything. The result lists any attachments (name/type/size) — use download_attachment to save one.
Inputs: uid (required), full, mailbox.
replyA
Reply to a message (to its sender), correctly threaded, quoting the original. Sends immediately unless draft=true (saves to Drafts for you to review). Can include local file attachments.
Inputs: uid (required), body, html, draft, +2 more.
reply_allA
Reply to a message and everyone on it (sender + all other recipients, excluding you), threaded and quoting the original. Sends immediately unless draft=true. Can include local file attachments.
Inputs: uid (required), body, html, draft, +2 more.
search_mailA
Search email by any combination of free-text, sender, recipient, subject, and date range. With NO filters it returns your most recent inbox messages. Returns summaries (no body) newest first — use get_message with a result's uid to read the full text.
Inputs: to, from, limit, query, +5 more.
send_messageA
Send a new email immediately. This goes out the moment it runs — the client should confirm first. To let a human review before sending, use create_draft instead. Can include local file attachments.
Inputs: to (required), subject (required), cc, bcc, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools are clearly distinct: search/get/download form a retrieval pipeline, and create_draft/send_message are explicitly contrasted. reply, reply_all, and forward could be confused, but their descriptions precisely define recipient behavior and threading.
Most tools follow a clear verb_noun pattern like search_mail, get_message, download_attachment, create_draft, send_message. However, reply and forward are bare verbs, and reply_all mixes a verb with an adverb, creating minor inconsistency.
Eight tools is a well-scoped set for an email-focused server. Each tool covers a distinct core email action without unnecessary redundancy or bloat.
The set covers search, read, download attachments, reply, reply-all, forward, draft, and send — the essential email workflows. Minor gaps like delete, move, or archive exist, but agents can handle common tasks end-to-end.
Maintenance
Related MCP Connectors
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email safety MCP server. Detects phishing, prompt injection, CEO fraud for AI agents.
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Related MCP Servers
- AlicenseAqualityDmaintenanceA read-only MCP server that connects to Proton Mail via Proton Bridge, enabling AI assistants to search, list, and read emails securely without leaving your machine.41MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that connects to ProtonMail via Bridge, enabling AI assistants like Claude to manage your email.3MIT
- FlicenseNot gradedqualityBmaintenanceA lightweight MCP server providing AI agents a scoped, read-and-draft-only view into Proton Mail via Proton Bridge, with code-enforced restrictions preventing external access or sending.-
- FlicenseNot gradedqualityDmaintenanceA security-first MCP server that provides AI agents with a scoped, read-and-draft-only view into Proton Mail via Proton Bridge, ensuring no emails can be sent and access is restricted to configured workspaces.5-