Guide

Outlook CLI: E-Mails im Terminal auflisten (ohne Graph API)

Verwenden Sie ein Outlook-CLI, um Microsoft-365-E-Mails im Terminal zu lesen, suchen und filtern. Der direkte Graph-API-Weg erfordert Azure-AD-App-Registrierung, MSAL-Tokens, Berechtigungen und Retry-Logik. Nylas CLI erledigt dieses Setup hinter einem Befehl und nutzt denselben Workflow für Gmail, Exchange, Yahoo, iCloud und IMAP.

Written by Nick Barraclough Product Manager

Reviewed by Qasim Muhammad

Verified — CLI 3.1.1 · Outlook.com, Microsoft 365 · last tested April 11, 2026

Wie verwendet man ein Outlook-CLI zum Lesen von E-Mails im Terminal?

Verwenden Sie nylas email list, nylas email search und nylas email read nach dem Verbinden Ihres Outlook- oder Microsoft-365-Postfachs. Das CLI bietet Ihnen einen Terminal-Outlook-Workflow ohne Registrierung einer Azure-AD-App oder Schreiben von Microsoft-Graph-API-Code.

Für einen Outlook-E-Mail-Kommandozeilen-Workflow bedeutet das einen einzigen Befehlssatz zum Auflisten, Suchen und Lesen von E-Mails über Outlook.com- und Microsoft-365-Konten hinweg.

Microsoft 365 hat über 400 Millionen bezahlte Plätze, laut Microsofts FY2024-Geschäftsbericht. Es ist die weltweit am häufigsten eingesetzte geschäftliche E-Mail-Plattform. Dennoch erfordert das Lesen des eigenen Posteingangs von der Kommandozeile erstaunlich viel Einrichtung.

Die Graph API ist der einzige unterstützte Weg, seit Microsoft Basic Auth für Exchange Online im Oktober 2022 eingestellt hat. Für einen einzigen GET /me/messages-Aufruf müssen Sie eine App in Azure AD registrieren, Mail.Read-Berechtigungen konfigurieren, MSAL-Token-Beschaffung mit Refresh-Handling implementieren und Microsofts proprietäres JSON-Format (nicht Standard-MIME) parsen. Laut Microsofts Graph-API-Throttling-Richtlinie ist jedes Postfach auf 10.000 Anfragen pro 10 Minuten begrenzt — Sie brauchen also auch Retry-Logik für 429-Antworten.

EWS (Exchange Web Services) existiert noch, aber Microsoft hat die Einstellung für Exchange Online im Oktober 2026 angekündigt (Ankündigung MC862873). Das az-CLI hat keine E-Mail-Befehle. PowerShells Get-MailboxFolderPermission erfordert Exchange-Online-Verwaltungsmodule und Admin-Zugriff. Keines davon bietet einen sauberen, portablen Workflow.

1. Installation und Authentifizierung

Die Installation von Nylas CLI und die Verbindung eines Outlook-Kontos dauert unter 2 Minuten. Das CLI authentifiziert sich über API-Schlüssel, sodass Sie keine Azure-AD-App registrieren, MSAL konfigurieren oder Token-Refresh selbst handhaben müssen. Ein brew install-Befehl und eine API-Schlüssel-Eingabe bringt Sie von null zum E-Mail-Auflisten.

Homebrew ist der schnellste Installationspfad auf macOS und Linux. Die Formel zieht die neueste Release-Binary und prüft deren SHA-256-Prüfsumme automatisch.

# Installation via Homebrew (macOS / Linux)
brew install nylas/nylas-cli/nylas

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

Nach der Installation gehen Sie zu dashboard-v3.nylas.com, erstellen eine Anwendung und verbinden Ihr Microsoft-365- oder Outlook.com-Konto. Das Dashboard übernimmt OAuth2-Einwilligung und Token-Speicherung. Konfigurieren Sie dann das CLI mit Ihrem API-Schlüssel:

nylas auth config
# API-Schlüssel bei Aufforderung einfügen

nylas auth whoami
# => Authenticated as you@company.com (Microsoft)

2. E-Mails auflisten, suchen und lesen

Nylas CLI bietet drei E-Mail-Unterbefehle — list, search und read — die denselben Funktionsumfang wie 8 verschiedene Graph-API-Endpunkte abdecken. Jeder Befehl liefert Ergebnisse in unter 1 Sekunde für typische Postfächer. Der list-Befehl zeigt standardmäßig aktuelle Nachrichten, während search Stichwort-, Absender- und Datumsbereichsfilter akzeptiert, die auf Outlooks serverseitigem Suchindex basieren.

