IMAP

Das IMAP-Plug-in liest und verwaltet E-Mails auf einem IMAP-Server. Damit kannst du:

• Postfächer und Ordner ansehen – alle Mailboxen und den Posteingang auflisten
• Nachrichten suchen und lesen – nach Absender, Betreff oder Text suchen, Mails mit Inhalt und Anhängen lesen
• Nachrichten verwalten – Flags setzen, Mails verschieben und löschen

Typische Einsatzfälle: E-Mail-Eingänge überwachen, Tickets oder Bestellungen automatisch auslesen, Anhänge sichern, Postfächer aufräumen.

Einrichtung

Erstelle eine Instanz im Plug-in-Manager und trage die Zugangsdaten ein:

Feld	Bedeutung
Host	IMAP-Server, z. B. imap.example.com (Pflicht)
User	E-Mail-Benutzername (Pflicht)
Password	Passwort des Postfachs (Pflicht)
Port	IMAP-Port, Standard 993
Use TLS	Ob TLS verwendet wird (Standard: ja)
Verify TLS certificate	Ob das TLS-Zertifikat geprüft wird (Standard: ja)

Die Einstellungen (Standard-Mailbox, Ergebnis-Limits, maximale Größe für Inhalte und Anhänge) haben sinnvolle Voreinstellungen und passen für die meisten Fälle.

Tools

Verbindung

Tool	Funktion
imap_ping	Verbindet sich, meldet sich an und zeigt Server-Daten (Begrüßung, Fähigkeiten, Nachrichtenanzahl der Standard-Mailbox).

Lesen

Tool	Funktion
imap_list_mailboxes	Listet alle Mailboxen/Ordner mit Flags und Trennzeichen.
imap_list_messages	Listet Nachrichten einer Mailbox (Absender, Betreff, Datum, Flags, Größe). Auswahl per Nachrichten-IDs, Datumsbereich oder „die neuesten N“.
imap_read	Liest eine Nachricht: Kopfzeilen, Text- und HTML-Body sowie Anhangs-Metadaten. Mit attachments=true kommen auch die Base64-Inhalte der Anhänge.
imap_search	Sucht Nachrichten (nach Absender, Empfänger, Betreff, Text, Datum oder Flag-Status) und liefert die passenden Nachrichten-IDs.

Verwalten

Tool	Funktion
imap_set_flags	Setzt, entfernt oder ändert Flags (z. B. gelesen, markiert, beantwortet, gelöscht).
imap_move	Verschiebt Nachrichten in eine andere Mailbox.
imap_delete	Markiert Nachrichten als gelöscht und löscht sie endgültig aus der Mailbox.

Typische Arbeitsabläufe

Postfach im Blick behalten

1. imap_ping – Verbindung und Anmeldung prüfen.
2. imap_list_mailboxes – Ordnerstruktur verstehen.
3. imap_list_messages – die neuesten Nachrichten des Posteingangs ansehen.

Eine bestimmte Mail finden und lesen

1. imap_search – z. B. mit from (Absender) oder subject (Schlagwort) suchen.
2. imap_read mit der gefundenen Nachrichten-ID – Inhalt und Anhänge abrufen.
3. Nach der Lektüre optional imap_set_flags mit seen, falls die Mail als gelesen markiert werden soll.

Posteingang aufräumen

1. imap_list_messages – alte oder unerwünschte Mails finden.
2. imap_move – Mails in ein Archiv-Ordner verschieben statt zu löschen.
3. Nur für wirklich unerwünschte Mails imap_delete verwenden (löscht endgültig).

Anhänge sichern

1. imap_search – die passende Mail finden.
2. imap_read mit attachments=true – Anhänge als Base64 abrufen.
3. Inhalt dekodieren und z. B. mit dem SFTP- oder Datei-Plug-in ablegen.

Hinweise für KI-Agenten

• Lesen markiert nicht automatisch als gelesen: imap_read verwendet BODY.PEEK – nur mit markSeen=true wird die Mail als gelesen markiert.
• Löschen ist endgültig: imap_delete expungiert die Nachrichten unwiderruflich. Bei Unsicherheit lieber imap_move in einen Archiv-Ordner verwenden.
• Limits beachten: Umfangreiche Inhalte (Text/HTML) und Anhänge sind auf die Instanz-Einstellungen begrenzt – gemeldete Truncations bedeuten, dass der Inhalt gekürzt wurde.
• Nachrichten-IDs (uids) sind mailbox-spezifisch: Sie gelten nur in der Mailbox, in der sie ermittelt wurden – imap_search und imap_list_messages immer auf derselben Mailbox ausführen, die später gelesen wird.