MailBridge

Thunderbird: Lassen Sie sich von Ihrer KI führen

Kopieren Sie diesen Text in Ihre KI-Anwendung (zum Beispiel einen neuen Chat in Claude Desktop). Die KI führt Sie dann Schritt für Schritt durch die Installation – sie installiert nichts selbst, weil sie vor der Einrichtung noch keinen Zugriff auf Ihren Rechner hat.

Text kopieren

Bitte führe mich Schritt für Schritt durch die Installation von „MailBridge for Thunderbird“ (Schnittstelle zwischen Thunderbird und meiner KI-Anwendung). Halte dich ausschließlich an die Angaben unten, erfinde keine weiteren Schritte, Befehle oder Einstellungen. Führe selbst nichts auf meinem Rechner aus. Gib mir immer nur einen Schritt, warte auf meine Rückmeldung und frag nach, bevor es weitergeht. Frag mich zuerst, ob ich einen Mac oder Windows 11 habe, und zeig mir danach nur die passenden Angaben.

Voraussetzungen: Thunderbird 128 oder neuer; Claude Desktop (oder eine andere KI-Anwendung mit MCP); Node.js ab Version 20.

Schritt 1 – Node.js: Von https://nodejs.org die Version „LTS“ herunterladen und installieren. Das ist auch nötig, wenn Claude Desktop ein eigenes Node.js mitbringt.

Schritt 2 – Dateien: Von https://mcp-schnittstellen.de/mailbridge/ unter „MailBridge for Thunderbird“ die beiden Dateien laden: „Für Ihre KI“ (.mcpb) und „Für Thunderbird“ (.xpi).

Schritt 3 – Claude Desktop: Einstellungen › Erweiterungen › Erweiterte Einstellungen › „Erweiterung installieren“, die Datei .mcpb wählen und mit „Installieren“ bestätigen. Die Erweiterung ist danach sofort aktiviert.

Schritt 4 – Thunderbird: Add-ons und Themes › Zahnrad › „Add-on aus Datei installieren …“ › die Datei .xpi wählen und bestätigen.

Schritt 5 – Einrichtung, einmalig. Mac: Programm „Terminal“ öffnen und diesen Befehl einfügen:
node "$HOME/Library/Application Support/Claude/Claude Extensions/local.mcpb.mcp-interfaces.mailbridge-spm/dist/src/mcp/start.cjs" --setup
Windows: „PowerShell“ öffnen und diese zwei Zeilen nacheinander einfügen:
$b = @(Get-Item "$env:LOCALAPPDATA\Packages\Claude_*\LocalCache\Roaming\Claude\Claude Extensions\local.mcpb.mcp-interfaces.mailbridge-spm", "$env:APPDATA\Claude\Claude Extensions\local.mcpb.mcp-interfaces.mailbridge-spm" -ErrorAction SilentlyContinue)[0].FullName; $b
node "$b\dist\src\mcp\start.cjs" --setup
Zeigt die erste Zeile nichts an, ist Schritt 3 noch nicht erledigt. Kennt die PowerShell „node“ nicht, den vollen Pfad nehmen, zum Beispiel: & "C:\Program Files\nodejs\node.exe" "$b\dist\src\mcp\start.cjs" --setup
Die Einrichtung fragt: ob die KI direkt senden darf (Empfehlung: nein), welche Konten die KI sehen darf (die Kennungen wie „account1“ stehen in Thunderbird unter Add-ons und Themes › MailBridge for Thunderbird › Einstellungen, Abschnitt „Konten“) und schlägt einen Ordner für Anhänge vor. Geschrieben wird erst nach meinem „ja“.

Schritt 6 – Thunderbird und Claude Desktop einmal beenden und neu starten.

Bei Problemen: Meldung „not_configured“ → Schritt 5 wiederholen. Keine Verbindung zu Thunderbird → Thunderbird muss laufen und die Erweiterung aktiv sein, dann Thunderbird neu starten. Meldung „untrusted_peer“ → Thunderbird und die KI-Anwendung neu starten. Alles Weitere: Anleitung unter https://mcp-schnittstellen.de/mailbridge/anleitung.html#thunderbird

Thunderbird: Was ab Werk gilt

• Die KI sieht kein Konto und kein Adressbuch, bis Sie es freigeben.
• Die KI sendet nie selbst. Sie öffnet ein Verfassen-Fenster, und Sie senden. Direktes Senden geht nur, wenn Sie es an zwei Stellen einschalten (Einrichtung und Thunderbird).
• Nichts wird endgültig gelöscht, solange Sie es nicht selbst erlauben. „Löschen“ heißt: in den Papierkorb. Papierkorb und Spam leeren und Kontakte löschen geht nur, wenn Sie es einschalten, und die KI muss jedes Mal ausdrücklich bestätigen.
• Anhängen geht nur aus Ordnern, die Sie freigeben.

Thunderbird: Voraussetzungen

• Thunderbird ab Version 128 (getestet mit 153 unter macOS und 156 unter Windows), macOS oder Windows 11
• Node.js ab Version 20 – für die Einrichtung (Schritt 3) und für das Hilfsprogramm von MailBridge, das Thunderbird startet. Sie brauchen es auch dann, wenn Claude Desktop sein eigenes Node.js mitbringt: Claude Desktop nutzt sein eingebautes Node.js nur für sich selbst (in seinen Einstellungen kann „Node.js: Nicht gefunden (integriert: …)“ stehen – das ist in Ordnung). Download: https://nodejs.org (Version „LTS“).
• Ein KI-Programm mit MCP, zum Beispiel Claude Desktop

