KI Mail Agent in Claude Code bauen: Tutorial für Outlook

Ein KI Mail Agent, der jede eingehende Outlook-Mail liest und automatisch einen Antwortentwurf erstellt. Im Vorgängervideo habe ich das mit n8n gebaut. Diesmal mache ich genau denselben Agenten mit Claude Code, weil sich vieles damit einfacher, schneller und flexibler bauen lässt.

Video-Tutorial: KI Mail Agent in Claude Code

Den kompletten Aufbau gibt es als Tutorial auf YouTube. Du siehst Schritt für Schritt, wie der Agent entsteht, wie Outlook angebunden wird und wie der Cron-Trigger die Sache automatisiert.

Warum Claude Code statt n8n?

In n8n baust du den Workflow aus Nodes zusammen. In Claude Code beschreibst du, was passieren soll, und Claude erledigt den Rest. Für viele Fälle ist das deutlich flexibler.

Claude Code ist der KI-Agent von Anthropic, der direkt im Terminal arbeitet. Ich nutze ihn am liebsten in Cursor als Extension. Du kannst Claude Code aber auch alleinstehend verwenden, also als eigenes Programm ohne IDE drumherum.

Outlook über Microsoft Graph anbinden

Die API-Anbindung ist meistens der unangenehme Teil bei jedem Mail-Agenten. Der Agent selbst ist schnell gebaut, aber die Outlook-Verbindung kostet beim ersten Mal mehrere Stunden Recherche. Deshalb hier der Ablauf für Microsoft 365.

Die zuständige Stelle bei Microsoft heißt Entra und liegt unter entra.microsoft.com. Dort verwaltest du alle Apps, die auf deinen Microsoft-Account zugreifen dürfen. Unter App-Registrierungen legst du eine neue App an, in meinem Fall heißt sie Claude Code Demo. Damit bekommt dein Agent eine eigene Identität, mit der er sich später bei Microsoft ausweist.

Nach der Registrierung gibt es auf der Übersichtsseite zwei wichtige IDs: die Anwendungs-ID und die Verzeichnis-ID. Beide kopierst du und gibst sie an Claude Code weiter.

Anschließend sind noch zwei Einstellungen zu setzen. Unter Authentication erlaubst du öffentliche Client Flows. Das ist die Voraussetzung dafür, dass das Device-Code-Login später funktioniert. Unter API-Berechtigungen fügst du zwei delegierte Berechtigungen aus Microsoft Graph hinzu:

• Mail.ReadWrite erlaubt dem Agenten, Mails zu lesen und Entwürfe zu schreiben. Senden gehört explizit nicht dazu, das ist im Tutorial-Kontext genau richtig.
• offline_access sorgt dafür, dass der Token im Hintergrund immer wieder erneuert wird, ohne dass du dich neu anmelden musst.

Sobald die Berechtigungen gespeichert sind, geht es zurück in Claude Code. Du übergibst die beiden IDs, Claude generiert eine URL und einen Code. Du öffnest die URL im Browser, gibst den Code ein, bestätigst den Zugriff für die App. Damit ist die Outlook-Verbindung eingerichtet.

Der erste Testentwurf

Direkt nach der Anbindung holt Claude Code die Mails ab und legt einen ersten Testentwurf in Outlook ab. Im Postfach taucht ein neuer Entwurf auf, klar als Agent-Entwurf markiert. Ab diesem Punkt kannst du theoretisch alles mit Mails machen, was du brauchst: Angebote erzeugen, Standardanfragen beantworten, Mailverläufe zusammenfassen.

Für den eigentlichen Use-Case will ich aber den n8n-Agenten vom letzten Mal nachbauen: Auf jede neue eingehende Mail soll automatisch ein Antwortentwurf entstehen.

Cron-Trigger statt Webhook

Damit der Agent regelmäßig läuft, braucht es einen Trigger. Outlook hat keine sinnvolle Push-Benachrichtigung für sowas, also fragt der Agent selbst im Intervall nach. Das ist das klassische Cron-Pattern.

