claude-mail-mcp
Self-hosted IMAP/SMTP/CalDAV-Connector für Claude — für alle, die ihr Postfach nicht bei Google haben.
claude-mail-mcp ist ein Streamable-HTTP-MCP-Server, der Claude über die Standardprotokolle IMAP, SMTP und CalDAV an dein Postfach hängt. Du installierst ihn an deinem eigenen Server, hinterlegst deine Mailbox-Credentials in einer .env-Datei und ab dann arbeitet Claude direkt mit deiner echten Inbox und deinem echten Kalender — kein Umweg über eine Drittanbieter-API, kein SaaS-Mittelsmann, kein Vendor-Lock-in. Funktioniert mit Mailbox.org, Fastmail, iCloud, Mailcow, iRedMail, Migadu, Nextcloud, dem eigenen Postfix-Server — eben mit allem, was RFC-konformes IMAP/SMTP spricht.
13 Tools für Mail und Kalender
9 Mail-Tools (Folders / Messages / Search / Get / Send / Draft / Mark-Read / Move / Delete) plus 4 Kalender-Tools (Calendars / Events / Create-Event / Find-Free-Slot). Server-seitige IMAP-Suche, nicht „alles laden und filtern". Free-Slot-Suche über mehrere Kalender mit optionalem Working-Hours-Fenster.
Provider-agnostisch
Mailbox.org, Fastmail, iCloud, Gmail, Mailcow, iRedMail, Migadu, Nextcloud — wer IMAP/SMTP und optional CalDAV spricht, funktioniert. Die README listet App-Passwort-Links und Hostnamen für die wichtigsten Provider direkt zum Copy-Paste.
Sichere Defaults
delete_message ist als destruktiv markiert, sodass Claude.ai in der UI nach Bestätigung fragt. Für reversible Workflows: move_message in den Trash-Ordner. create_draft als Review-Schritt statt direktem Send.
MIT-lizenziert
Forken, modifizieren, kommerziell einsetzen — alles erlaubt. IMAP-Client, MCP-Tool-Registry und OAuth-Shim sind sauber getrennt; wer einen ähnlichen Connector für CardDAV, JMAP oder Matrix bauen will, kann den Aufbau hier 1:1 als Vorlage nehmen.
Warum das?
Im Connector-Store von Anthropic gibt es für Email genau eine Option: Gmail. Wer sein Postfach bei Mailbox.org, Fastmail, iCloud oder einem eigenen Server hat, schaut in die Röhre. Das ist absurd, weil IMAP/SMTP seit den 90ern offene Standards sind und CalDAV seit über zehn Jahren der De-facto-Standard für Kalender außerhalb von Google ist.
claude-mail-mcp schließt diese Lücke: dein Postfach bleibt bei dir, der Server läuft an deiner Infrastruktur, und Claude sieht nur das, was du explizit per Tool-Call freigibst.
Architektur
Express 5 als HTTP-Layer, das offizielle @modelcontextprotocol/sdk für die Tool-Registrierung. IMAP über imapflow mit einer Long-Lived-Connection und Per-Mailbox-Locking (damit parallele Tool-Calls nicht auf dem IMAP-SELECT-Zustand kollidieren). SMTP über nodemailer mit optionalem Best-Effort-Copy in den Sent-Ordner. CalDAV über tsdav, iCal-Parsing über ical.js. Streamable-HTTP-Transport, kompatibel mit Claude.ai web und Claude Desktop.
Authentifizierung gegenüber der Mailbox läuft über klassische IMAP/SMTP-Credentials in der .env-Datei — App-spezifische Passwörter bei Providern mit Zwei-Faktor-Auth (Gmail, iCloud, Fastmail). Der MCP-Endpoint selbst ist mit einem Bearer-Token gesichert, davor sitzt der gleiche OAuth-Shim wie bei claude-meta-mcp, sodass Claude.ai den Connector über die normale „Connector hinzufügen"-Oberfläche einbinden kann.
Was du brauchst
Ein Linux-VPS mit Node 20. Ein IMAP/SMTP-Postfach (bei 2FA-Providern: App-spezifisches Passwort, die README listet die Direkt-Links zu den App-Password-Seiten von Mailbox.org, Fastmail, iCloud und Gmail). Optional eine CalDAV-URL für den Kalender — wenn nicht gesetzt, startet der Server mail-only. nginx + TLS-Zertifikat für die Connector-Domain. Setup-Zeit: ungefähr 15 Minuten von git clone bis zum ersten Tool-Call.
Roadmap
v0.2: Multi-Tenant mit SQLite-Token-Store, damit ein Deployment mehrere User bedienen kann. v0.3: Threading-Ansicht (list_threads), Attachment-Download als Base64, iMIP-Einladungen via SMTP wenn create_event Attendees hat. v0.4: CardDAV (Kontakte), JMAP-Support für Fastmail-Power-User. v1.0: Audit-Log, Prometheus-Metriken, Rate-Limiting.
Brauche ich Programmierkenntnisse für die Installation?
Linux-Grundkenntnisse reichen. Der Deployment-Guide im Repo ist als Schritt-für-Schritt-Anleitung geschrieben — git clone, npm install, .env ausfüllen, pm2 start. Das nervigste ist meistens das App-spezifische Passwort beim Mail-Provider, dafür gibt es Direkt-Links in der README.
Funktioniert das mit dem Free-Plan von Claude?
Custom MCP Connectors brauchen einen kostenpflichtigen Claude-Plan (Pro oder höher) — das ist eine Anthropic-Vorgabe, nicht von diesem Repo abhängig.
Brauche ich CalDAV?
Nein. Wenn CALDAV_URL leer ist, registriert der Server die vier Kalender-Tools einfach nicht — Mail funktioniert weiterhin. Das ist die Standard-Konfig für reine Mail-Provider ohne Kalender.
Wie viele Mailboxen kann ein Deployment bedienen?
In v0.1: genau eine. Eine Installation = eine .env-Datei = ein Postfach. Multi-Tenant kommt in v0.2 mit SQLite-Token-Store. Wer heute mehrere Postfächer bedienen will, deployed den Server pro Postfach einmal (jeweils eigener Port, eigene Subdomain).