AnleitungStand 26. Oktober 2026

Outlook-MCP-Server: was mit Outlook.com und Microsoft 365 geht

Für ein privates Outlook.com-Konto ist Softerias ms-365-mcp-server der direkteste Weg: Er läuft lokal per npx, meldet dich per Device Code an und unterstützt private Microsoft-Konten im Standardmodus; nötig ist nur die Mandanten-Einstellung consumers.[1] Microsofts eigene Mail-Werkzeuge und der Microsoft-365-Connector in Claude setzen dagegen ein Arbeitskonto mit Microsoft-365-Mandanten voraus.[6][7][8] Wer keinen Server selbst betreiben will, leitet Outlook weiter und arbeitet in einer Kopie.

Command Mail ist unser Produkt und erscheint unten als einer von fünf Wegen. Grundlage sind die READMEs, Werkzeuglisten und GitHub-Daten vom 2026-10-26 sowie Microsofts und Anthropics Hilfeseiten am selben Tag; die Community-Server haben wir nicht mit eigenen Konten durchgetestet.

Stand: Faktenprüfung: Lesezeit etwa 7 Min.Als Markdown

Inhalt
  1. Welche Outlook-MCP-Wege gibt es?
  2. Softeria ms-365-mcp-server: der Standard für private Konten
  3. Voraussetzungen
  4. Schritte: Softeria in Claude einrichten
  5. ryaker outlook-mcp: funktioniert, mit zwei Fragezeichen
  6. Microsofts eigene Werkzeuge: nur für Organisationen
  7. Claude ohne eigenen Server
  8. Outlook über Command Mail anbinden
  9. Hat es geklappt?
  10. Häufige Fehler
  11. Nächste Schritte
  12. Häufige Fragen
  13. Quellen

01Welche Outlook-MCP-Wege gibt es?

Hinter „Outlook-MCP-Server“ stecken zwei Fragen: Läuft der Server mit deinem Kontotyp, und wer verwaltet die App, über die er auf Microsoft Graph zugreift? Bei privaten Konten schrumpft die Auswahl schnell.

WegPrivates Outlook.comMicrosoft 365 (Arbeit)SendenBetrieb
Softeria ms-365-mcp-serverJa, StandardmodusJa, mit --org-modesend-mail; Read-only-Modus möglichLokal oder selbst gehostet, MIT
ryaker outlook-mcpJa, mit eigener Azure-App für persönliche KontenJasend-emailLokal, keine Lizenz angegeben
Microsoft Mail-Tools / Work IQNeinJa, Preview bzw. Copilot StudioJa (Mail-Tools)Microsoft, mandantengebunden
Claude Microsoft-365-ConnectorNeinJa, nach Admin-ZustimmungNur mit freigeschalteten SchreibwerkzeugenAnthropic
Weiterleitung an Command MailJaJa, wenn externe Weiterleitung erlaubt istAb Pro; privates Outlook.com nicht als eigene AdresseFYN Labs, gehostet

Quellen: GitHub[1][2][4], Microsoft[6][7][9][10], Anthropic[8] und Command Mail.[11][12]

02Softeria ms-365-mcp-server: der Standard für private Konten

Das Projekt ist MIT-lizenziert und auf GitHub sehr aktiv: Stand 2026-10-26 rund 1.084 Sterne, letzter Push am selben Tag.[3] Sterne messen Aufmerksamkeit, keine Nutzerzahl und keine Sicherheitsprüfung.

Der Server bildet über 300 Endpunkte von Microsoft Graph als Werkzeuge ab. Im Standardmodus stehen laut README die Dienste für private Konten bereit: Outlook-Mail, Kalender, OneDrive, Excel, OneNote, To Do, Kontakte und Suche. Teams, SharePoint und freigegebene Postfächer kommen erst mit --org-mode hinzu und funktionieren nur mit Arbeits- oder Schulkonten.[1]

Für Mail nennt die Werkzeugliste unter anderem list-mail-messages, get-mail-message, create-draft-email, move-mail-message, delete-mail-message und send-mail mit dem Recht Mail.Send.[2] Welche Graph-Rechte angefragt werden, hängt davon ab, welche Werkzeuge eingeschaltet sind. Mit --preset mail beschränkst du die Auswahl auf Mail, mit --read-only blendest du Schreibwerkzeuge aus, und --list-permissions zeigt vorab, welche Rechte deine Einstellung anfragt.[1]

03Voraussetzungen

  • Ein Microsoft-Konto, privat (Outlook.com, Hotmail, Live) oder geschäftlich
  • Node.js mit npx auf deinem Rechner, weil der Server lokal läuft[1]
  • Ein MCP-Client wie Claude Code oder Claude Desktop
  • Für private Konten die Umgebungsvariable MS365_MCP_TENANT_ID=consumers. Laut README lehnt Microsoft seit Juni 2026 Refresh-Tokens über die voreingestellte Authority common ab, Sitzungen enden dann etwa eine Stunde nach der Anmeldung[1]
  • Für eine eigene App statt der Softeria-Standard-App: Zugang zu Microsoft Entra, um eine App zu registrieren[1]