Thunderbird: Installation

Laden Sie die Dateien MailBridge-for-Thunderbird-<Version>.mcpb und MailBridge-for-Thunderbird-<Version>.xpi von der Produktseite herunter.

1. In Claude Desktop installieren. Einstellungen › Erweiterungen › Erweiterte Einstellungen › „Erweiterung installieren“, die Datei .mcpb wählen und mit „Installieren“ bestätigen. Die Erweiterung „MailBridge for Thunderbird“ ist danach sofort aktiviert.

2. In Thunderbird installieren. Add-ons und Themes › Zahnrad › „Add-on aus Datei installieren …“ › die Datei .xpi wählen und bestätigen. Die Erweiterung fragt dabei nur nach den Grundrechten (Konten und Nachrichten lesen, Verfassen, Verschieben, Austausch mit dem Hilfsprogramm). Senden und Adressbücher sind nicht dabei – die erlauben Sie später selbst, wenn Sie wollen.

3. Einrichtung ausführen. Einmal im Terminal (Mac) bzw. in der PowerShell (Windows) – der Befehl fragt alles ab, zeigt es an und schreibt erst nach Ihrem „ja“:

Mac:

node "$HOME/Library/Application Support/Claude/Claude Extensions/local.mcpb.mcp-interfaces.mailbridge-spm/dist/src/mcp/start.cjs" --setup

Windows (PowerShell) – zwei Zeilen. Die erste sucht den Ordner der Erweiterung: Aktuelle Fassungen von Claude Desktop für Windows sind ein App-Paket und legen ihn unter %LOCALAPPDATA%\Packages\Claude_…\LocalCache\Roaming\Claude\ ab, andere Installationen unter %APPDATA%\Claude\.

$b = @(Get-Item "$env:LOCALAPPDATA\Packages\Claude_*\LocalCache\Roaming\Claude\Claude Extensions\local.mcpb.mcp-interfaces.mailbridge-spm", "$env:APPDATA\Claude\Claude Extensions\local.mcpb.mcp-interfaces.mailbridge-spm" -ErrorAction SilentlyContinue)[0].FullName; $b
node "$b\dist\src\mcp\start.cjs" --setup

Die erste Zeile zeigt den gefundenen Ordner an. Zeigt sie nichts, ist die Erweiterung noch nicht installiert (Schritt 1).

Kennt die PowerShell node nicht (Node.js steht nicht im PATH), nehmen Sie den vollen Pfad zu node.exe, zum Beispiel & "C:\Program Files\nodejs\node.exe" "$b\dist\src\mcp\start.cjs" --setup.

Die Einrichtung

• fragt zuerst, ob die KI direkt senden darf (Voreinstellung: nein),
• fragt die Konten, die die KI sehen darf. Die Kennungen (z. B. account1) zeigt Thunderbird unter Add-ons und Themes › MailBridge for Thunderbird › Einstellungen, Abschnitt „Konten“. Leer lassen heißt: kein Konto,
• schlägt einen eigenen Ordner für Anhänge in Ihrem Benutzerordner vor: mailbridge-anhaenge (deutsches System) bzw. mailbridge-attachments (englisches System),
• trägt das Hilfsprogramm für Thunderbird ein und schreibt die Einstellungsdatei. Eine vorhandene Einstellungsdatei wird vorher gesichert.

Sie ändert nichts in Ihrem Thunderbird-Profil und nichts an Claude Desktop. --dry-run zeigt nur an, was geschrieben würde.

4. Neu starten. Thunderbird und Claude Desktop einmal beenden und neu starten.

Thunderbird: Aktualisieren

Laden Sie die neuen Dateien herunter und installieren Sie sie wie beim ersten Mal – keine neue Einrichtung nötig, Ihre Einstellungen und Berechtigungen bleiben erhalten.

• Claude Desktop: die neue .mcpb installieren (Einstellungen › Erweiterungen › Erweiterte Einstellungen › „Erweiterung installieren“). Die Vorschau zeigt den Knopf „Aktualisieren“; die folgende Rückfrage sagt trotzdem „installieren“ – bestätigen. Die Erweiterungsseite zeigt keine Versionsnummer.
• Thunderbird: „Add-on aus Datei installieren …“ mit der neuen .xpi. Die Frage sagt „hinzufügen“ – die installierte Fassung wird ersetzt, es gibt weiterhin nur einen Eintrag für MailBridge. Der Reiter „Einstellungen“ erscheint unter Umständen erst, wenn Sie das Add-on erneut öffnen.
• Danach Thunderbird und Claude Desktop neu starten.

Beide Dateien müssen dieselbe Versionsnummer tragen; sonst antwortet jedes Werkzeug mit einer Meldung, die beide Versionen nennt.

Thunderbird: Freigaben später ändern

Die Einstellungsdatei liegt hier:

• Mac: ~/Library/Application Support/mailbridge-spm/config.json
• Windows: %LOCALAPPDATA%\mailbridge-spm\config.json

