MCP Notmuch Sendmail

MCP Notmuch Sendmail

Status: Funktioniert einwandfrei und ist im täglichen Einsatz ohne bekannte Fehler.

Status 2: Ich habe das Paket gerade zu PyPI hinzugefügt und die Gebrauchsanweisung aktualisiert. Bitte melden Sie etwaige Probleme. :)

Claude ist Ihr E-Mail-Assistent! MCP Notmuch Sendmail verbindet Claude Desktop mit Ihrer Notmuch-E-Mail-Datenbank und ermöglicht so:

• Durchsuchen und durchsuchen Sie Ihre E-Mail-Threads
• Konversationen in einem sauberen Textformat anzeigen
• Verfassen Sie neue E-Mails mit Markdown
• Antworten Sie auf Threads mit intelligenter Deduplizierung zitierter Inhalte
• Erstellen Sie ansprechende E-Mails mit LaTeX-inspiriertem Styling
• Synchronisieren Sie Ihre E-Mail-Datenbank durch Ausführen eines konfigurierten Skripts

Verwendet html2text für die HTML-E-Mail-Wiedergabe und markdown-it zum Erstellen umfangreicher HTML-E-Mails mit Inline-Bildern.

Installation

Stellen Sie sicher, dass Sie UV installiert haben:

Verwendung mit Claude Desktop

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

Umgebungsvariablen

• NOTMUCH_DATABASE_PATH : Pfad zu Ihrer Notmuch-Datenbank (erforderlich)
• NOTMUCH_REPLY_SEPARATORS : Durch Pipes getrennte Liste von Textmarkierungen – behält den E-Mail-Inhalt bis zur ersten Zeile bei, die mit einer dieser Markierungen beginnt, und entfernt zitierte Antworten (erforderlich)
• SENDMAIL_FROM_EMAIL : Ihre E-Mail-Adresse für das Feld „Von:“ (erforderlich)
• SENDMAIL_EMAIL_SIGNATURE_HTML : HTML-Signatur zum Anhängen an E-Mails (optional)
• NOTMUCH_SYNC_SCRIPT : Pfad zu einem Skript zum Synchronisieren von E-Mails (optional)
• LOG_FILE_PATH : Pfad zur Protokolldatei (optional)
• DRAFT_DIR : Verzeichnis zum Speichern von E-Mail-Entwürfen (optional, standardmäßig /tmp/mcp-notmuch-sendmail)

API

Werkzeuge

• E-Mail-Thread finden
  • E-Mail-Threads in der Notmuch-Datenbank finden
  • Eingabe: notmuch_search_query (Zeichenfolge)
  • Gibt eine durch Tabulatoren getrennte Liste von Threads im Format: GXP3 zurück
• E-Mail-Thread anzeigen
  • Alle Nachrichten für einen E-Mail-Thread anzeigen
  • Eingabe: thread_id (Zeichenfolge)
  • Gibt die Konversation im Textformat mit HTML->Text-Konvertierung GXP4 zurück
• neue E-Mail verfassen
  • Erstellen Sie einen neuen E-Mail-Entwurf aus Markdown. Eine Signatur wird automatisch hinzugefügt, wenn SENDMAIL_EMAIL_SIGNATURE_HTML gesetzt ist.
  • Eingänge:
    • subject (Zeichenfolge): E-Mail-Betreff
    • body_as_markdown (Zeichenfolge): E-Mail-Text in Markdown
    • to (Liste): E-Mail-Adressen der Empfänger
    • cc (Liste, optional): CC-Empfänger
    • bcc (Liste, optional): BCC-Empfänger
  • Erstellt Entwurfsdateien und gibt Pfade zurück: GXP5
• E-Mail-Antwort verfassen
  • Verfassen Sie eine Antwort auf einen bestehenden E-Mail-Thread. Eine Signatur wird automatisch hinzugefügt, wenn SENDMAIL_EMAIL_SIGNATURE_HTML aktiviert ist.
  • Eingänge:
    • thread_id (Zeichenfolge): Thread-ID, auf die geantwortet werden soll
    • subject (Zeichenfolge): E-Mail-Betreff
    • body_as_markdown (Zeichenfolge): E-Mail-Text in Markdown
    • to (Liste): E-Mail-Adressen der Empfänger
    • cc (Liste, optional): CC-Empfänger
    • bcc (Liste, optional): BCC-Empfänger
  • Erstellt Entwurfsdateien und gibt Pfade zurück: GXP6
• E-Mail senden
  • Sendet den verfassten E-Mail-Entwurf
  • Keine Eingabe erforderlich
  • Gibt eine Erfolgs-/Fehlermeldung zurück
• E-Mails synchronisieren
  • Synchronisiert E-Mails durch Ausführen des konfigurierten Skripts
  • Keine Eingabe erforderlich
  • Gibt die Ausgabe des Skripts einschließlich stdout und stderr zurück
  • Nur verfügbar, wenn NOTMUCH_SYNC_SCRIPT konfiguriert ist

Antworttrennzeichen

Die Umgebungsvariable NOTMUCH_REPLY_SEPARATORS steuert die Erkennung von E-Mail-Antworten. Beim Anzeigen eines Threads wird der Inhalt jeder E-Mail auf die erste Zeile gekürzt, die mit einem der konfigurierten Trennzeichen beginnt. Dadurch werden zitierte Antworten effektiv entfernt, während der neue Inhalt erhalten bleibt.

Hier sind empfohlene Trennzeichenmuster für verschiedene Sprachen:

Englisch

Deutsch

Französisch

Niederländisch

Italienisch

Hinweis: Trennen Sie Muster mit dem Pipe-Zeichen |. Dies sind vereinfachte Muster, die aus gängigen E-Mail-Clients abgeleitet wurden. Sie müssen sie möglicherweise an Ihre spezifischen Anforderungen anpassen.

Beitragen

Beiträge sind herzlich willkommen! Ob Fehlerberichte, Funktionswünsche, Dokumentationsverbesserungen oder Codebeiträge – jeder Input ist wertvoll. Fühlen Sie sich frei:

• Öffnen Sie ein Problem, um Fehler zu melden oder Funktionen vorzuschlagen
• Senden Sie Pull Requests mit Verbesserungen
• Erweitern Sie die Dokumentation oder teilen Sie Ihre Anwendungsbeispiele
• Stellen Sie Fragen und teilen Sie Ihre Erfahrungen

Das Ziel besteht darin, das E-Mail-Management mit Claude noch besser zu machen, und Ihre Erkenntnisse und Beiträge helfen dabei, dies zu erreichen.

Danksagung

Dieses Projekt baut auf der hervorragenden Arbeit anderer auf:

• mail-parser-reply - Für die umfassenden E-Mail-Antwortmarkierungsmuster
• notmuch – Die schnelle Mail-Indizierungs- und Suchmaschine
• html2text - Zum Konvertieren von HTML-E-Mails in lesbaren Text
• markdown-it-py – Zum Generieren schöner HTML-E-Mails
• latex.css - Für die E-Mail-Formatierung im LaTeX-Stil

Lizenz

Mozilla Public License Version 2.0

Meine anderen LLM-Projekte

• MCP Alchemy – Verbinden Sie Claude Desktop mit Datenbanken, um Schemata zu erkunden und SQL auszuführen.
• MCP Redmine – Lassen Sie Claude Desktop Ihre Redmine-Projekte und -Probleme verwalten.
• Diffpilot – Mehrspaltiger Git-Diff-Viewer mit Dateigruppierung und -markierung.
• Lokale Claude-Dateien – Greifen Sie auf lokale Dateien in Claude-Desktop-Artefakten zu.