Guide

Geben Sie Ihrem KI-Coding-Agent eine E-Mail-Adresse

KI-Coding-Agents können Code schreiben, Tests debuggen und Dateien refaktorisieren — aber sie können keine Deploy-Benachrichtigung senden, keine Bestätigungs-E-Mail lesen und keinen Kalendertermin prüfen. Nylas CLI gibt Claude Code, Cursor, OpenAI Codex CLI und OpenClaw Zugang zu einem echten E-Mail-Konto bei 6 Anbietern — Gmail, Outlook, Exchange, Yahoo, iCloud und IMAP. Eine Authentifizierung, 16 MCP-Tools, Einrichtung in unter 2 Minuten pro Agent.

Written by Caleb Geene Director, Site Reliability Engineering

Reviewed by Hazik

VerifiedCLI 3.1.1 · Gmail, Outlook · last tested April 11, 2026

Warum sollte man einem KI-Coding-Agent eine E-Mail-Adresse geben?

KI-Coding-Agents, die E-Mails lesen und senden können, meistern Aufgaben, die reine Codegenerierung nicht bewältigt -- Deploy-Benachrichtigungen versenden, OTP-Codes aus Anmeldeabläufen extrahieren und Meetings nach Code-Reviews planen. E-Mail verwandelt einen reinen Code-Agent in einen, der mit Menschen und Diensten außerhalb des Repositories interagiert.

Agent-zu-E-Mail-Workflows werden zu einem zentralen Entwickler-Pattern, weil Agents eine dauerhafte Möglichkeit brauchen, Nachrichten mit Menschen, Diensten und anderen Agents auszutauschen. Die meisten Lösungen binden Sie an einen einzigen Anbieter: Gmail-MCP-Server funktionieren nur mit Google, und Microsoft Graph nur mit Outlook. Nylas CLI verbindet sich mit allen 6 großen E-Mail-Anbietern über einen einzigen Authentifizierungsablauf und funktioniert mit jedem MCP-kompatiblen Coding-Agent.

Schritt 1: Registrieren, Konto verbinden und CLI konfigurieren

Bevor Sie einen Agent verbinden, benötigen Sie ein Nylas-Konto mit mindestens einem E-Mail-Grant und die Nylas CLI, die mit Ihrem API-Key authentifiziert ist. Der gesamte Vorbereitungsablauf dauert etwa 2 Minuten und muss nur einmal durchgeführt werden -- jeder Agent, den Sie danach verbinden, verwendet dieselben Anmeldedaten und denselben Grant.

1. Registrieren Sie sich bei Nylas und erstellen Sie einen API-Key

Gehen Sie zu dashboard-v3.nylas.com, erstellen Sie ein kostenloses Konto und generieren Sie unter Settings einen API-Key. Das kostenlose Nylas-Kontingent umfasst bis zu 5 verbundene Konten.

2. Verbinden Sie mindestens ein E-Mail-Konto unter Grants

Gehen Sie im Nylas-Dashboard zu Grants und verbinden Sie ein Gmail-, Outlook-, Exchange-, Yahoo-, iCloud- oder IMAP-Konto. Dies ist die E-Mail-Adresse, die Ihr KI-Agent verwenden wird. Nylas übernimmt den OAuth-Ablauf für Google und Microsoft, sodass Sie keine eigene OAuth-App registrieren müssen.

3. Installieren Sie Nylas CLI und konfigurieren Sie Ihren API-Key

Nylas CLI ist eine einzelne Binärdatei ohne Laufzeitabhängigkeiten. Auf macOS und Linux ist Homebrew die schnellste Installationsmethode. Nach der Installation führen Sie nylas auth config --api-key aus, um Ihren API-Key lokal zu speichern, und verifizieren dann mit nylas auth whoami.

# Installieren (macOS / Linux)
brew install nylas/nylas-cli/nylas

# API-Key konfigurieren
nylas auth config --api-key YOUR_NYLAS_API_KEY

# Verbindung verifizieren
nylas auth whoami

Unter Windows oder für Shell-Script- und Go-Installationen siehe den Erste-Schritte-Guide.

Ersetzen Sie YOUR_NYLAS_API_KEY durch den Key aus dem Nylas-Dashboard. Laut der Nylas-MCP-Dokumentation erhält Ihr Agent damit Zugriff auf 16 E-Mail-, Kalender- und Kontakt-Tools bei allen 6 Anbietern.

Schritt 2a: Geben Sie Claude Code eine E-Mail-Adresse