Eintrag	Bedeutung	Ab Werk
allowed_accounts	Konten, die die KI sieht, z. B. ["account1"]	keine
allow_direct_send	Die KI darf direkt senden (zusätzlich zur Erlaubnis in Thunderbird)	false
attachment_dirs	Ordner, aus denen die KI Dateien anhängen darf	keine
allow_move	Nachrichten verschieben und kopieren	false
allow_delete	Nachrichten und Ordner in den Papierkorb legen	false
allowed_address_books	Adressbücher, die die KI sieht (IDs von der Einstellungsseite)	keine
allow_contact_write	Kontakte anlegen, ändern und (mit Bestätigung) löschen	false
save_dirs	Ordner, in die die KI Anhänge speichern darf (sonst nur in den eigenen Cache-Ordner)	keine
allow_permanent_delete	Papierkorb und Spam endgültig leeren (zusätzlich zur Erlaubnis in Thunderbird)	false
allow_tag_write	Schlagwörter anlegen, ändern und löschen (zusätzlich zur Erlaubnis in Thunderbird)	false

Nach einer Änderung Thunderbird und Ihr KI-Programm neu starten. Eine Sperre (etwas entfernen oder ausschalten) wirkt sofort.

In Thunderbird (Add-ons und Themes › MailBridge for Thunderbird › Einstellungen) erlauben Sie – wenn gewünscht – das Senden, den Zugriff auf Adressbücher, das endgültige Löschen (Papierkorb und Spam leeren) und das Ändern von Schlagwörtern. Die Seite zeigt auch, welche Konten und Adressbücher freigegeben sind.

Kontaktdaten und Mails aus freigegebenen Konten und Adressbüchern gehen an Ihr KI-Programm, sobald die KI danach fragt. Geben Sie nur frei, was die KI sehen darf.

Thunderbird: Wenn etwas nicht geht

• „not_configured“: Die Einstellungsdatei fehlt oder ist ungültig – Einrichtung ausführen.
• Keine Verbindung zu Thunderbird: Thunderbird muss laufen, und die Erweiterung muss aktiv sein. Nach der Einrichtung Thunderbird einmal neu starten.
• „untrusted_peer“: Thunderbird und das KI-Programm neu starten. Bleibt die Meldung, läuft womöglich ein fremdes Programm unter dem Namen von MailBridge.

IMAP: Lassen Sie sich von Ihrer KI führen

Kopieren Sie diesen Text in Ihre KI-Anwendung (zum Beispiel einen neuen Chat in Claude Desktop). Die KI führt Sie Schritt für Schritt durch die Installation – sie installiert nichts selbst.

Text kopieren

Bitte führe mich Schritt für Schritt durch die Installation von „MailBridge for IMAP“ (Schnittstelle zwischen meinem E-Mail-Konto und meiner KI-Anwendung, ohne Mailprogramm). Halte dich ausschließlich an die Angaben unten, erfinde keine weiteren Schritte, Befehle oder Einstellungen. Führe selbst nichts auf meinem Rechner aus. Gib mir immer nur einen Schritt, warte auf meine Rückmeldung und frag nach, bevor es weitergeht. Frag mich zuerst, ob ich einen Mac oder Windows 11 habe und bei welchem Anbieter mein Konto ist (GMX, WEB.DE, T-Online, STRATO, Gmail, iCloud Mail, Yahoo Mail oder ein anderer), und zeig mir danach nur die passenden Angaben.

Voraussetzungen: macOS oder Windows 11; Claude Desktop (oder eine andere KI-Anwendung mit MCP); Node.js ab Version 20; ein E-Mail-Konto mit IMAP-Zugang.

Schritt 1 – Beim Anbieter: GMX und WEB.DE: IMAP in den Einstellungen des Postfachs im Webmailer einschalten (den Menüweg nennt die Hilfeseite des Anbieters). T-Online: ein eigenes „Passwort für E-Mail-Programme“ bereithalten – nicht das Passwort des Telekom-Logins. STRATO: Benutzername ist die vollständige E-Mail-Adresse. Gmail, iCloud Mail und Yahoo Mail: in der Einrichtung „anderer Anbieter“ wählen und ein App-Passwort verwenden. Gmail – IMAP imap.gmail.com, Port 993, TLS; SMTP smtp.gmail.com, Port 465, TLS; App-Passwort unter https://myaccount.google.com/apppasswords (dafür muss die Bestätigung in zwei Schritten eingeschaltet sein). iCloud Mail – IMAP imap.mail.me.com, Port 993, TLS; SMTP smtp.mail.me.com, Port 587, STARTTLS; Benutzername ist die vollständige iCloud-Adresse; App-spezifisches Passwort auf https://account.apple.com unter „App-Specific Passwords“ (dafür muss die Zwei-Faktor-Authentifizierung eingeschaltet sein). Yahoo Mail – IMAP imap.mail.yahoo.com, Port 993, TLS; SMTP smtp.mail.yahoo.com, Port 465, TLS; Benutzername ist die vollständige Adresse; App-Passwort in der Kontosicherheit von Yahoo über „Create app password“. Andere Anbieter: Server, Port und Verschlüsselung (TLS oder STARTTLS) für IMAP und für den Postausgang (SMTP) von der Hilfeseite des Anbieters bereithalten; verlangt der Anbieter ein App-Passwort, dieses nehmen.

Schritt 2 – Node.js: Von https://nodejs.org die Version „LTS“ herunterladen und installieren.

Schritt 3 – Datei: Von https://mcp-schnittstellen.de/mailbridge/ unter „MailBridge for IMAP“ die Datei .mcpb laden.

