thunderbird-cli

Geben Sie Claude (und anderen KI-Agenten) vollen Zugriff auf Ihre E-Mails über Mozilla Thunderbird.

Warum

IMAP-Bibliotheken zwingen Sie dazu, Anmeldedaten, OAuth-Flows und Synchronisierungsstatus zu verwalten – gefährlich im Kontext von KI-Agenten. Thunderbird löst all das bereits. Dieses Tool betrachtet Thunderbird als die Quelle der Wahrheit und stellt jede Funktion als CLI-Befehl oder MCP-Tool bereit, sodass KI-Agenten E-Mails lesen, durchsuchen und schreiben können, ohne jemals ein Passwort zu berühren.

Skaliert getestet: 22 Konten, über 249.000 Nachrichten, über 86.000 ungelesene – alles live verwaltet über eine einzige CLI.

Funktionen

• 🔐 Keine Offenlegung von Anmeldedaten – der gesamte IMAP/SMTP-Verkehr bleibt in Thunderbird

• 🤖 Bereit für Claude Desktop – 12 MCP-Tools, Ein-Zeilen-Konfiguration

• 📨 38 CLI-Befehle – Lesen, Suchen, Verfassen, Antworten, Massenvorgänge, Ordner-CRUD, Anhänge

• 🛡️ Standardmäßig sicher – Verfassen/Antworten/Weiterleiten werden als Entwürfe gespeichert; dauerhaftes Löschen erfordert --confirm

• 🎯 Token-optimiert – --fields-Auswahl, --compact-Modus, --max-body-Kürzung

• 🏠 Nur Localhost – keine Cloud, keine Telemetrie, nichts verlässt Ihren Rechner

• ✅ Thunderbird 128+ – signiert und genehmigt auf addons.thunderbird.net

• 🧪 80 Tests – 46 CLI/Bridge + 34 MCP-Integrationstests

Schnellstart

# 1. Install CLI + bridge from npm
npm install -g thunderbird-cli thunderbird-cli-bridge

# 2. Install the signed Thunderbird extension
#    Download: https://github.com/vitalio-sh/thunderbird-cli/releases/latest
#    Thunderbird → Add-ons → ⚙ → Install Add-on From File… → thunderbird_ai_bridge-*.xpi

# 3. Start the bridge daemon (keep running)
tb-bridge

# 4. Try it
tb health
tb stats

Vollständige Einrichtungsanleitung (einschließlich Hintergrunddienst, Docker, Fehlerbehebung): docs/SETUP.md

Verwendung

# How many unread across all accounts?
tb stats

# Find invoices from AWS in the last 30 days
tb search "invoice" --from aws --since 30d --fields id,author,subject,date

# Read a message (token-efficient — headers + text only, max 500 chars)
tb read 89900 --max-body 500

# Reply as draft (never auto-sends)
tb reply 89900 --body "Thanks, I'll review tomorrow"

# Download a PDF attachment
tb attachment-download 11 1.2 --output invoice.pdf

# Bulk archive old newsletters
tb bulk move "account1://INBOX" "account1://Archive" \
  --from "newsletter@" --older-than 30

Vollständige Befehlsreferenz: docs/COMMANDS.md

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

{
  "mcpServers": {
    "thunderbird": {
      "command": "npx",
      "args": ["-y", "thunderbird-cli-mcp"]
    }
  }
}

Starten Sie Claude Desktop neu. Fragen Sie nun:

*"Wie viele ungelesene E-Mails habe ich?" *"Finde Rechnungen von AWS aus dem letzten Monat" *"Antworte auf Nachricht 118, dass ich teilnehmen werde – als Entwurf speichern" "Lade den PDF-Anhang von Nachricht 245 herunter"

Vollständige MCP-Anleitung: mcp/README.md

Funktionsweise

Thunderbird ist die Quelle der Wahrheit. Die CLI speichert oder zwischenspeichert niemals E-Mail-Daten.

Vergleich

Die Nische: Sie vertrauen Thunderbird bereits Ihre Anmeldedaten und Ihren Kontostatus an. Dieses Tool macht dies als maschinenlesbare API verfügbar, ohne dass Sie IMAP/SMTP irgendwo anders neu konfigurieren müssen.

Dokumentation

Mitwirken

Beiträge sind willkommen. Bitte eröffnen Sie zuerst ein Issue, um nicht-triviale Änderungen zu besprechen. Siehe CONTRIBUTING.md für das lokale Entwickler-Setup und die 80-Test-Suite.

Lizenz

MIT — siehe LICENSE