imap-mcp

IMAP-Client-MCP. Lesen Sie E-Mails aus einem Dovecot- / Synology MailPlus-Postfach und lösen Sie optional Webhooks aus, wenn neue passende Nachrichten eingehen — ersetzt fehleranfälliges Gmail-OAuth für Automatisierungstrigger.

Tools

Tool	Beschreibung
`list_unread(mailbox, limit)`	Zusammenfassungen ungelesener Nachrichten
`search(criteria, mailbox, limit)`	Rohe IMAP-SUCHE
`fetch(uid, mailbox)`	Vollständige Nachricht (Header + Text + HTML)
`mark_read(uid, mailbox)`	Setzt das `\Seen`-Flag
`move(uid, source, dest)`	In einen anderen Ordner verschieben
`list_folders()`	Alle Ordner
`get_status()`	IMAP-Ping + Überwachungsregeln + Auslösezähler

Umgebung

Variable	Erforderlich	Beschreibung
`IMAP_HOST`	✓	Server (z. B. `192.168.68.61`)
`IMAP_PORT`		Standard `993`
`IMAP_SSL`		`true` (Standard) oder `false`
`IMAP_USERNAME`	✓	Synology-Kontoname, nicht E-Mail
`IMAP_PASSWORD`	✓
`IMAP_DEFAULT_MAILBOX`		Standard `INBOX`
`WATCHES_JSON`		Inline-JSON-Array von Überwachungsregeln
`WATCHES_FILE`		Pfad zur JSON-Datei (Standard `/data/watches.json`)
`POLL_INTERVAL_SECS`		Standard `30`
`PORT`		MCP-Server-Port (Standard `38105`)

Überwachungsregeln

[
  {
    "name": "garmin-livetrack",
    "mailbox": "INBOX",
    "criteria": "FROM \"noreply@garmin.com\" SUBJECT \"LiveTrack\" UNSEEN",
    "webhook_url": "http://host.docker.internal:5678/webhook/livetrack-mail",
    "mark_read": true,
    "move_to": null
  }
]

Beim Start "initialisiert" der Watcher jede Regel mit vorhandenen passenden UIDs, sodass nur neue E-Mails nach dem Booten ausgelöst werden. Alle POLL_INTERVAL_SECS führt er die Kriterien jeder Regel erneut aus und sendet passende Nachrichten (vollständiger Text) per POST an die webhook_url als { "rule": "...", "mailbox": "...", "message": {...} }. Nach einem erfolgreichen POST verschiebt er die Nachricht entweder nach move_to oder markiert sie als gelesen, falls mark_read gesetzt ist.