Claude Code unterstützt MCP nativ, sodass die Verbindung mit einem echten E-Mail-Konto nur einen Befehl erfordert. Nylas CLI schreibt die MCP-Server-Konfiguration und genehmigt alle 16 Tools in der Settings-Datei von Claude Code vorab, wodurch die einzelnen Berechtigungsabfragen entfallen, die sonst jede E-Mail-Aktion unterbrechen würden.

Der Befehl nylas mcp install zielt direkt auf die Konfigurationsdateien von Claude Code. Er fügt einen Server-Eintrag in ~/.claude.json und eine Wildcard-Berechtigung für mcp__nylas__* in ~/.claude/settings.json hinzu.

# MCP für Claude Code installieren
nylas mcp install --assistant claude-code

Starten Sie Claude Code nach diesem Befehl neu, damit der neue MCP-Server erkannt wird. Alle 16 Nylas-Tools sind ohne interaktive Abfragen vorab genehmigt. Probieren Sie diese natürlichsprachlichen Anfragen:

  • "Lies meine letzten 5 E-Mails"
  • "Sende eine E-Mail an alice@example.com über das Deploy"
  • "Prüfe meinen Kalender für morgen"

Für den vollständigen MCP-Deep-Dive -- verfügbare Tools, regionale Endpunkte, Zeitzonen-Handling -- siehe den AI Agent Email Access via MCP-Guide.

Schritt 2b: Geben Sie Cursor eine E-Mail-Adresse

Cursor unterstützt MCP nativ, und Nylas CLI konfiguriert es mit einem einzigen Befehl. Cursor bietet zwei Verbindungsmethoden: einen lokalen STDIO-Server über die CLI oder einen gehosteten HTTP-Endpunkt, der die CLI komplett umgeht. Beide Methoden stellen Cursors Agent-Modus die gleichen 16 Tools zur Verfügung.

Die lokale Methode führt nylas mcp install --assistant cursor aus, was einen Server-Eintrag in ~/.cursor/mcp.json schreibt. Der CLI-Prozess läuft als lokaler STDIO-Server und übernimmt alle API-Aufrufe an Nylas.

# MCP für Cursor installieren
nylas mcp install --assistant cursor

Starten Sie Cursor nach der Installation neu, öffnen Sie die Einstellungen und prüfen Sie unter Tools & MCP, ob neben "nylas" ein grüner Punkt angezeigt wird.

Alternative: Gehosteter MCP-Server (keine CLI-Installation nötig). Cursor unterstützt auch streamfähige HTTP-MCP-Server. Diese Methode verbindet sich direkt mit dem Nylas-MCP-Endpunkt unter mcp.us.nylas.com, ohne dass ein lokaler CLI-Prozess benötigt wird. Fügen Sie dies zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "nylas": {
      "type": "streamable-http",
      "url": "https://mcp.us.nylas.com",
      "headers": {
        "Authorization": "Bearer YOUR_NYLAS_API_KEY"
      }
    }
  }
}

Ersetzen Sie YOUR_NYLAS_API_KEY durch Ihren API-Key aus dem Nylas-Dashboard. Damit wird der lokale CLI-Proxy komplett umgangen. Die Nylas-MCP-Dokumentation behandelt beide Methoden.

Schritt 2c: Geben Sie OpenAI Codex CLI eine E-Mail-Adresse

OpenAI Codex CLI unterstützt MCP-Server nativ und bietet drei Verbindungsmethoden: lokales STDIO über Nylas CLI, einen gehosteten HTTP-Endpunkt oder direkte Shell-Befehle ohne MCP. Laut der OpenAI Codex MCP-Dokumentation startet Codex MCP-Server automatisch beim Sitzungsstart, sodass kein manueller Prozess weiterlaufen muss.

Option A: Lokales MCP über Nylas CLI

Der Befehl codex mcp add registriert Nylas als lokalen STDIO-Server. Codex speichert dies in ~/.codex/config.toml und startet den Server-Prozess zu Beginn jeder Sitzung.

# Nylas als MCP-Server hinzufügen (STDIO)
codex mcp add nylas -- nylas mcp serve

Dies fügt einen [mcp_servers.nylas] Eintrag in ~/.codex/config.toml hinzu. Die resultierende Konfiguration sieht so aus:

# ~/.codex/config.toml
[mcp_servers.nylas]
command = "nylas"
args = ["mcp", "serve"]

Option B: Gehosteter MCP-Server (keine CLI-Installation)

