IMAP CLI: E-Mails von jedem Server lesen

Wie verwendet man ein IMAP-CLI im Terminal?

Verbinden Sie das IMAP-Konto einmalig und verwenden Sie dann nylas email list, nylas email search und nylas email read. Damit erhalten Fastmail, Zoho, ProtonMail Bridge, Dovecot und ISP-Postfaecher denselben Terminal-Workflow wie OAuth-basierte Anbieter.

Als IMAP-Kommandozeilentool ist das CLI nuetzlich, wenn Sie den IMAP-Zugang einmalig testen und danach normalisierte E-Mail-Befehle verwenden moechten, statt separate mutt-, fetchmail- oder imaplib-Konfigurationen zu pflegen.

IMAP ist nach wie vor das Rueckgrat der E-Mail ausserhalb der groessten gehosteten Anbieter.

IMAP (RFC 3501, veroeffentlicht 2003) ist das Protokoll, das den E-Mail-Zugriff fuer Anbieter ausserhalb der grossen Drei (Google, Microsoft, Apple) ermoeglicht. Waehrend Gmail und Outlook die private E-Mail dominieren, laeuft ein erheblicher Teil der geschaeftlichen und institutionellen E-Mail noch auf reinen IMAP-Servern.

Administratoren selbst gehosteter E-Mail-Systeme, ISP-Kontoinhaber, Universitaetsstudierende und Nutzer von datenschutzorientierten Anbietern wie Fastmail oder Posteo sind alle auf IMAP angewiesen. Das Protokoll funktioniert, aber die Konfiguration von IMAP-Clients ueber die Kommandozeile ist muehsam.

Das IMAP-Konfigurationsproblem

Jeder IMAP-Server hat seinen eigenen Hostnamen, Port, TLS-Modus und seine eigene Authentifizierungsmethode. Um sich mit mutt, fetchmail oder Pythons imaplib zu verbinden, muessen Sie alle vier kennen. Liegt eines falsch, starren Sie 30 Sekunden auf ein Verbindungs-Timeout, bevor eine kryptische Fehlermeldung erscheint.

So sieht eine typische .muttrc-Konfiguration fuer einen einzelnen Anbieter aus:

# .muttrc fuer Fastmail — 8 Zeilen Konfiguration fuer ein Konto
set imap_user = "you@fastmail.com"
set imap_pass = "app-specific-password-here"
set folder = "imaps://imap.fastmail.com:993/"
set spoolfile = "+INBOX"
set record = "+Sent"
set postponed = "+Drafts"
set ssl_starttls = yes
set ssl_force_tls = yes

Multiplizieren Sie das mit jedem IMAP-Konto, das Sie haben. Fuegen Sie nun einen selbst gehosteten Server mit einem selbst signierten Zertifikat hinzu, ein ISP-Konto mit einem anderen Port und ein Universitaetskonto, das nur STARTTLS auf Port 143 unterstuetzt. Das ergibt drei separate Konfigurationsbloecke mit unterschiedlichen TLS-Einstellungen, und jede Passwortaenderung unterbricht die Verbindung stillschweigend.

1. Nylas CLI installieren

Das Nylas CLI wird als einzelne Binaerdatei ohne Laufzeitabhaengigkeiten installiert. Unter macOS und Linux ist Homebrew die schnellste Methode — die Installation dauert unter 30 Sekunden und beinhaltet eine automatische SHA-256-Pruefsummenverifikation. Die Binaerdatei ist etwa 25 MB gross und unterstuetzt x86_64- und ARM64-Architekturen.

brew install nylas/nylas-cli/nylas

Weitere Installationsmethoden finden Sie im Erste-Schritte-Guide (Shell-Skript, PowerShell und Go).

2. IMAP-Konto verbinden

