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.

Related MCP server: Thunderbird MCP

Funktionen

• 🔐 Keine Offenlegung von Anmeldedaten – sämtliche IMAP/SMTP-Daten verbleiben in Thunderbird

• 🤖 Bereit für Claude Desktop – 12 MCP-Tools, Einzeilen-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 zugelassen 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ändiger MCP-Leitfaden: mcp/README.md

Begleit-Skill für Claude

Ein Claude Skill wird zusammen mit dem MCP-Server ausgeliefert. Er bringt Claude bei, wie man die 12 E-Mail-Tools gut nutzt – token-effiziente Feldauswahl, Sicherheit durch Standard-Entwürfe, Überprüfung von Vertrauens-Metadaten vor dem Klicken auf Links, Rezepte für gängige Arbeitsabläufe. Installieren Sie ihn von skills/thunderbird-cli/:

# Claude Code
cp -r skills/thunderbird-cli ~/.claude/skills/

# Claude.ai — zip and upload via Settings → Capabilities → Skills
cd skills && zip -r thunderbird-cli.zip thunderbird-cli

Ohne den Skill funktioniert das MCP weiterhin. Mit ihm verwendet Claude automatisch die sichersten Standardeinstellungen und effizientesten Antwortformate.

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