Die gehostete Methode verbindet Codex direkt mit dem Nylas-MCP-Endpunkt über HTTP und umgeht den lokalen CLI-Prozess komplett. Codex liest das Bearer-Token aus einer Umgebungsvariable, sodass der API-Key nie in der Konfigurationsdatei selbst erscheint. Fügen Sie den Server-Eintrag zu ~/.codex/config.toml hinzu und setzen Sie die Umgebungsvariable NYLAS_API_KEY in Ihrem Shell-Profil.

# ~/.codex/config.toml
[mcp_servers.nylas]
url = "https://mcp.us.nylas.com"
bearer_token_env_var = "NYLAS_API_KEY"
# Umgebungsvariable setzen
export NYLAS_API_KEY="your-api-key-here"

Option C: Shell-Befehle (ohne MCP)

Codex kann Nylas-CLI-Befehle auch direkt in seiner Sandbox-Shell ohne MCP ausführen. Jeder Befehl wird in der Codex-Sandbox ausgeführt, die vor der Ausführung eine Benutzerbestätigung erfordert -- ein manueller Bestätigungsschritt für jede Aktion. Die CLI-Befehle liefern standardmäßig Klartext oder strukturiertes JSON mit dem Flag --json, das Codex für weitere Schlussfolgerungen parsen kann.

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

# Nach bestimmten E-Mails suchen
nylas email search "deploy notification"

# Eine E-Mail senden
nylas email send --to alice@example.com --subject "Deploy complete" --body "v2.4.1 is live."

# JSON-Ausgabe für strukturiertes Parsen
nylas email list --limit 5 --json

Zum Erstellen strukturierter Tool-Definitionen mit Shell-Befehlen siehe Build an LLM Agent with Email Tools.

Schritt 2d: Geben Sie OpenClaw eine E-Mail-Adresse

OpenClaw verwendet ein Plugin-System anstelle von MCP, daher unterscheidet sich die Einrichtung von den anderen 4 Agents. Das Nylas-Plugin gibt OpenClaw native E-Mail-, Kalender- und Kontakt-Tools mit typisierten Schemas und Multi-Account-Unterstützung. Die Installation umfasst 6 Befehle: Plugin installieren, freigeben, API-Key konfigurieren, Gateway neu starten und verifizieren.

Das Plugin-System erfordert eine explizite Trust-Konfiguration. Nach der Installation des Plugin-Pakets müssen Sie "nylas" sowohl zu plugins.allow als auch zu tools.alsoAllow hinzufügen, damit OpenClaw die Tools für Agent-Sitzungen bereitstellt. Der Gateway-Neustart stellt sicher, dass die neue Plugin-Konfiguration geladen wird.

# Nylas-Plugin installieren
openclaw plugins install @nylas/openclaw-nylas-plugin

# Plugin freigeben und Tools für Agent-Sitzungen bereitstellen
openclaw config set 'plugins.allow' '["nylas"]'
openclaw config set 'tools.alsoAllow' '["nylas"]'

# API-Key konfigurieren
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# Gateway neu starten, damit die Plugin-Konfiguration geladen wird
openclaw gateway restart

# Prüfen, ob das Plugin die verbundenen Konten sieht
openclaw plugins list
openclaw run "List my connected email accounts" --plugin nylas

Nach der Installation kann OpenClaw E-Mails senden, Threads lesen, Kalendertermine verwalten und Kontakte durchsuchen -- alles in natürlicher Sprache. Das Plugin erkennt automatisch alle verbundenen E-Mail-Konten aus dem Nylas-Dashboard -- keine Konfiguration pro Konto nötig.

Vollständige Einrichtungsdetails finden Sie im Install the OpenClaw Nylas Plugin Guide. Neu bei OpenClaw? Starten Sie mit dem OpenClaw CLI Setup Guide.

Vergleich: E-Mail-Einrichtung bei KI-Coding-Agents

Fünf KI-Coding-Agents können sich über Nylas mit E-Mail verbinden, und jeder verwendet eine andere Konfigurationsdatei und Integrationsmethode. Vier davon -- Claude Code, Cursor, Codex CLI und Windsurf -- verbinden sich via MCP über einen lokalen STDIO-Server oder einen gehosteten HTTP-Endpunkt. OpenClaw verbindet sich über sein eigenes Plugin-System. Die Tabelle fasst den Einrichtungsbefehl und den Konfigurationsort für jeden Agent zusammen.