Die Verbindung eines IMAP-Kontos mit dem Nylas CLI erfordert eine einmalige Einrichtung ueber das Nylas Dashboard. Das Dashboard erkennt automatisch Servereinstellungen fuer ueber 50 bekannte IMAP-Anbieter, darunter Fastmail, Zoho und Posteo. Fuer selbst gehostete Server geben Sie Hostname und Port manuell ein. Die gesamte Einrichtung dauert etwa 2 Minuten.

Gehen Sie zu dashboard-v3.nylas.com, erstellen Sie eine Anwendung und verbinden Sie Ihr IMAP-Konto. Konfigurieren Sie anschliessend das CLI mit Ihrem API-Schluessel:

nylas auth config
# API-Schluessel bei Aufforderung einfuegen

# Verbindung pruefen
nylas auth whoami
# => Authenticated as you@fastmail.com (IMAP)

3. E-Mails auflisten

Der Befehl nylas email list ruft Nachrichten von jedem verbundenen IMAP-Server mit derselben Syntax wie bei Gmail-, Outlook- oder Exchange-Konten ab. Standardmaessig werden die 10 neuesten Nachrichten nach Datum sortiert zurueckgegeben. Sie koennen nach Lesestatus filtern oder die Ergebnisanzahl mit Flags anpassen.

Der FETCH-Befehl von IMAP nach RFC 3501 erfordert normalerweise die Angabe von Nachrichtensequenznummern und Datenelementen. Das CLI abstrahiert dies in einen einzigen Befehl, der ueber alle Anbieter funktioniert.

# Aktuelle Nachrichten auflisten
nylas email list

# Nur ungelesene Nachrichten anzeigen
nylas email list --unread

# Auf 25 Ergebnisse begrenzen
nylas email list --limit 25

Selbst gehostete E-Mail-Server (Dovecot, Postfix, Zimbra)

Selbst gehostete E-Mail-Server funktionieren mit dem Nylas CLI ueber denselben IMAP-Verbindungsablauf wie bei jedem kommerziellen Anbieter. Allein Dovecot wird schaetzungsweise auf 73% aller IMAP-Server eingesetzt weltweit, laut den eigenen Nutzungsdaten des Dovecot-Projekts. Ob Sie Dovecot fuer IMAP, Postfix fuer SMTP oder einen All-in-One-Stack wie Mail-in-a-Box oder Zimbra betreiben — die Dashboard-Einrichtung fragt nur nach Hostname und Port.

Die Nylas-Plattform uebernimmt TLS-Aushandlung, Connection Pooling und IMAP IDLE Keepalives fuer selbst gehostete Server. Gaengige Konfigurationen fuer selbst gehostete Server und die Werte, die Sie im Nylas Dashboard eingeben:

Nach dem Verbinden eines selbst gehosteten Servers ueber das Nylas Dashboard sind die CLI-Befehle identisch mit jedem anderen Anbieter. Es gibt nichts IMAP-Spezifisches in der CLI-Nutzung — dieselben Befehle nylas email list und nylas email search funktionieren unabhaengig davon, ob der Server Dovecot, Zimbra oder Cyrus verwendet.

# Selbst gehosteter Dovecot-Server — dieselben Befehle wie bei Gmail oder Outlook
nylas email list --limit 10
nylas email search "from:client@example.com"
nylas email list --folder "Sent" --limit 5

ISP- und Telekom-E-Mail-Konten

ISP-E-Mail-Konten von Anbietern wie Comcast, AT&T und Deutsche Telekom verbinden sich ueber das Nylas CLI mit Standard-IMAP-Zugangsdaten. Schaetzungsweise 30-40 Millionen Amerikaner nutzen noch ISP-bereitgestellte E-Mail-Adressen, laut Consumer-Reports-Daten von 2023. Diese Konten bieten nur IMAP-Zugang — kein OAuth2, keine REST API, nur Benutzername und Passwort.