Schritt 4 – Claude Desktop: Einstellungen › Erweiterungen › Erweiterte Einstellungen › „Erweiterung installieren“, die Datei .mcpb wählen und mit „Installieren“ bestätigen.

Schritt 5 – Einrichtung, einmal je Konto. Mac: Programm „Terminal“ öffnen und diesen Befehl einfügen:
node "$HOME/Library/Application Support/Claude/Claude Extensions/local.mcpb.mcp-interfaces.mailbridge-imap/dist/src/imap/start.cjs" --setup
Windows: „PowerShell“ öffnen und diese zwei Zeilen nacheinander einfügen:
$b = @(Get-Item "$env:LOCALAPPDATA\Packages\Claude_*\LocalCache\Roaming\Claude\Claude Extensions\local.mcpb.mcp-interfaces.mailbridge-imap", "$env:APPDATA\Claude\Claude Extensions\local.mcpb.mcp-interfaces.mailbridge-imap" -ErrorAction SilentlyContinue)[0].FullName; $b
node "$b\dist\src\imap\start.cjs" --setup
Zeigt die erste Zeile nichts an bzw. meldet das Terminal „Cannot find module“, ist Schritt 4 noch nicht erledigt. Kennt die PowerShell „node“ nicht, den vollen Pfad nehmen, zum Beispiel: & "C:\Program Files\nodejs\node.exe" "$b\dist\src\imap\start.cjs" --setup
Die Einrichtung spricht deutsch oder englisch je nach Sprache des Rechners (festlegen mit --lang de bzw. --lang en) und fragt nacheinander: ob die KI direkt senden darf (Empfehlung: nein), Anbieter, E-Mail-Adresse, Benutzername (Enter übernimmt die Adresse), Absendername, Kurzname des Kontos, Server (Enter übernimmt die Voreinstellung), Passwort (die Eingabe bleibt unsichtbar; die Anmeldung wird geprüft und das Passwort im macOS-Schlüsselbund bzw. in der Windows-Anmeldeinformationsverwaltung abgelegt) und zuletzt, ob die KI das Konto sehen darf – dafür „j“ eingeben.

Schritt 6 – Claude Desktop einmal beenden und neu starten.

Bei Problemen: „rejected the user name or password“ → Benutzername und Passwort prüfen (bei T-Online das „Passwort für E-Mail-Programme“), dann Schritt 5 wiederholen, denselben Kurznamen eingeben und „ersetzen“ mit „j“ bestätigen. „refused IMAP access“ → bei GMX bzw. WEB.DE IMAP im Webmailer einschalten. „No password is stored“ → Schritt 5 für das Konto wiederholen. Gmail: archivierte Mails findet die KI nur, wenn in Gmail unter Einstellungen › Labels bei „Alle E-Mails“ das Häkchen „In IMAP anzeigen“ gesetzt ist. Die KI sieht kein Konto → in Schritt 5 die Freigabe mit „j“ beantworten, dann Claude Desktop neu starten. Alles Weitere: Anleitung unter https://mcp-schnittstellen.de/mailbridge/anleitung.html#imap

IMAP: Vorher beim Anbieter einstellen

• GMX und WEB.DE: IMAP muss in den Einstellungen Ihres Postfachs (im Webmailer) eingeschaltet sein. Die Hilfeseiten sagen dazu: „Um POP3 oder IMAP nutzen zu können, müssen Sie diese Funktion in den GMX Einstellungen einschalten“ (bei WEB.DE entsprechend). Den Menüweg nennt die Hilfeseite Ihres Anbieters.
• T-Online (Telekom): Sie brauchen ein eigenes „Passwort für E-Mail-Programme“ – nicht das Passwort Ihres Telekom-Logins.
• STRATO: Benutzername ist die vollständige E-Mail-Adresse.
• Gmail: In der Einrichtung „anderer Anbieter“ wählen. IMAP imap.gmail.com, Port 993, TLS; SMTP smtp.gmail.com, Port 465, TLS; Benutzername ist die vollständige Adresse. Statt des Google-Passworts ein App-Passwort verwenden (anlegen unter myaccount.google.com/apppasswords; dafür muss die Bestätigung in zwei Schritten eingeschaltet sein). Archivierte Mails liegen bei Gmail nur in „Alle Nachrichten“: Damit die KI sie findet, muss in Gmail unter Einstellungen › Labels bei „Alle E-Mails“ das Häkchen „In IMAP anzeigen“ gesetzt sein.
• iCloud Mail: „anderer Anbieter“. IMAP imap.mail.me.com, Port 993, TLS; SMTP smtp.mail.me.com, Port 587, STARTTLS; Benutzername ist die vollständige iCloud-Adresse. Statt des Apple-Passworts ein App-spezifisches Passwort verwenden (auf account.apple.com unter „App-Specific Passwords“; dafür muss die Zwei-Faktor-Authentifizierung eingeschaltet sein). Hinweis: Mails, die iCloud als Werbung einstuft, liegen im Ordner „Junk“ – die KI sucht dort nur, wenn Sie es ausdrücklich wünschen.
• Yahoo Mail: „anderer Anbieter“. IMAP imap.mail.yahoo.com, Port 993, TLS; SMTP smtp.mail.yahoo.com, Port 465, TLS; Benutzername ist die vollständige Adresse. Statt des Yahoo-Passworts ein App-Passwort verwenden (in der Kontosicherheit von Yahoo über „Create app password“). Die Angaben stammen von der Hilfeseite von Yahoo.
• Andere Anbieter: Halten Sie Server, Port und Verschlüsselung (TLS oder STARTTLS) für IMAP und für den Postausgang (SMTP) bereit – sie stehen auf der Hilfeseite Ihres Anbieters. Verlangt Ihr Anbieter für Mailprogramme ein App-Passwort, nehmen Sie dieses.