Auf Windows übernimmt das der Task Scheduler. Claude Code legt dort einen Job an, der jede Minute ein Skript startet. Das Skript prüft, welche neuen Mails im Posteingang liegen, übergibt sie an einen Claude-Agenten und der schreibt den Entwurf. Wenn nichts Neues da ist, passiert auch nichts.

60 Sekunden sind für einen Mail-Agenten ein guter Wert. Kürzere Intervalle bringen kaum etwas, weil Mails selten so schnell hintereinander kommen. Längere fühlen sich unnatürlich an, weil der Entwurf dann erst spät bereitliegt.

Das Processed-Flag-Muster

Damit der Agent nicht alle 60 Sekunden dieselbe Mail neu beantwortet, braucht er ein Gedächtnis. Claude hat sich dafür ein einfaches System überlegt: Jede Mail bekommt einen Status, entweder unprocessed oder processed. Neue Mails sind zunächst unprocessed. Der Agent fragt nur unprocessed Mails ab, schreibt den Entwurf und markiert die Mail anschließend als processed.

Der Zustand lebt direkt in der Mail, nicht in einer externen Datenbank. Outlook erlaubt Kategorien auf jeder Mail, und genau das nutzt der Agent als Status-Flag. Keine zusätzliche Infrastruktur, kein Redis, kein Airtable.

Das Muster hat zwei nette Nebeneffekte. Du siehst im Postfach direkt, welche Mails der Agent schon bearbeitet hat. Und wenn du eine Mail manuell zurücksetzt, bearbeitet der Agent sie beim nächsten Lauf einfach neu.

Der Live-Test

Sobald die Mechanik steht, fragt Claude Code jede Minute das Postfach ab. Für den Test schicke ich mir selbst eine Mail mit dem Inhalt: “Stabile Videos, wer nicht abonniert, ist dumm.” Eine Minute später liegt der Entwurf bereit: “Hi Thomas, da hast du dir ja selbst geschrieben. Die Videos laufen wirklich stabil, freut mich. Schöne Grüße.”

Damit ist der Agent fertig. Outlook ist über Microsoft Graph angebunden, der Cron-Trigger im Task Scheduler läuft, das Processed-Flag verhindert Doppel-Antworten, und für jede neue Mail entsteht automatisch ein Entwurf.

Vorgehen im Überblick

• Microsoft Entra App registrieren, Anwendungs-ID und Verzeichnis-ID kopieren
• Öffentliche Client Flows zulassen, Mail.ReadWrite und offline_access als Berechtigungen setzen
• In Claude Code per Device Code Flow anmelden
• Konzept für Processed-Flag und Antwortentwurf beschreiben, Claude baut den Code
• Windows Task Scheduler als Cron-Trigger einrichten, der das Skript jede Minute startet

Das Spannende an diesem Vorgehen: Ich habe für den Agenten keine einzige Zeile Code selbst geschrieben. Mein Job war, das Ergebnis sauber zu beschreiben und am Ende zu prüfen, dass es funktioniert. Den Rest hat Claude Code erledigt.

Weiterlesen

Wenn du dasselbe lieber visuell und in der Cloud bauen willst, ist der erste Mail-Agent mit n8n der passende Einstieg. Wer Claude Code grundsätzlich verstehen will, findet im Artikel Website mit KI erstellen den größeren Kontext, in welchen Szenarien sich das lohnt. Und wenn dich Agenten generell interessieren, gibt es eine ruhige Einordnung unter KI-Agenten erklärt.

Für die Umsetzung im eigenen Unternehmen passen zwei Leistungen: Workflow-Automatisierung für klassische Tool-Verkettungen und CRM-Automatisierung, wenn die Antwortentwürfe direkt aus deinem CRM heraus kommen sollen. Bei konkreten Projekten am besten direkt melden.