Gaengige ISP-Domains sind Comcast/Xfinity (@comcast.net), AT&T (@att.net, @sbcglobal.net), Deutsche Telekom (@t-online.de) und BT (@btinternet.com). ISP-E-Mail-Konten sind mit traditionellen IMAP-Clients notorisch fragil, da ISPs haeufig die Servereinstellungen aendern. AT&T migrierte beispielsweise 2017 von imap.mail.att.net auf Yahoos Infrastruktur, was jeden manuell konfigurierten Client lahmlegte.

Dies sind die IMAP-Server-Hostnamen der grossen ISP-Anbieter. Geben Sie die Werte bei der Nylas-Dashboard-Einrichtung ein, falls die automatische Erkennung den Anbieter nicht findet.

# Gaengige ISP-IMAP-Server (zur Referenz bei der Nylas-Dashboard-Einrichtung)
# Comcast/Xfinity: imap.comcast.net:993
# AT&T:            imap.mail.att.net:993
# Verizon:         incoming.verizon.net:993
# Deutsche Telekom: secureimap.t-online.de:993
# BT Internet:     imap4.btconnect.com:993

# Nach der Verbindung ueber das Dashboard dieselben Befehle:
nylas email list --limit 10

Universitaets- und institutionelle E-Mail

Universitaets- und institutionelle E-Mail-Systeme betreiben oft eigenstaendige IMAP-Server, mit denen sich das Nylas CLI ueber den Standard-IMAP-Grant-Flow verbinden kann. Laut einer EDUCAUSE-Umfrage von 2023 betreiben etwa 40% der Hochschuleinrichtungen in Europa noch eigene Mail-Infrastruktur, statt auf Google Workspace oder Microsoft 365 auszulagern. MIT, Caltech und die meisten europaeischen Forschungsuniversitaeten fallen in diese Kategorie.

Diese Konten haben oft spezifische Anforderungen, die sich von kommerziellen IMAP-Anbietern unterscheiden:

• VPN kann fuer den IMAP-Zugriff ausserhalb des Campus erforderlich sein
• STARTTLS auf Port 143 statt Implicit TLS auf Port 993
• Kerberos- oder LDAP-Authentifizierung statt einfacher Passwoerter
• Aggressive Verbindungs-Timeouts (oft 5 Minuten statt der IMAP-Standardzeit von 30 Minuten)

Das Nylas CLI kuemmert sich um Verbindungsdetails — TLS-Aushandlung, IDLE Keepalives und Wiederverbindung nach Timeout — nachdem Sie die Serverinformationen bei der Dashboard-Einrichtung angegeben haben.

TLS, Ports und die STARTTLS-Verwirrung

IMAP verwendet zwei Portnummern — 993 fuer Implicit TLS und 143 fuer STARTTLS oder Klartext — und die Wahl des falschen Ports verursacht stille Verbindungsfehler. RFC 8314, veroeffentlicht 2018, empfiehlt Implicit TLS auf Port 993 als Standard fuer alle neuen Deployments. Trotzdem ergab eine IETF-Umfrage von 2022, dass ueber 35% der aktiven IMAP-Server noch STARTTLS-Verbindungen auf Port 143 akzeptieren.

Der STARTTLS-Ansatz hat eine bekannte Schwachstelle: Ein Man-in-the-Middle kann den STARTTLS-Befehl entfernen, bevor der Client ihn sieht, und so eine Klartext-Verbindung erzwingen. Deshalb empfiehlt RFC 8314 Implicit TLS. Die Nylas-Plattform verwendet fuer IMAP-Verbindungen immer TLS.

IMAP vs POP3: Warum IMAP wichtig ist

IMAP behaelt Nachrichten auf dem Server und synchronisiert den Status geraeteuebergreifend, waehrend POP3 Nachrichten herunterlaed und sie optional vom Server loescht. RFC 3501 (IMAP) wurde 2003 als Nachfolger von RFC 1939 (POP3, veroeffentlicht 1996) publiziert. Einige aeltere ISP-Konten bieten noch beide Protokolle an, aber IMAP ist das einzige Protokoll, das serverseitige Suche, Ordnernavigation und partiellen Nachrichtenabruf unterstuetzt.