IMAP: Installation und Einrichtung

Laden Sie die Datei MailBridge-for-IMAP-<Version>.mcpb von der Produktseite herunter.

1. In Claude Desktop installieren. Einstellungen › Erweiterungen › Erweiterte Einstellungen › „Erweiterung installieren“, die Datei .mcpb wählen und mit „Installieren“ bestätigen.

2. Einrichtung ausführen – einmal je Konto im Terminal (Mac) bzw. in der PowerShell (Windows). Die Einstellungsdatei wird erst am Ende geschrieben.

Mac:

node "$HOME/Library/Application Support/Claude/Claude Extensions/local.mcpb.mcp-interfaces.mailbridge-imap/dist/src/imap/start.cjs" --setup

Meldet das Terminal „Cannot find module“, ist die Erweiterung noch nicht installiert (Schritt 1).

Windows (PowerShell) – zwei Zeilen; die erste sucht den Ordner der Erweiterung:

$b = @(Get-Item "$env:LOCALAPPDATA\Packages\Claude_*\LocalCache\Roaming\Claude\Claude Extensions\local.mcpb.mcp-interfaces.mailbridge-imap", "$env:APPDATA\Claude\Claude Extensions\local.mcpb.mcp-interfaces.mailbridge-imap" -ErrorAction SilentlyContinue)[0].FullName; $b
node "$b\dist\src\imap\start.cjs" --setup

Zeigt die erste Zeile nichts an, ist die Erweiterung noch nicht installiert. Kennt die PowerShell node nicht, nehmen Sie den vollen Pfad, zum Beispiel & "C:\Program Files\nodejs\node.exe" "$b\dist\src\imap\start.cjs" --setup.

Die Einrichtung spricht deutsch oder englisch je nach Sprache Ihres Rechners; festlegen lässt sich das mit --lang de oder --lang en. Mit --dry-run hinter --setup zeigt sie nur, was sie schreiben würde (ohne Passwortabfrage). Die Fragen nacheinander:

1. Senden: Darf die KI direkt senden? Voreinstellung: nein – dann legt sie nur Entwürfe an.
2. Anbieter: GMX, WEB.DE, T-Online, STRATO oder „anderer Anbieter“ – auch für Gmail, iCloud Mail und Yahoo Mail (Serverdaten siehe oben).
3. E-Mail-Adresse und Benutzername (meist die vollständige Adresse; Enter übernimmt sie).
4. Absendername: der Name, wie Empfänger ihn sehen. Leer lassen: Im Entwurf steht nur die Adresse.
5. Kurzname des Kontos, z. B. gmx – unter diesem Namen kennt die KI das Konto. Gibt es ihn schon, fragt die Einrichtung, ob das vorhandene Konto ersetzt werden soll (Voreinstellung: nein).
6. Server für IMAP und SMTP: bei den vier Anbietern voreingestellt (Enter übernimmt); sonst Server, Verschlüsselung und Port eingeben.
7. Passwort bzw. App-Passwort: Die Eingabe bleibt unsichtbar. MailBridge prüft die Anmeldung und legt das Passwort erst dann im macOS-Schlüsselbund bzw. in der Windows-Anmeldeinformationsverwaltung ab. Unter Windows bleibt es auf diesem Rechner.
8. Freigabe: Darf die KI dieses Konto sehen? Voreinstellung: nein.

3. Claude Desktop neu starten.

IMAP: Freigaben, Aktualisieren, Grenzen

Die Einstellungsdatei liegt hier:

• Mac: ~/Library/Application Support/mailbridge-imap/config.json
• Windows: %LOCALAPPDATA%\mailbridge-imap\config.json

Eintrag	Bedeutung	Ab Werk
allowed_accounts	Kurznamen der Konten, die die KI sieht, z. B. ["gmx"]	keine
allow_direct_send	Die KI darf gespeicherte Entwürfe verschicken	false
allow_move	Nachrichten und Ordner verschieben, Nachrichten kopieren	false
allow_delete	Nachrichten und Ordner in den Papierkorb legen	false
attachment_dirs	Ordner, aus denen die KI Dateien anhängen darf	keine
save_dirs	Ordner, in die die KI Anhänge speichern darf (sonst nur in den eigenen Cache-Ordner)	keine
language	Sprache von Zitat- und Weiterleitungskopf: "de" oder "en"	"de"

Freigabe entziehen: den Kurznamen aus allowed_accounts entfernen – das wirkt sofort. Etwas freigeben oder einschalten: Eintrag ergänzen bzw. auf true setzen, dann Claude Desktop neu starten. Passwörter gehören nie in diese Datei.

Aktualisieren: die neue Datei .mcpb wie beim ersten Mal installieren; Einstellungen und Passwörter bleiben erhalten. Danach Claude Desktop neu starten.