04Schritte: Softeria in Claude einrichten

  1. Prüfe vorab, welche Rechte deine Einstellung anfragt: npx @softeria/ms-365-mcp-server --preset mail --read-only --list-permissions.[1]
  2. Trage den Server in Claude Code im persönlichen Modus und nur lesend ein: claude mcp add ms365 -e MS365_MCP_TENANT_ID=consumers -- npx -y @softeria/ms-365-mcp-server --preset mail --read-only.[1]
  3. In Claude Desktop trägst du unter Settings → Developer stattdessen einen JSON-Eintrag in die Konfigurationsdatei ein (Beispiel unten).[1]
  4. Melde dich an: Rufe im Client das Werkzeug login des so eingerichteten Servers auf, öffne die angezeigte Microsoft-Seite und gib den Device Code ein. Meldest du dich stattdessen per Kommandozeile an, nimm dieselben Optionen und dieselbe Umgebungsvariable: MS365_MCP_TENANT_ID=consumers npx @softeria/ms-365-mcp-server --preset mail --read-only --login.[1]
  5. Bestätige die Verbindung mit dem Werkzeug verify-login.[1]
  6. Erst wenn das Lesen klappt: Entferne --read-only, wenn der Agent Entwürfe anlegen oder senden soll, und melde dich danach neu an, damit das Token die neuen Rechte bekommt.[1]

Der Eintrag für Claude Desktop folgt dem README-Beispiel für private Konten, ergänzt um die Umgebungsvariable:

{
  "mcpServers": {
    "ms365": {
      "command": "npx",
      "args": ["-y", "@softeria/ms-365-mcp-server", "--preset", "mail", "--read-only"],
      "env": { "MS365_MCP_TENANT_ID": "consumers" }
    }
  }
}

Eine Entscheidung solltest du bewusst treffen: Ohne eigene Client-ID meldest du dich an der Standard-App von Softeria an. Laut README deklariert sie einen festen, schlanken Rechtesatz; welche Rechte angefragt werden, ergibt sich aus den eingeschalteten Werkzeugen, und für zusätzliche Rechte verweist das Projekt auf eine eigene App. Willst du selbst kontrollieren, welche App welche Rechte hält, registrierst du eine eigene App in Microsoft Entra und setzt MS365_MCP_CLIENT_ID.[1]

05ryaker outlook-mcp: funktioniert, mit zwei Fragezeichen

ryakers Server deckt Mail, Kalender und OneDrive ab, mit Werkzeugen zum Auflisten, Suchen, Lesen und Senden (send-email) sowie zum Anlegen und Löschen von Ordnern und Terminen.[4] Er bringt keine fertige App mit. Du registrierst im Azure-Portal eine eigene, wählst als Kontotyp „Accounts in any organizational directory and personal Microsoft accounts“, trägst http://localhost:3333/auth/callback als Weiterleitung ein, legst ein Client-Secret an und vergibst unter anderem Mail.Read, Mail.ReadWrite und Mail.Send.[4]

Die zwei Fragezeichen: Die GitHub-API weist für das Repository keine Lizenz aus, und der letzte Push war am 2026-03-30.[5] Prüfe vor einer Übernahme die Lizenzbedingungen und den Projektstand. Für eine neue Einrichtung würden wir Softeria vorziehen, das MIT-lizenziert ist und dessen letzter Push laut GitHub-API am Abruftag lag, es sei denn, du brauchst gerade ryakers Werkzeugzuschnitt und prüfst den Code selbst.[3]

06Microsofts eigene Werkzeuge: nur für Organisationen

Microsoft dokumentiert einen Mail-Server mit der Kennung mcp_MailTools unter einer Adresse, die die Mandanten-ID enthält. Er kann Entwürfe anlegen, senden, antworten, suchen, ändern und löschen.[6] Die Seite trägt zwei deutliche Hinweise: Es ist eine Preview, Werkzeugnamen können sich ändern, und die anwendungsspezifischen Microsoft-365-Tools sind nur noch für Rückwärtskompatibilität gedacht. Für neue Projekte verweist Microsoft auf Work IQ.[6]

Work IQ ist in Copilot Studio allgemein verfügbar, wird über Copilot Credits verbraucht und verbindet Agenten mit Mail, Terminen, Dateien und Chats einer Organisation.[7] Das ist ein Werkzeug für Firmen, die ihre Agenten in Copilot Studio bauen, kein Server, den du mit einem privaten Konto in Claude oder Cursor einträgst.

