mcp-outlook
mcp-outlook
Ein selbst hostbarer MCP-Server für lokales Microsoft Exchange über EWS (Exchange Web Services). Entwickelt für Air-Gap-/Cloud-freie Umgebungen – er spricht direkt mit Ihrem internen Exchange-Server und berührt niemals Microsoft Graph, Azure AD oder einen Outlook-Desktop-Client.
Backend:
exchangelib(EWS-Client)Framework: FastMCP
Transport: streamable-http (ein eigenständiger HTTP-Server, mit dem sich andere interne Hosts verbinden)
Authentifizierung bei Exchange: Basic oder NTLM (per Konfiguration wählbar)
Zwei Modi
Modus | Wen es bedient | Wie es authentifiziert |
| ein Postfach | verbindet sich als dieses Konto (eigene Anmeldedaten) – ideal für lokale Beta-Tests |
| viele Benutzer | validiert das Benutzer-JWT jedes Aufrufers und agiert dann über ein Dienstkonto + EWS-Impersonation auf dem Postfach dieses Benutzer |
Wie der jwt- Modus Identitäten überbrückt. Exchange kann Ihre Unternehmens-JWTs nicht verarbeiten (Outlook basiert auf PKINIT/Kerberos). Der MCP führt daher zwei getrennte Authentifizierungen durch, die niemals vermischt werden:
User --(JWT)--> MCP validates the token, reads the user's email
MCP --(service account, NTLM)--> Exchange
MCP --(impersonation header = user's email)--> acts on the user's mailboxDas Benutzer-JWT wird niemals an Exchange gesendet, und kein Benutzerpasswort und keine Smartcard berührt jemals den MCP – nur die einzelne Dienstkonto-Anmeldeinformation. Siehe TODO.md für das, was Administratoren für den jwt-Modus einrichten müssen.
Related MCP server: OWA Exchange MCP Server
Tools
Tool | Zweck |
| Neueste Nachrichten, neueste zuerst |
| Text- + Datumsbereichs- + Absender-/Empfängersuche |
| Vollständige Nachricht: Textkörper, Empfänger, Anhangsnamen |
| Öffnet das interaktive Compose-Widget (MCP Apps); der Benutzer bearbeitet und sendet |
| Öffnet das Compose-Widget, vorausgefüllt als Antwort |
| Öffnet das Compose-Widget, vorausgefüllt als Weiterleitung |
| Senden – nur aus dem Widget heraus aufrufbar (nur für Apps sichtbar) |
| Kontakte suchen – nur aus dem Widget heraus aufrufbar (nur für Apps) |
| Gelesen-Status umschalten |
| In Gelöschte Elemente verschieben oder dauerhaft löschen |
| Outlook-Wichtigkeit auf Hoch/Normal setzen |
| Eine Nachricht in einen anderen Ordner verschieben |
| Verfügbare E-Mail-Ordnernamen, einschließlich Unterordner |
| Kalenderereignisse in einem Datumsbereich |
| Vollständiges Ereignis: Text, Teilnehmer, Ort |
| Terminplanungs-Assistent – bewertet Slots nach Verfügbarkeit der Teilnehmer |
| Öffnet das interaktive Widget zum Entwerfen von Ereignissen |
| Ereignis erstellen – nur aus dem Widget heraus aufrufbar (nur für Apps) |
| Auf eine Besprechungseinladung antworten |
list_emails und search_emails akzeptieren außerdem unread_only=true, um nur ungelesene Nachrichten zurückzugeben.
Einrichtung
Erfordert Python 3.11+ und uv.
uv sync # create venv + install deps
cp .env.example .env # then edit .env with your Exchange details
uv run python -m mcp_outlookDer Server bindet an MCP_HOST:MCP_PORT (Standard 127.0.0.1:8000) und stellt den streamable-http-MCP-Endpunkt unter /mcp bereit.
Lokale Beta-Tests (keine Admin-Einrichtung erforderlich)
Führen Sie ihn gegen Ihr eigenes Postfach mit Ihrem eigenen Benutzernamen/Passwort aus – kein JWT, keine Impersonation, kein Dienstkonto, keine Smartcard:
# in .env:
OUTLOOK_AUTH_MODE=static # the default
OUTLOOK_EWS_ENDPOINT=https://mail.corp.local/EWS/Exchange.asmx
OUTLOOK_USERNAME=CORP\you
OUTLOOK_PASSWORD=...
uv run python -m mcp_outlookKonfiguration
Alle Einstellungen stammen aus Umgebungsvariablen (oder einer .env-Datei). Die vollständige Liste finden Sie in .env.example. Die wichtigsten:
Var | Hinweise |
|
|
| Vollständige ASMX-URL, z. B. |
| Nur-Host-Alternative (Endpunkt wird unter |
| Das verbindende Konto – Ihr eigenes (static) oder das Dienkonto (jwt). |
| Zu öffnendes Postfach (static-Modus). Optional – standardmäßig |
| Konto-Passwort. Nicht verwendet bei |
|
|
| Erforderlich im jwt-Modus – Token-Aussteller und Audience, die verlangt werden |
| jwt-Modus – Signaturschlüssel (JWKS-URI oder ein statisches PEM für Air-Gap-Umgebungen) |
| jwt-Modus – Claim mit der SMTP-Adresse des Benutzers (Standard |
| Pfad zu einem internen CA- |
|
|
| HTTP-Bind (Standard |
So finden Sie Ihren EWS-Endpunkt
Die EWS-URL ist nicht die OWA-URL (Webmail). Auf dem Exchange-Server:
Get-WebServicesVirtualDirectory | fl Name,InternalUrl,ExternalUrlIn einer Air-Gap-Umgebung möchten Sie fast immer die InternalUrl.
Testen
Unit-Tests benötigen keinen Exchange-Server (nur Konfigurations-Parsing + Serialisierung):
uv run pytestLive-Smoke-Test (mit einer echten .env): Server starten, einen MCP-Client oder den MCP Inspector verbinden, dann list_folders → list_emails → send_email (an sich selbst) aufrufen und den Empfang bestätigen. Stellen Sie OUTLOOK_AUTH_TYPE zwischen ntlm und basic um, um zu bestätigen, welche Variante Ihr Exchange-Administrator aktiviert hat.
Compose-UI (MCP Apps)
draft_email öffnet ein interaktives MCP Apps-Widget – einen React-Composer, der in eine einzelne eigenständige HTML-Datei (src/mcp_outlook/widgets/compose.html) eingebettet ist. Jeder Host mit MCP-Apps-Unterstützung rendert es inline im Chat-Verlauf.
Widget-Funktionen:
An-Feld mit Inline-Kontaktsuche – Nach dem letzten Komma tippen, um Kontakte zu suchen; ein Ergebnis auswählen, um die Abfrage durch einen Chip zu ersetzen; gültige Adressen werden als beschriftete Chips dargestellt.
Senden / Verwerfen – Senden löst
send_emaildirekt aus dem Widget aus (nur für Apps – das Modell kann es nicht aufrufen); Verwerfen klappt die Karte zusammen.Ersetzung – Beim Öffnen eines neuen Entwurfs wird jedes ältere geöffnete Entwurfs-Widget ausgegraut.
Signatur – Jeder Entwurf ist mit „Written with Airchat“ vorausgefüllt (bearbeitbar).
Air-Gap-Garantie: Das gebaute HTML (React + Bridge-JS inline) wird mit dem Python-Paket ausgeliefert. Zur Laufzeit werden keine externen Ressourcen angefordert; Node.js wird nur zum Neuerstellen des Widgets benötigt.
Widget neu erstellen (nur Entwicklung)
cd frontend
npm ci
npm run build # tsc + vite build + artifact copy → src/mcp_outlook/widgets/compose.htmlDas Build-Skript prüft, bevor es kopiert, dass keine externen URLs in das HTML gelangt sind.
Visuell ausprobieren (eigenständige Entwicklervorschau)
cd frontend && npm run dev
# Opens http://localhost:5173 with a mock host — no Exchange needed.
# Type in To, see chips form, contact results appear, Send/Discard collapse the card.Stolperfallen
Basic-Auth ist auf modernen Exchange-Servern oft deaktiviert – NTLM ist die sicherere Standardwahl.
Interne/selbstsignierte Zertifikate erfordern
OUTLOOK_CA_BUNDLE, andernfalls schlägt die Verbindung bei der TLS-Verifizierung fehl.Der Mehrbenutzermodus (
jwt) benötigt eine Exchange-Berechtigung – das Dienstkonto muss über die RBAC-RolleApplicationImpersonationverfügen. SieheTODO.md. Derstatic- Modus benöticht keine solche Berechtigung..enventhält ein Klartext-Passwort. Sie ist git-ignoriert; schränken Sie außerdem die Dateiberechtigungen (chmod 600 .env) auf dem Host ein.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted email MCP for your own Gmail, Outlook.com, Microsoft 365, iCloud or IMAP inbox: read, search, draft, reply in thread, forward and file mail. It moves or flags up to 500 messages in one call, and a send leaves exactly one copy in Sent. A calendar is a separate connection, and connecting one adds diary and scheduling tools.
Provision domains, mailboxes, and run email sequencer campaigns via remote MCP.
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Hosted MCP server for your Gmail, Outlook and IMAP mail, with mailboxes and scopes set per agent.
Related MCP Servers
- AlicenseCqualityBmaintenanceSecure MCP server for on-prem Microsoft Exchange (EWS) with tools for email, calendar, contacts, folders, attachments, and free/busy availability.3116MIT
- AlicenseAqualityCmaintenanceMCP server for any Microsoft Exchange / OWA deployment. Gives LLM agents access to email, calendar, directory search, folders, availability, and meeting analytics via 30 tools.3032 PyPI12MIT
- -licenseNot gradedqualityDmaintenanceSecure MCP server for Microsoft Exchange. It enables authorized users to list, search, read, download attachments, send, and reply to email via EWS with strict access control and audit.-
- AlicenseNot gradedqualityBmaintenanceEnables an MCP client to read, draft, organize, send, and delete email across multiple Gmail and Exchange Online/Outlook.com accounts, with per-account capability policies, recipient allowlists, confirmations, minimum OAuth scopes, and local audit logging.MIT