KI-Coding-AgentIntegrationEinrichtungsbefehlKonfigurationsdatei
Claude CodeMCP (STDIO)nylas mcp install --assistant claude-code~/.claude.json
CursorMCP (STDIO oder HTTP)nylas mcp install --assistant cursor~/.cursor/mcp.json
OpenAI Codex CLIMCP (STDIO oder HTTP)codex mcp add nylas -- nylas mcp serve~/.codex/config.toml
WindsurfMCP (STDIO)nylas mcp install --assistant windsurfWindsurf-Konfiguration
OpenClawPluginopenclaw plugins install @nylas/openclaw-nylas-pluginOpenClaw Plugin Registry

Alle fünf Agents erhalten die gleichen 16 E-Mail-, Kalender- und Kontakt-Tools. MCP-Agents (Claude Code, Cursor, Codex, Windsurf) verbinden sich über den Nylas-MCP-Server. OpenClaw verbindet sich über sein Plugin-System. Jede Methode unterstützt alle 6 E-Mail-Anbieter: Gmail, Outlook, Exchange, Yahoo, iCloud und IMAP.

Was Ihr Agent mit E-Mail-Zugang tun kann

Ein KI-Coding-Agent mit E-Mail-Zugang kann 6 Aufgabenkategorien bewältigen, die sonst einen Wechsel zum Mail-Client erfordern würden: Benachrichtigungen senden, Bestätigungen lesen, OTP-Codes extrahieren, Meetings planen, E-Mail-Verlauf durchsuchen und Antworten entwerfen. Alle 16 MCP-Tools funktionieren mit natürlichsprachlichen Anweisungen -- keine Flags oder Befehlssyntax erforderlich.

  • Deploy-Benachrichtigung senden -- "Sende dem Team eine E-Mail, dass v2.4.1 auf Produktion live ist"
  • Bestätigungs-E-Mail lesen -- "Prüfe meinen Posteingang auf die AWS-Registrierungsbestätigung"
  • OTP-Code extrahieren -- "Hole den 6-stelligen Verifizierungscode aus meiner letzten E-Mail" (siehe Email as Identity for AI Agents)
  • Meeting planen -- "Buche einen 30-Minuten-Call mit alice@company.com nächsten Dienstag um 14 Uhr"
  • E-Mail-Verlauf durchsuchen -- "Finde alle E-Mails zum Q4-Vertrag und fasse die wichtigsten Entscheidungen zusammen"
  • Antwort entwerfen -- "Erstelle einen Antwortentwurf auf Sarahs Budgetfrage mit den aktualisierten Zahlen"

Sicherheit und Zugriffskontrolle

Die Vergabe von E-Mail-Zugang an einen KI-Agent erfordert Schutzmaßnahmen, um unbeabsichtigten Versand und unautorisierten Datenzugriff zu verhindern. Nylas CLI und MCP erzwingen ein 2-Schritte-Versandmuster: Der Agent erstellt zuerst einen Entwurf, dann genehmigt ein separater Bestätigungsschritt den Versand, bevor eine E-Mail das Konto verlässt. Dieses Muster gilt für alle 5 unterstützten Agents und deckt 100 % der ausgehenden E-Mail-Aktionen ab.

  • Sendebestätigung erforderlich. MCP-Tools erfordern einen confirm_send_draft-Schritt, bevor eine E-Mail tatsächlich gesendet wird. Ihr Agent erstellt zuerst einen Entwurf, den Sie dann freigeben.
  • Lokale Speicherung der Anmeldedaten. Nylas CLI speichert OAuth-Tokens auf Ihrem Rechner. Sie verlassen Ihr System nur, wenn Sie einen Befehl ausführen.
  • Sandbox-Ausführung. Codex CLI führt Shell-Befehle in einer Sandbox mit Benutzerbestätigung für jede Aktion aus.
  • Jederzeit widerrufbar. Führen Sie nylas auth logout zum Trennen aus, oder nylas auth list, um verbundene Konten anzuzeigen.

Für vollständiges Audit-Logging aller Aktionen, die Ihre KI-Agents mit E-Mail ausführen, siehe den Audit AI Agent Activity-Guide.

Nächste Schritte

Mit konfiguriertem E-Mail-Zugang sind die natürlichen Folgeschritte: Schutzmaßnahmen einrichten, um zu kontrollieren, was der Agent senden kann, Agent-Aktivitäten für Compliance prüfen und benutzerdefinierte Agent-Workflows in Python oder TypeScript erstellen. Die hier aufgeführten Guides decken den gesamten Lebenszyklus ab -- vom ersten E-Mail-Zugang bis zur produktionsreifen Agent-E-Mail-Infrastruktur.