Grenzen: Die Suche im Text kann in großen Postfächern langsam sein; antwortet der Server nicht rechtzeitig, liest MailBridge die neuesten Nachrichten selbst und sagt ausdrücklich, wenn das Ergebnis unvollständig sein kann – schränken Sie die Suche dann mit Ordner und Zeitraum ein. Anmeldung nur mit Benutzername und Passwort bzw. App-Passwort. Keine Filter, Adressbücher oder Kalender; kein endgültiges Löschen.

IMAP: Wenn etwas nicht geht

Die Meldungen der Werkzeuge sind englisch; sie nennen Konto und Server, nie das Passwort.

• „No configuration file found“ bzw. „… is invalid“: Einrichtung ausführen bzw. den genannten Eintrag korrigieren.
• „rejected the user name or password“: Benutzername (meist die vollständige Adresse) und Passwort prüfen – bei T-Online das „Passwort für E-Mail-Programme“. Dann die Einrichtung erneut ausführen, denselben Kurznamen eingeben und „ersetzen“ mit j bestätigen.
• „refused IMAP access“: Bei GMX und WEB.DE IMAP in den Einstellungen des Postfachs einschalten.
• „No password is stored“: Einrichtung für das Konto erneut ausführen.
• „A secure connection … could not be established“ oder „Cannot connect“: Server, Port und Verschlüsselung prüfen. Üblich sind bei IMAP Port 993 mit TLS oder 143 mit STARTTLS, beim Postausgang 465 mit TLS oder 587 mit STARTTLS. Unverschlüsselt verbindet MailBridge nie.
• „did not answer in time“: Später erneut versuchen; eine Suche einschränken.
• „… is switched off (allow_move …)“ bzw. „(allow_delete …)“: Verschieben bzw. Löschen ist ausgeschaltet; nichts wurde geändert.

Apple Mail: Lassen Sie sich von Ihrer KI führen

Kopieren Sie diesen Text in Ihre KI-Anwendung (zum Beispiel einen neuen Chat in Claude Desktop). Die KI führt Sie Schritt für Schritt durch die Installation – sie installiert nichts selbst.

Text kopieren

Bitte führe mich Schritt für Schritt durch die Installation von „MailBridge for Apple Mail“ (Schnittstelle zwischen dem Programm Mail auf meinem Mac und meiner KI-Anwendung). Halte dich ausschließlich an die Angaben unten, erfinde keine weiteren Schritte, Befehle oder Einstellungen. Führe selbst nichts auf meinem Rechner aus. Gib mir immer nur einen Schritt, warte auf meine Rückmeldung und frag nach, bevor es weitergeht.

Voraussetzungen: ein Mac mit Apple Mail und mindestens einem darin eingerichteten Konto; Claude Desktop (oder eine andere KI-Anwendung mit MCP); Node.js ab Version 20. MailBridge for Apple Mail sendet nie; neue Nachrichten, Antworten und Weiterleitungen legt es nur als Entwurf an. Für Entwürfe mit eigenem Text braucht es je Konto das Passwort des Mailservers (bei iCloud und Google ein app-spezifisches Passwort).

Schritt 1 – Node.js: Von https://nodejs.org die Version „LTS“ herunterladen und installieren.

Schritt 2 – Datei: Von https://mcp-schnittstellen.de/mailbridge/ unter „MailBridge for Apple Mail“ die Datei .mcpb laden.

Schritt 3 – Claude Desktop: Einstellungen › Erweiterungen › Erweiterte Einstellungen › „Erweiterung installieren“, die Datei .mcpb wählen und mit „Installieren“ bestätigen.

Schritt 4 – Einrichtung: Programm „Terminal“ öffnen und diesen Befehl einfügen:
node "$HOME/Library/Application Support/Claude/Claude Extensions/local.mcpb.mcp-interfaces.mailbridge-applemail/dist/src/applemail/start.cjs" --setup
Meldet das Terminal „Cannot find module“, ist Schritt 3 noch nicht erledigt. Die Einrichtung kündigt an, dass macOS fragt, ob „Terminal“ die App „Mail“ steuern darf – „Erlauben“ bzw. „OK“ klicken. Dann zeigt sie die Konten aus Mail und fragt je Konto, ob die KI es sehen darf (für das gewünschte Konto „j“ und einen Kurznamen, z. B. „privat“), je freigegebenem Konto nach dem Passwort des Mailservers für Entwürfe mit eigenem Text (die Eingabe bleibt unsichtbar, Enter überspringt), ob die KI Nachrichten verschieben und kopieren darf, ob sie Nachrichten in den Papierkorb legen darf (beides Empfehlung: erst einmal nein), und nach zwei Ordnern für Anhänge (Enter übernimmt den Vorschlag, „-“ heißt keiner). Gespeichert wird erst nach Bestätigung. Die Einrichtung spricht deutsch oder englisch je nach Sprache des Mac; mit --lang de bzw. --lang en dahinter lässt sie sich festlegen.

Schritt 5 – Claude Desktop einmal beenden und neu starten. Beim ersten Zugriff fragt macOS noch einmal, diesmal für „Claude“ – auch dann „Erlauben“.

Bei Problemen: „No configuration file found“ → Schritt 4 ausführen. „macOS does not allow controlling Apple Mail“ → Systemeinstellungen › Datenschutz & Sicherheit › Automation › beim Programm (Terminal bzw. Claude) „Mail“ einschalten. „Apple Mail is not running and could not be reached“ → Mail einmal öffnen. Die KI sieht kein Konto → Schritt 4 wiederholen und die Freigabe mit „j“ beantworten, dann Claude Desktop neu starten. Alles Weitere: Anleitung unter https://mcp-schnittstellen.de/mailbridge/anleitung.html#applemail

