n24q02m/better-email-mcp

Was macht better-email-mcp?

IMAP/SMTP-E-Mail-Server für KI-Agenten – 6 zusammengesetzte Tools mit Multi-Account und automatischer Erkennung

Dieser MCP-Server bietet KI-Agenten eine vollständige E-Mail-Integration über das IMPA/SMTP-Protokoll. Er umfasst sechs zusammengesetzte Tools, die gängige E-Mail-Vorgänge wie Senden, Empfangen, Durchsuchen und Verwalten von Nachrichten und Ordnern abdecken. Die Multi-Account-Funktion erlaubt den gleichzeitigen Zugriff auf mehrere E-Mail-Konten, und die automatische Erkennung vereinfacht die Einrichtung.

Unterstützte Plattformen: Claude Code, Cursor, Codex und andere MCP-kompatible KI-Agenten.

Funktionen

• 6 zusammengesetzte Tools: Kombinieren mehrere IMAP/SMTP-Befehle für komplexe Arbeitsabläufe.
• Multi-Account: Verwalten Sie mehrere E-Mail-Konten gleichzeitig.
• Auto-Discovery: Automatische Erkennung von IMAP/SMTP-Servereinstellungen basierend auf der E-Mail-Adresse.
• Sicher: Unterstützt OAuth2, App-Passwörter und Standard-Login.

Tools

1. send_email – Senden Sie eine E-Mail an einen oder mehrere Empfänger.
2. read_emails – Rufen Sie E-Mails aus einem bestimmten Ordner ab (z. B. Posteingang).
3. search_emails – Durchsuchen Sie E-Mails nach Betreff, Absender oder Datum.
4. manage_folders – Erstellen, löschen oder listen Sie E-Mail-Ordner auf.
5. reply_to_email – Antworten Sie auf eine vorhandene E-Mail.
6. forward_email – Leiten Sie eine E-Mail an einen anderen Empfänger weiter.

Konfiguration

Fügen Sie Ihrem MCP-Client-Konfigurationsdatei folgende Einträge hinzu:

{
  "mcpServers": {
    "better-email": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-email-mcp"],
      "env": {
        "EMAIL_ACCOUNTS": "[
          {
            "email": "[email protected]",
            "imapHost": "imap.email.de",
            "imapPort": 993,
            "smtpHost": "smtp.email.de",
            "smtpPort": 587,
            "password": "ihr-passwort"
          }
        ]"
      }
    }
  }
}

Umgebungsvariablen

Variable	Beschreibung	Erforderlich
EMAIL_ACCOUNTS	JSON-Array der E-Mail-Kontoinformationen	Ja

Jedes Kontoobjekt unterstützt:

• email (erforderlich): Die E-Mail-Adresse
• imapHost (optional bei Auto-Discovery): IMAP-Server-Hostname
• imapPort (optional, Standard 993): IMAP-Server-Port
• smtpHost (optional bei Auto-Discovery): SMTP-Server-Hostname
• smtpPort (optional, Standard 587): SMTP-Server-Port
• password (erforderlich): Passwort oder App-Passwort

Verwendung

Stellen Sie nach der Konfiguration eine Verbindung zu Ihrem MCP-Client her. Der Server stellt dann die sechs Tools für Ihren KI-Agenten bereit.

Beispiel (mit Claude Code)

Sende eine E-Mail an [email protected] mit dem Betreff "Hallo" und dem Text "Dies ist eine Testnachricht."

Der Agent ruft automatisch das send_email-Tool auf.

Entwicklung

Repository: github.com/n24q02m/better-email-mcp

Lizenz: MIT