07Claude ohne eigenen Server

Für Microsoft 365 im Unternehmen braucht Claude keinen Community-Server: Der eingebaute Microsoft-365-Connector durchsucht Outlook, SharePoint, OneDrive und Teams und steht laut Anthropic in allen Tarifen bereit. Er verlangt ein Arbeitskonto mit Microsoft-Entra-Mandanten und die einmalige Zustimmung eines Administrators; Konten auf outlook.com, hotmail.com oder live.com funktionieren ausdrücklich nicht.[8] Senden kann er nur, wenn die Organisation die Schreibwerkzeuge freigeschaltet hat. Die Schritte stehen in Outlook mit Claude verbinden.

08Outlook über Command Mail anbinden

Command Mail ist ein gehostetes Postfach mit MCP-Server unter https://commandmail.app/mcp, angemeldet über OAuth 2.1 mit PKCE und dynamischer Client-Registrierung.[11] Du betreibst keinen Server und registrierst keine Azure-App.

Outlook kommt per automatischer Weiterleitung hinein, die Outlook.com in den Einstellungen anbietet.[9] Soll dein Outlook-Postfach vollständig bleiben, setze dabei den Haken „Kopie der weitergeleiteten Nachrichten beibehalten“.[9] In Organisationen kann die Weiterleitung nach außen gesperrt sein, etwa über die Ausgangs-Spamrichtlinie, Remotedomänen oder Mailflussregeln.[10] Command Mail bekommt Kopien neuer Mails und keinen Zugriff auf dein Outlook-Konto. Archivieren oder Sortieren in Command Mail wirkt nicht auf Outlook zurück.[12]

Senden geht ab Pro, bei privaten Outlook-Adressen aber nicht als deine Outlook-Adresse. Den Versand richtest du je Absenderadresse getrennt vom Empfang in der App ein.[12] Für private Outlook.com- und Hotmail-Adressen bietet Command Mail dafür den Versand über eine eigene Command-Mail-Absenderadresse an; Antworten gehen per Reply-To an deine Outlook-Adresse. Diesen Weg schaltest du je Adresse selbst in der App ein und bestätigst die Adresse mit einem zugeschickten Code. Ein Agent sendet entweder genau die Entwurfsfassung, die ein Mensch freigegeben hat (mail:send-approved), was auf der Stufe read gesperrt ist, oder mit mail:send ohne Einzelfreigabe, dann nur aus Postfächern auf der Stufe auto, mit Tageslimit und höchstens 20 Empfängern je Mail. Senden ohne Freigabe ist beim Verbinden ausgeschaltet.[11] Free liest, sortiert und entwirft ohne Senden; Pro kostet 19 € im Monat für die ersten 100 zahlenden Pro-Konten, solange ihr Abo läuft, für weitere Konten 29 €.[11]

Für wen das nicht passt: Wer will, dass der Agent im Original-Postfach Ordner, Gelesen-Status und Kalender ändert, ist mit Softeria oder dem Claude-Connector besser bedient. Command Mail lohnt sich, wenn mehrere Adressen verschiedener Anbieter in einem Postfach landen sollen und du je Postfach festlegen willst, was der Agent dort tun darf; lesen kann er mit mail:read alle Postfächer des Kontos; Details unter Berechtigungen und Autonomie.

09Hat es geklappt?

Bitte deinen Agenten zuerst um eine harmlose Leseaufgabe: „Liste die fünf neuesten Mails im Posteingang mit Absender und Betreff.“ Bei Softeria sollte der Aufruf über list-mail-messages laufen; erscheinen Teams- oder SharePoint-Werkzeuge, ist versehentlich --org-mode aktiv. Bei Command Mail zeigt der erste Aufruf capabilities, welche Rechte und Postfächer der Agent tatsächlich hat.[11] Teste Senden erst mit einem Entwurf an dich selbst.

10Häufige Fehler

Anmeldung scheitert mit einem privaten Konto: Prüfe, ob der Organisationsmodus aktiv ist, etwa über --org-mode oder die Umgebungsvariable MS365_MCP_ORG_MODE. Der Organisationsmodus ist für Arbeits- und Schulkonten gedacht.[1]

Eigene App, aber private Konten werden abgelehnt: Beim Registrieren wurde vermutlich ein Kontotyp nur für die eigene Organisation gewählt. ryakers Anleitung verlangt ausdrücklich den Typ mit persönlichen Microsoft-Konten und rät bei Ein-Mandanten-Apps, MS_TENANT_ID zu setzen.[4]

Neue Werkzeuge melden fehlende Rechte: Softeria weist darauf hin, dass ein bereits ausgestelltes Token durch neue Werkzeuge nicht automatisch mehr Rechte bekommt. Melde dich neu an.[1]