Apple Mail: Installation und Einrichtung

Laden Sie die Datei MailBridge-for-Apple-Mail-<Version>.mcpb von der Produktseite herunter.

1. In Claude Desktop installieren. Einstellungen › Erweiterungen › Erweiterte Einstellungen › „Erweiterung installieren“, die Datei .mcpb wählen und mit „Installieren“ bestätigen.

2. Einrichtung ausführen – einmal im Terminal. Der Befehl liest die Liste Ihrer Konten aus Mail, fragt alles ab und schreibt die Einstellungsdatei erst am Ende:

node "$HOME/Library/Application Support/Claude/Claude Extensions/local.mcpb.mcp-interfaces.mailbridge-applemail/dist/src/applemail/start.cjs" --setup

Meldet das Terminal „Cannot find module“, ist die Erweiterung noch nicht installiert (Schritt 1). Mit --dry-run hinter --setup zeigt die Einrichtung nur, was sie schreiben würde. Sie spricht deutsch oder englisch je nach Sprache Ihres Mac; festlegen lässt sich das mit --lang de oder --lang en.

Die Einrichtung fragt nacheinander:

1. Ankündigung: macOS fragt gleich, ob „Terminal“ die App „Mail“ steuern darf – „Erlauben“ bzw. „OK“ klicken. Läuft Mail nicht, wird es gestartet.
2. Freigabe je Konto: Darf die KI dieses Konto sehen? Voreinstellung: nein. Bei „ja“ ein Kurzname (klein, ohne Leerzeichen, z. B. privat) – unter diesem Namen kennt die KI das Konto.
3. Entwürfe mit eigenem Text: je freigegebenem Konto das Passwort des Mailservers. Die Eingabe bleibt unsichtbar; Enter überspringt das Konto. Die Einrichtung prüft die Anmeldung und legt das Passwort erst beim Speichern in den macOS-Schlüsselbund. Bei iCloud und Google braucht es ein app-spezifisches Passwort des Anbieters.
4. Verschieben und Kopieren (allow_move) – Voreinstellung: nein.
5. Papierkorb (allow_delete) – Voreinstellung: nein. Endgültig gelöscht wird nie.
6. Ordner für gespeicherte Anhänge – Vorschlag ~/mailbridge-anhaenge; Enter übernimmt, „-“ heißt keiner.
7. Ordner, aus dem die KI Dateien anhängen darf – für Entwürfe mit eigenem Text und beim Weiterleiten als Anhang; Enter übernimmt, „-“ heißt keiner.
8. Speichern: erst nach Ihrer Bestätigung; die Datei ist nur für Sie lesbar.

3. Claude Desktop neu starten. Beim ersten Zugriff fragt macOS noch einmal, diesmal für „Claude“ – auch dann „Erlauben“.

Apple Mail: Freigaben, Aktualisieren, Grenzen

Die Einstellungsdatei liegt hier: ~/Library/Application Support/mailbridge-applemail/config.json

Eintrag	Bedeutung	Ab Werk
allowed_accounts	Kurznamen der Konten, die die KI sieht, z. B. ["privat"]	keine
allow_move	Nachrichten verschieben und kopieren	false
allow_delete	Nachrichten in den Papierkorb legen	false
save_dirs	Ordner, in die die KI Anhänge speichern darf (sonst nur in den eigenen Cache-Ordner)	keine
attachment_dirs	Ordner, aus denen die KI Dateien anhängen darf	keine
accounts[].server	Mailserver, Port und Benutzer für Entwürfe mit eigenem Text (schreibt die Einrichtung; das Passwort liegt im Schlüsselbund)	keiner
start_mail_visible	Läuft Mail nicht, startet MailBridge es sichtbar (true) oder im Hintergrund (false)	true

Freigabe entziehen: den Kurznamen aus allowed_accounts entfernen – das wirkt sofort – oder die Einrichtung erneut ausführen und „nein“ antworten; dabei wird auch das Passwort des Kontos aus dem Schlüsselbund entfernt. Passwörter gehören nie in die Einstellungsdatei. Etwas freigeben oder einschalten: Eintrag ergänzen bzw. auf true setzen, dann Claude Desktop neu starten. Die Freigabe zum Steuern von Mail nehmen Sie in den Systemeinstellungen › Datenschutz & Sicherheit › Automation zurück.

Aktualisieren: die neue Datei .mcpb wie beim ersten Mal installieren; die Einstellungen bleiben erhalten. Danach Claude Desktop neu starten. Wer von Version 0.2.0 kommt und Entwürfe mit eigenem Text nutzen will, führt die Einrichtung einmal erneut aus und gibt dabei das Passwort ein.

Grenzen: nur macOS, nur mit Apple Mail. Kein Senden; alles entsteht als Entwurf. Eigener Text nur für Konten mit Passwort aus der Einrichtung; sonst keine neuen Nachrichten und Antworten und Weiterleitungen ohne eigenen Text. Keine Schlagwörter, kein endgültiges Löschen, Ordner nicht verschieben oder löschen. Die Suche liest Mail Ordner für Ordner – bei sehr vielen Ordnern werden Posteingang, Gesendet, Entwürfe und Archiv zuerst durchsucht.

