Outlook MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Outlook MCP Server find the latest email from Contoso and create a draft reply saying thanks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Outlook MCP Server
Microsoft Outlook Web (OWA) MCP-Server auf Basis einer Playwright Browser-Bridge. Steuert den echten Outlook Webclient im Chromium, Chrome oder Edge über CDP – keine komplexen Azure AD App Registrierungen oder Graph-API Admin-Consents erforderlich. Funktioniert direkt mit echten Browser-Sessions und ohne Cloud-Relay.
Ermöglicht LLM-Agenten (Antigravity, opencode, Claude Desktop, Cursor, …) den Lese- und Entwurfszugriff auf Microsoft Outlook: E-Mails suchen, Posteingang und Ordner durchsuchen, E-Mails als Markdown inklusive Teams-Besprechungslinks auslesen sowie neue E-Mail-Entwürfe sicher anlegen.
Hinweis: Dieses Repository ist vollständig organisationsneutral. Es enthält keine firmenspezifischen Accounts oder Zugangsdaten. Der gewünschte Tenant/Realm (z.B.
adesso.de,d-velop.deoder eine beliebige Microsoft 365 Domain) kann frei über Umgebungsvariablen oder direkt im Login-Tool angegeben werden.
Features
11 leistungsfähige MCP-Tools:
outlook_status: Prüft Verbindungs- und Anmeldestatus von Outlook Web.outlook_login: Öffnet ein sichtbares Browserfenster für den einmaligen interaktiven Login (inkl. SSO / MFA).outlook_search: Volltextsuche über das OWA-Suchfeld (nach Kunden, Tickets, Absendern, Stichwörtern).outlook_get_email: Liest eine E-Mail vollständig im Lesebereich aus (konvertiert in Markdown, extrahiert Teams-Links und Metadaten).outlook_list_recent: Schnelle Übersicht über die neuesten E-Mails im Posteingang.outlook_create_draft: Legt E-Mail-Entwürfe im Ordner „Entwürfe“ (Drafts) an (per OWA DeepLink & Ctrl+S).outlook_list_folders: Listet alle Navigationsordner (Posteingang, Gesendet, Archiv, Entwürfe etc.).outlook_navigate_folder: Wechselt gezielt in einen bestimmten Ordner (z.B. Sent Items, Archiv).outlook_bulk_list: Scroll-Enumeration zur Überwindung der OWA-Listen-Virtualisierung (erfasst alle Conversation-IDs).outlook_read_email: Liest gezielt eine E-Mail anhand ihrer Conversation-ID aus.outlook_close: Beendet die Hintergrund-Browserinstanz.
Sicherheits-Konzept (Draft-First): Es gibt kein Blindversenden von Mails. Der Server legt Entwürfe an, sodass der Anwender die Nachricht vor dem Absenden in Outlook sichten und freigeben kann.
Auto-Erkennung von Browsern: Findet automatisch Chromium/Chrome/Edge unter Linux, WSL, macOS und Windows (oder via
OUTLOOK_MCP_CHROME_PATH).Persistentes lokales Profil: Anmeldedaten und MFA-Tokens verbleiben sicher im lokalen Profil (
~/.outlook-browser-profile).
Related MCP server: mcp-outlook-mail
Voraussetzungen
Node.js ≥ 20
Ein installierter Browser: Google Chrome, Microsoft Edge oder Playwright Chromium (
npx playwright install chromium).(Unter WSL/Linux) WSLg oder ein laufender X-Server für das einmalige Login-Fenster.
Installation
git clone https://github.com/pipelinedave/outlook-mcp.git
cd outlook-mcp
npm installKonfiguration (Umgebungsvariablen)
Alle Umgebungsvariablen sind optional:
Variable | Beschreibung | Standard |
| Standard-Tenant/Domain für OWA (z.B. |
|
| Expliziter Pfad zur Browser-Executable | Automatische Erkennung |
| Speicherort für das Browser-Profil |
|
| Headless-Modus ( |
|
Einbindung in MCP-Clients
Antigravity / Claude Desktop / Cursor / opencode
Füge den Server in deine MCP-Konfigurationsdatei (z.B. mcp_config.json oder opencode.json) ein:
{
"mcpServers": {
"outlook": {
"command": "node",
"args": ["/pfad/zu/outlook-mcp/index.js"],
"env": {
"OUTLOOK_MCP_REALM": "adesso.de"
}
}
}
}Oder unter WSL mit Node-Wrapper:
#!/bin/bash
export PATH="$HOME/.nvm/versions/node/v20.20.2/bin:$PATH"
export DISPLAY="${DISPLAY:-:0}"
export WAYLAND_DISPLAY="${WAYLAND_DISPLAY:-wayland-0}"
export XDG_RUNTIME_DIR="${XDG_RUNTIME_DIR:-/mnt/wslg/runtime-dir}"
export PULSE_SERVER="${PULSE_SERVER:-/mnt/wslg/PulseServer}"
exec node /pfad/zu/outlook-mcp/index.js "$@"Erste Schritte (Login)
Rufe das Tool
outlook_loginauf:{ "realm": "adesso.de" }Es öffnet sich ein sichtbares Browserfenster. Melde dich dort wie gewohnt bei deinem Microsoft 365 Account an (inkl. MFA/Passkey).
Sobald dein Posteingang geladen ist, kannst du das Fenster schließen oder geöffnet lassen.
Prüfe mit
outlook_statusden Verbindungsstatus.Das Profil wird dauerhaft lokal gespeichert – zukünftige MCP-Aufrufe laufen vollautomatisch im Hintergrund (Headless).
Tests & Syntaxprüfung
npm run check # Überprüft JS-Syntax aller Dateien
npm test # Führt Unit-Tests via node:test ausLizenz
MIT License – siehe LICENSE.
Available Tools
11 toolsoutlook_bulk_listC
Listet ALLE E-Mails eines Ordners per Scroll-Enumeration (überwindet die Virtualisierung der Nachrichtenliste). Gibt conversation-IDs + Vorschau je Mail zurück.
Inputs: folder (required), maxScrolls.
outlook_closeB
Schließt die Hintergrund-Browserinstanz.
Inputs: no named parameters.
outlook_create_draftA
Erstellt einen neuen E-Mail-Entwurf im Ordner "Entwürfe" (Drafts) in Outlook Web. Du musst die E-Mail danach nur noch in Outlook öffnen, kurz gegenlesen und absenden.
Inputs: to (required), body (required), subject (required), cc.
outlook_get_emailB
Liest eine E-Mail im Lesebereich vollständig aus (Markdown, Teams-Links, Metadaten). Standardmäßig die oberste E-Mail (Index 0).
Inputs: id, index.
outlook_list_foldersA
Listet die Ordner im Navigationsbereich (Inbox, Sent Items, Archive, Deleted Items, Drafts, Newsletter) mit ihren Namen und Item-Counts.
Inputs: no named parameters.
outlook_list_recentC
Listet die neuesten E-Mails im Posteingang auf.
Inputs: limit.
outlook_loginB
Öffnet ein sichtbares Browserfenster (Edge/Chromium via WSLg/Desktop), damit du dich einmalig bei Microsoft 365 / OWA anmelden kannst.
Inputs: realm.
outlook_read_emailB
Liest eine E-Mail vollständig im Lesebereich (Markdown) anhand ihrer conversation-ID (data-convid aus bulk_list). Scrollt ggf. automatisch durch den Ordner, bis die conversation gefunden ist.
Inputs: id (required), folder.
outlook_searchB
Sucht E-Mails in Outlook Web anhand eines Suchbegriffs (z.B. Kundenname, Ticketnummer, Absender).
Inputs: query (required), limit.
outlook_statusA
Prüft den Status der Outlook Web Verbindung und ob du eingeloggt bist.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
outlook_get_email (reads top email by index) and outlook_read_email (reads by conversation-ID) have heavily overlapping purposes, and outlook_list_recent vs outlook_bulk_list both enumerate emails with only subtle differences. Descriptions clarify the intended workflow, but an agent could easily pick the wrong reader or lister.
Consistent outlook_ prefix with mostly verb_noun naming (list_recent, get_email, create_draft, list_folders, navigate_folder, bulk_list). Minor deviation with bare verbs like status, login, and close, but overall readable and predictable.
11 tools is well-scoped for an OWA automation server, covering session lifecycle (login/status/close) plus core mail operations without bloat. Each tool earns its place.
Covers listing, searching, reading, folder navigation, and draft creation, but the lifecycle dead-ends at drafts — no send, reply, forward, delete, or move operations. Agents cannot complete a full email workflow without leaving the tool set.
Maintenance
Related MCP Connectors
Email inboxes and calendars for AI agents: send, receive, search, draft and schedule.
Email inboxes and calendars for AI agents: send, receive, search, draft and schedule.
Email for AI agents: read, search and send from your Gmail, Outlook, Yahoo, iCloud or IMAP inbox.
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Microsoft Outlook via the Microsoft Graph API for managing emails and calendar events. It allows users to read and send emails, list messages, and create calendar appointments with automatic Teams links.1ISC
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to interact with Microsoft 365 Outlook Mail, allowing email operations via natural language.119 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Microsoft Outlook emails through the Microsoft Graph API, supporting operations like listing, reading, sending, and moving emails.MIT
- AlicenseAqualityBmaintenanceEnables AI agents to read, search, draft, send, reply to, forward, and organize Microsoft Outlook mail via Microsoft Graph, with safe-by-default read-only operation and browser-based sign-in.1571 npmMIT