Die folgenden Beispiele zeigen gängige Muster zum Auflisten, Filtern und Lesen von Outlook-E-Mails. Das --limit-Flag steuert die Anzahl der Ergebnisse, und --unread beschränkt die Ausgabe auf ungelesene Nachrichten.

# Aktuelle E-Mails
nylas email list
nylas email list --limit 10
nylas email list --unread

# Suche nach Stichwort, Absender oder Datumsbereich
nylas email search "quarterly report" --limit 5
nylas email search "from:manager@company.com"
nylas email search "after:2026-01-01 before:2026-02-01"

# Bestimmte Nachricht lesen (IDs aus der Listenausgabe)
nylas email read msg_abc123
nylas email read msg_abc123 --mime

3. JSON-Ausgabe für Skripting

Jeder Nylas-CLI-E-Mail-Befehl akzeptiert ein --json-Flag, das normalisiertes JSON statt der Standard-Tabellenansicht ausgibt. Dieses JSON-Format ist über alle 6 unterstützten Anbieter konsistent — Gmail, Outlook, Exchange, Yahoo, iCloud und IMAP — sodass Skripte, die für einen Anbieter geschrieben wurden, bei einem anderen unverändert funktionieren. Die Ausgabe lässt sich direkt in jq, Shell-Skripte oder KI-Agent-Tool-Use-Flows pipen.

Die folgenden Beispiele zeigen drei gängige Skripting-Muster: Zählen ungelesener Nachrichten, Extrahieren von Betreffzeilen und Herausfiltern automatisierter Benachrichtigungen von Microsoft Teams und SharePoint. Microsoft-365-Konten erhalten typischerweise 15-30 automatisierte Benachrichtigungs-E-Mails pro Tag allein von Teams, was programmatisches Filtern für Posteingang-Analysen nützlich macht.

# Ungelesene E-Mails zählen
nylas email list --unread --json | jq length

# Betreffzeilen extrahieren
nylas email list --limit 5 --json | jq '.[].subject'

# Teams/SharePoint-Benachrichtigungen filtern
nylas email list --json \
  | jq '[.[] | select(.from[0].email | test("teams|sharepoint"; "i"))]' \
  | jq length

4. Fokussierter Posteingang vs. Sonstige

Outlooks Fokussierter Posteingang nutzt Machine Learning, um wichtige Nachrichten von weniger wichtigen zu trennen, und Microsoft berichtet, dass er die für E-Mail-Triage aufgewendete Zeit bei aktiven Nutzern um bis zu 50 % reduziert. Die Graph API stellt diese Klassifizierung über die inferenceClassification-Eigenschaft bereit, aber der Zugriff erfordert einen separaten $filter-Parameter und bildet sich nicht auf einen Standardordner ab. Nylas CLI stellt Outlooks Ordnerstruktur direkt bereit, sodass Sie Nachrichten aus jedem Ordner auflisten können, einschließlich Fokussiert, Posteingang, Gesendete Elemente und Junk-E-Mail.

Der Befehl nylas email folders list zeigt jeden Ordner im Postfach, einschließlich Systemordner, die Outlook automatisch erstellt. Das --folder-Flag bei nylas email list filtert die Ergebnisse auf einen einzelnen Ordner nach Name.

# Alle Ordner auflisten — Fokussierter Posteingang als Ordnerattribut
nylas email folders list

# E-Mails in bestimmten Outlook-Ordnern auflisten
nylas email list --folder "Inbox"
nylas email list --folder "Sent Items"
nylas email list --folder "Archive"
nylas email list --folder "Junk Email"
nylas email list --folder "Drafts"

5. Geteilte Postfächer und delegierter Zugriff

Geteilte Postfächer sind ein gängiges Muster in Microsoft-365-Organisationen — Microsofts eigene Dokumentation schätzt, dass der durchschnittliche Enterprise-Mandant 5-10 geteilte Postfächer für Team-Aliase wie support@ oder billing@ hat. Der Zugriff auf ein geteiltes Postfach über die Graph API erfordert GET /users/{id}/messages mit Mail.Read.Shared-Berechtigungen und Admin-Einwilligung des Mandanten. Nylas CLI vereinfacht dies, indem jedes geteilte Postfach als separater Grant behandelt wird, sodass Sie mit denselben Befehlen zwischen persönlichen und geteilten Postfächern wechseln.

Verbinden Sie das geteilte Postfach als separaten Grant im Nylas-Dashboard. Verwenden Sie dann nylas auth list, um alle verbundenen Postfächer zu sehen, und übergeben Sie die Grant-ID an jeden E-Mail-Befehl. Delegierter Zugriff funktioniert genauso.