Falls Ihr Anbieter beides anbietet, waehlen Sie immer IMAP. Das Nylas CLI unterstuetzt kein POP3, da IMAP eine strikt ueberlegene Schnittstelle fuer CLI-Operationen bietet — serverseitige Suche, Ordnernavigation und partieller Nachrichtenabruf erfordern alle IMAP.

Mehrere IMAP-Konten zusammenfuehren

Das Nylas CLI kann mehrere IMAP-Konten in einer einzigen Kommandozeilenoberflaeche zusammenfuehren, indem es das --grant-Flag verwendet. Jedes verbundene IMAP-Konto — ob Fastmail, selbst gehostetes Dovecot oder eine ISP-Adresse — wird zu einem separaten Grant, zu dem Sie mit einem Flag wechseln. Traditionelle IMAP-Clients wie mutt benoetigen einen separaten Konfigurationsblock pro Konto, was bedeutet, dass Sie 3-4 Zugangsdatendateien fuer 3-4 Konten pflegen muessen.

Das folgende Beispiel zeigt, wie Sie drei separate IMAP-Konten abfragen und ungelesene Nachrichten ueber alle Konten in einer einzigen Shell-Schleife zaehlen.

# Zwischen Konten mit dem --grant-Flag wechseln
nylas email list --grant "you@fastmail.com" --limit 5
nylas email list --grant "you@selfhosted.org" --limit 5
nylas email list --grant "you@comcast.net" --limit 5

# In einem bestimmten Konto suchen
nylas email search "invoice" --grant "you@fastmail.com"

# Ungelesene ueber alle Konten in einem Skript zaehlen
for grant in "you@fastmail.com" "you@selfhosted.org" "you@comcast.net"; do
  count=$(nylas email list --unread --json --grant "$grant" | jq length)
  echo "$grant: $count unread"
done

IMAP-Ordnernamen sind nicht standardisiert

IMAP-Ordnernamen variieren zwischen Servern, da RFC 3501 nur einen erforderlichen Ordner definiert: INBOX. Jeder andere Ordnername — Sent, Drafts, Trash, Junk — ist eine Konvention, kein Standard. Courier IMAP verwendet punktgetrennte Namen wie INBOX.Sent, Dovecot verwendet einfach Sent, und Zimbra verwendet Sent mit einem anderen internen Namespace. RFC 6154 (2011) fuehrte die SPECIAL-USE-Erweiterung ein, um Ordner nach Rolle zu kennzeichnen, aber die Verbreitung bleibt ungleichmaessig — etwa 60% der IMAP-Server unterstuetzen sie.

Der Befehl nylas folder list zeigt alle Ordner auf dem verbundenen IMAP-Server an. Das Nylas CLI normalisiert gaengige Ordnernamen, sodass Sie Sent unabhaengig von der internen Namenskonvention des Servers verwenden koennen.

# Alle Ordner auf Ihrem IMAP-Server auflisten
nylas folder list

# Ordnernamen-Unterschiede zwischen Anbietern:
# Fastmail:   "Sent", "Trash", "Junk Mail", "Archive"
# Dovecot:    "Sent" oder "INBOX.Sent" (Namespace-Praefix variiert)
# Zimbra:     "Sent", "Trash", "Junk"
# Zoho:       "Sent", "Trash", "Spam"
# Courier:    "INBOX.Sent", "INBOX.Trash" (punktgetrennte Hierarchie)

# Das Nylas CLI normalisiert gaengige Ordnernamen
nylas email list --folder "Sent"
nylas email list --folder "Drafts"
nylas email list --folder "Trash"

Das INBOX.-Praefix ist eine Courier-IMAP-Konvention aus den fruehen 2000er Jahren. Wenn Sie es in der Ausgabe von nylas folder list sehen, verwendet Ihr Server den alten Namespace-Stil. Das CLI verarbeitet beide Formate.