Andere KI-Programme: Befehl node, Argument der Pfad zu dist/src/applemail/start.cjs im installierten Paket (siehe Schritt 2). macOS fragt beim ersten Zugriff für dieses Programm, ob es Mail steuern darf.

Entfernen: denselben Befehl wie in Schritt 2 mit --uninstall statt --setup ausführen (fragt vorher nach; entfernt auch die Passwörter für Entwürfe aus dem Schlüsselbund; gespeicherte Anhänge bleiben liegen), dann die Erweiterung in Claude Desktop entfernen und in den Systemeinstellungen › Datenschutz & Sicherheit › Automation die Steuerung von Mail abschalten.

Apple Mail: Wenn etwas nicht geht

Die Meldungen der Werkzeuge sind englisch.

• „No configuration file found“ bzw. „… is invalid“: Einrichtung ausführen bzw. den genannten Eintrag korrigieren.
• „macOS does not allow controlling Apple Mail“: Systemeinstellungen › Datenschutz & Sicherheit › Automation › beim Programm (Terminal bzw. Claude) „Mail“ einschalten.
• „Apple Mail is not running and could not be reached“: Mail einmal öffnen und erneut versuchen.
• „did not finish in time“ oder eine unvollständige Suche: die Suche mit einem Ordner und einem Zeitraum einschränken.
• „… is switched off (allow_move …)“ bzw. „(allow_delete …)“: Verschieben bzw. Papierkorb ist ausgeschaltet; nichts wurde geändert.
• „… needs an account that is set up for drafts with your own text“ bzw. „No password is stored for account …“: Für dieses Konto fehlt das Passwort des Mailservers – Einrichtung erneut ausführen und es eingeben.
• „Login failed“ o. Ä. beim Entwurf: Das Passwort hat sich geändert – Einrichtung erneut ausführen und das neue eingeben.
• Ein Entwurf fehlt in Mail (messageId: null): Der Entwurf ist auf dem Mailserver gespeichert. Apple Mail zeigt ihn nach dem nächsten Abgleich im Ordner „Entwürfe“ – das kann einige Minuten dauern. Schneller geht es mit Postfach › Synchronisieren.
• Nachricht nach dem Verschieben nicht mehr gefunden: Beim Verschieben, Kopieren, in den Papierkorb Legen und nach dem Umbenennen eines Ordners bekommt eine Nachricht eine neue Kennung; die KI findet sie über die Suche wieder.

Beide Fassungen: Andere KI-Programme

MailBridge ist ein gewöhnlicher lokaler MCP-Server (stdio). Tragen Sie in Ihrem Programm diesen Befehl ein:

• Befehl: node
• Argument: der Pfad zu dist/src/mcp/start.cjs (Thunderbird) bzw. dist/src/imap/start.cjs (IMAP) im installierten Paket (siehe Installation) – oder, ohne Claude Desktop, in einem Ordner, in den Sie die Datei .mcpb entpackt haben (sie ist ein ZIP-Archiv).

Beispiel GitHub Copilot CLI, Datei ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "mailbridge-spm": {
      "type": "local",
      "command": "node",
      "args": ["<Pfad>/dist/src/mcp/start.cjs"],
      "env": {},
      "tools": ["*"]
    }
  }
}

Die Freigaben gelten für jedes Programm gleich – sie stehen in der Einstellungsdatei (und bei Thunderbird in Thunderbird), nicht im KI-Programm.

Beide Fassungen: Entfernen

Thunderbird:

1. Das Hilfsprogramm austragen – vor dem Entfernen in Claude Desktop, mit demselben Befehl wie bei der Einrichtung, aber --uninstall statt --setup. Er fragt vorher nach.
2. In Claude Desktop die Erweiterung entfernen, in Thunderbird das Add-on entfernen.
3. Die Einstellungsdatei und das Protokoll liegen im oben genannten Ordner und können gelöscht werden.

IMAP:

1. Passwörter und Einstellungen entfernen – vorher, mit demselben Befehl wie bei der Einrichtung, aber --uninstall statt --setup. Nach einer Rückfrage entfernt er die Passwörter aller Konten der Einstellungsdatei und danach die Datei; gespeicherte Anhänge bleiben liegen. Mit --dry-run dahinter zeigt er nur, was er entfernen würde.
2. In Claude Desktop die Erweiterung entfernen.
3. Nur ein Konto: --remove-password <Kurzname> statt --setup entfernt dessen Passwort und lässt die Einstellungsdatei unverändert. Am Mac geht es auch in der Schlüsselbundverwaltung (Einträge „mailbridge-imap:<Kurzname>“).

Marken

Thunderbird ist eine Marke der Mozilla Foundation. MailBridge steht in keiner Verbindung zur Mozilla Foundation und wird von ihr nicht unterstützt. GMX, WEB.DE, T-Online und STRATO werden nur genannt, um die voreingestellten Serverdaten zu beschreiben, Gmail, iCloud Mail und Yahoo Mail nur, um die Einrichtung zu beschreiben; MailBridge steht in keiner Verbindung zu diesen Anbietern. Apple, Apple Mail, Mail und macOS werden nur genannt, um das Programm zu beschreiben, mit dem MailBridge for Apple Mail arbeitet; sie sind Marken der Apple Inc. MailBridge steht in keiner Verbindung zu Apple.

Lizenz

Kostenlose Nutzung; Weitergabe nicht erlaubt – siehe Lizenz und Nutzungsbedingungen.