Sitzung bricht nach etwa einer Stunde ab: Prüfe bei privaten Konten, ob MS365_MCP_TENANT_ID=consumers gesetzt ist; ohne sie beschreibt das README einen Abbruch beim ersten Token-Refresh. Setze die Variable und melde dich neu an.[1]

Weiterleitung kommt nicht an: In Microsoft 365 kann eine Sperre externer Weiterleitung greifen; blockiert die Ausgangs-Spamrichtlinie sie, bekommt der Absender eine Unzustellbarkeitsmeldung mit 5.7.520. Auch Remotedomänen und Mailflussregeln können die Weiterleitung verhindern; die IT prüft Ausgangs-Spamrichtlinie, Remotedomänen und Mailflussregeln.[10]

11Nächste Schritte

Entscheide zuerst, ob dein Agent im Original arbeiten soll oder in einer Kopie. Privat und im Original: Softeria im Read-only-Modus beginnen und Schreibrechte erst später einschalten. Im Unternehmen: zuerst den Claude-Connector oder die Werkzeuge deiner IT prüfen. Weitere Server nach Kontotyp, Senden und Betrieb stehen im Vergleich der E-Mail-MCP-Server.[1][8]

Command Mail kostenlos starten, wenn du Outlook lieber weiterleitest.

Häufige Fragen

Gibt es einen offiziellen Outlook-MCP-Server von Microsoft?

Für Organisationen ja. Microsoft beschreibt Mail-Werkzeuge als Preview mit mandantengebundener Adresse und rät, für neue Projekte Work IQ in Copilot Studio zu nutzen. Beides richtet sich an Microsoft-365-Mandanten. Einen offiziellen Microsoft-Zugang für private Outlook.com-Konten belegen die hier ausgewerteten Microsoft-Seiten nicht; dafür gibt es Community-Server.

Welcher MCP-Server funktioniert mit einem privaten Outlook.com- oder Hotmail-Konto?

Softerias ms-365-mcp-server unterstützt private Microsoft-Konten im Standardmodus; laut README solltest du dafür MS365_MCP_TENANT_ID=consumers setzen, und nur Arbeitskonten brauchen --org-mode. ryakers outlook-mcp kann private Konten ebenfalls ansprechen, wenn du eine eigene Azure-App für persönliche Konten registrierst. Der Microsoft-365-Connector in Claude schließt private Konten aus.

Kann ein Outlook-MCP-Server E-Mails senden?

Softeria und ryaker haben Sendewerkzeuge (send-mail bzw. send-email), Microsofts Mail-Tools ebenfalls. Ein Sendewerkzeug garantiert keine Rückfrage vor jedem Versand; prüfe die Freigabeeinstellungen deines MCP-Clients und die Schalter des Servers. Softeria bietet einen Read-only-Modus, der Schreibwerkzeuge ausblendet.

Brauche ich für Softeria eine eigene Azure-App?

Nicht zwingend. Ohne eigene Client-ID meldest du dich per Device Code an der Standard-App von Softeria an. Willst du selbst bestimmen, welche App welche Rechte hält, registrierst du eine eigene und setzt MS365_MCP_CLIENT_ID.

Ist ryakers outlook-mcp eine gute Wahl für eine neue Einrichtung?

Mit Vorbehalt. Die GitHub-API weist für das Repository keine Lizenz aus, der letzte Push war am 2026-03-30 (Abruf 2026-10-26). Prüfe vor einer Übernahme die Lizenzbedingungen und den Projektstand.

Quellen

  1. GitHub: Softeria/ms-365-mcp-server (README) github.com, abgerufen am
  2. GitHub: Softeria/ms-365-mcp-server, Werkzeugliste src/endpoints.json github.com, abgerufen am
  3. GitHub API: Softeria/ms-365-mcp-server (Sterne, letzter Push, Lizenz) api.github.com, abgerufen am
  4. GitHub: ryaker/outlook-mcp (README) github.com, abgerufen am
  5. GitHub API: ryaker/outlook-mcp (Sterne, letzter Push, Lizenz) api.github.com, abgerufen am
  6. Microsoft Learn: Mail reference (preview) learn.microsoft.com, abgerufen am
  7. Microsoft Learn: Work IQ in Copilot Studio learn.microsoft.com, abgerufen am
  8. Anthropic: Connect to Microsoft 365 support.claude.com, abgerufen am
  9. Microsoft: Automatische Weiterleitung in Outlook.com aktivieren oder deaktivieren support.microsoft.com, abgerufen am
  10. Microsoft Learn: Control automatic external email forwarding learn.microsoft.com, abgerufen am
  11. Command Mail: llms.txt mit Tarifen, Rechten und Verbindungswegen commandmail.app, abgerufen am
  12. Command Mail: Dokumentation commandmail.app, abgerufen am
DE
EN