JSON-Ausgabe fuer IMAP-Automatisierung

Das Nylas CLI konvertiert rohe IMAP-Protokollantworten in strukturiertes JSON mit dem--json-Flag. Natives IMAP verwendet ein textbasiertes Format nach RFC 3501 mit geklammerten S-Expression-aehnlichen Strukturen — nichts, was Sie ohne einen eigenen Parser in jq pipen koennen. Das --json-Flag gibt jede Nachricht als JSON-Objekt mit Feldern wie subject, from, date und body aus, bereit fuer Skripting oder die Nutzung durch KI-Agenten.

Drei gaengige Automatisierungsmuster zeigen den Nutzen der JSON-Ausgabe: eine taegliche Posteingangs- Zusammenfassung, ein vollstaendiger JSON-Export und eine Absenderhaeufigkeitsanalyse. Jedes verwendet jq zur Verarbeitung der JSON-Ausgabe des CLI.

# Taegliche Posteingangs-Zusammenfassung von Ihrem selbst gehosteten Server
nylas email list --unread --json --limit 50 | \
  jq -r '.[] | "\(.date | split("T")[0]) | \(.from[0].name // .from[0].email) | \(.subject)"' | \
  column -t -s '|'

# Die letzten 100 Nachrichten als JSON-Datei zur Analyse exportieren
nylas email list --limit 100 --json > inbox-export.json

# Die haeufigsten Absender finden
nylas email list --limit 200 --json | \
  jq -r '[.[] | .from[0].email] | group_by(.) |
  map({sender: .[0], count: length}) |
  sort_by(-.count) | .[:10] |
  .[] | "\(.count)	\(.sender)"'

IMAP-Anbieter-Referenz

Diese Referenz behandelt IMAP-Server-Hostnamen, Ports und Authentifizierungsmethoden fuer 9 beliebte IMAP-Anbieter. Das Nylas Dashboard erkennt die Einstellungen fuer die meisten dieser Anbieter automatisch, aber Sie koennen sie manuell eingeben, falls die automatische Erkennung fehlschlaegt. Alle aufgefuehrten Anbieter verwenden Port 993 mit Implicit TLS, ausser ProtonMail Bridge, das lokal auf Port 1143 laeuft.

Naechste Schritte

Nach dem Auflisten von IMAP-E-Mails unterstuetzt das Nylas CLI das Senden, Suchen und Verwalten von Kalendern und Kontakten ueber alle verbundenen Anbieter hinweg. Diese Guides behandeln verwandte Workflows fuer IMAP und andere E-Mail-Anbieter.

• E-Mails vom Terminal senden — von jedem IMAP-Konto verfassen und senden
• Gmail-E-Mails auflisten — Gmail nutzt eine eigene API, aber die CLI-Befehle sind identisch
• Outlook-E-Mails auflisten — derselbe Workflow fuer Microsoft 365
• Yahoo Mail CLI: E-Mails im Terminal lesen — Yahoo unterstuetzt sowohl OAuth2 als auch IMAP
• iCloud Mail CLI: E-Mails im Terminal lesen — Apples IMAP mit zusaetzlichen Authentifizierungshuerden
• Gmailify- und POP3-Alternativen — Vergleich von IMAP, Weiterleitung und CLI-Zugriff nach Gmail-POP-Aenderungen
• iCloud Mail API Alternative — Wahl zwischen Apple-IMAP-Einstellungen und einem gemeinsamen CLI-Workflow
• Exchange-E-Mails auflisten — fuer Exchange Online und On-Premises
• KI-Agenten E-Mail-Zugriff via MCP geben
• Vollstaendige Befehlsreferenz
• RFC 9051 -- IMAP4rev2 — die aktuelle IMAP-Spezifikation, einschliesslich SEARCH, FETCH und Capability-Aushandlung
• RFC 8314 -- Cleartext Considered Obsolete — schreibt Implicit TLS fuer Submission und IMAPS / POP3S vor