# Grants auflisten, um alle verbundenen Postfächer zu sehen
nylas auth list

# Mit geteiltem Postfach arbeiten (als separater Grant verbunden)
nylas email list <shared-mailbox-grant-id>

6. Outlook-Kategorien und Flags

Outlook unterstützt bis zu 25 farbcodierte Kategorien und Nachverfolgungs-Flags pro Nachricht — Funktionen, die in Gmail oder Yahoo Mail kein Äquivalent haben. Kategorien sind laut Microsofts Produktivitätsforschung eine der meistgenutzten Organisationsfunktionen in Enterprise-Outlook-Bereitstellungen. Die Graph API gibt Kategorien als String-Array pro Nachrichtenobjekt zurück, aber das Filtern nach Kategorie erfordert das Erstellen eines OData-$filter-Ausdrucks. Nylas CLI stellt die Kategoriefilterung über seine Suchsyntax bereit.

Der Suchbefehl akzeptiert Kategorienamen direkt. Sie können Kategoriefilter auch mit Absender- und Stichwortabfragen kombinieren oder JSON-Ausgabe über jq für benutzerdefinierte kategoriebasierte Berichte pipen.

# E-Mails mit bestimmter Kategorie suchen
nylas email search "category:Red"

# Kategorie mit anderen Filtern kombinieren
nylas email search "category:Blue from:cfo@company.com" --limit 10

# Kategorisierte E-Mails als JSON für Berichte exportieren
nylas email list --json | jq '[.[] | select(.categories[]? == "Project Alpha")]'

7. Microsoft Graph API vs Nylas CLI

Die Microsoft Graph API erfordert mindestens 40 Zeilen Code und 4 separate Konfigurationsschritte zum Auflisten von E-Mails aus einem Outlook-Postfach. Nylas CLI reduziert das auf einen einzigen Befehl ohne Anwendungscode. Die folgende Tabelle vergleicht jeden Schritt Seite an Seite, wobei die Graph-API-Details aus der Microsoft-Learn-Dokumentation für den /me/messages-Endpunkt stammen.

SchrittMicrosoft Graph APINylas CLI
App registrierenAzure-AD-App-Registrierung (portal.azure.com)Nicht erforderlich
BerechtigungenMail.Read-Scope + Admin-Einwilligung für Org-KontenVom Nylas-Dashboard gehandhabt
Auth-FlowMSAL-Bibliothek, Token-Beschaffung, Refresh-Handlingnylas auth config
CodeREST-Aufrufe oder MS Graph SDK — mindestens 40+ ZeilenKein Code
E-Mails auflistenGET /me/messages mit Bearer-Tokennylas email list
AntwortformatMicrosoft-proprietäres JSON (nicht MIME)Normalisiertes JSON über alle Anbieter
Paginierung@odata.nextLink manuell folgen--limit-Flag
Suche$search oder $filter OData-Parameternylas email search "query"
Rate-Limits10.000 Anfragen / 10 Min. pro Postfach — 429er selbst behandelnAutomatisch mit Backoff gehandhabt
Geteilte PostfächerMail.Read.Shared + Admin-EinwilligungSeparater Grant, gleiche Befehle

8. Microsoft-365-Bereitstellungshinweise

Microsoft-365-Mandanten haben organisationsweite Richtlinien, die beeinflussen können, wie externe Tools auf Postfächer zugreifen. Diese Richtlinien gelten für alle 400+ Millionen bezahlten Plätze und variieren je nach Branche erheblich — Gesundheitswesen und Behörden erzwingen striktere bedingte Zugriffsrichtlinien als die meisten kommerziellen Bereitstellungen. Die folgenden Punkte gelten speziell für Microsoft 365 und nicht für persönliche Outlook.com-Konten.

  • Richtlinien für bedingten Zugriff — wenn Ihre Organisation Geräte-Compliance oder IP-Beschränkungen erzwingt, muss Ihr IT-Admin möglicherweise die Nylas-Verbindung auf die Allowlist setzen
  • GCC- und GCC-High-Mandanten — US-Regierungs-Cloud-Mandanten verwenden separate Graph-API-Endpunkte; klären Sie mit Ihrem Admin vor dem Verbinden
  • Aufbewahrungsrichtlinien — Microsoft-365-Compliance-Aufbewahrungsrichtlinien können das Löschen von Nachrichten verhindern, selbst wenn der CLI-Befehl erfolgreich ist. Die Nachricht erscheint nach der Synchronisierung wieder
  • Teams- und SharePoint-Benachrichtigungen — filtern Sie diese mit nylas email search "from:noreply@email.teams.microsoft.com"

Nächste Schritte