outlook-mcp (erweiterter Fork)

MCP-Server für Microsoft Outlook unter Windows über win32com – ermöglicht KI-Assistenten (Claude Code und andere MCP-Clients) die Arbeit mit E-Mails, Kontakten, Kalendern und Aufgaben über eine lokal laufende Outlook-Instanz. Kein Azure AD, keine Graph API, kein OAuth – es steuert den Outlook-Desktop-Client über COM.

Dies ist ein erweiterter Fork von lihaokun/outlook-mcp (PyPI: outlook-mcp-server 0.1.1, MIT). Upstream liefert 14 Tools; dieser Fork liefert 21 und behebt drei Klassen von Fehlern, die im Produktivbetrieb auftreten. Er ist nicht auf PyPI veröffentlicht – installieren Sie aus diesem Repository (siehe unten) und führen Sie danach nicht pip install -U outlook-mcp-server aus, sonst überschreibt PyPI ihn.

Was dieser Fork gegenüber Upstream 0.1.1 hinzufügt

Neue Tools (7) – Upstream hatte nur listCalendars + createEvent für Kalender und nichts für Aufgaben:

• listEvents, getEvent, updateEvent, deleteEvent

• listTasks, createTask, updateTask

Fehlerbehebungen:

• Zeitzone: Ereigniszeiten werden über StartUTC/EndUTC gelesen und mit astimezone() konvertiert. Outlooks COM-Eigenschaften Start/End melden die lokale Wanduhrzeit mit einem falschen +00:00-Offset; naiver Code verschiebt jeden Termin.

• Gebietsschema-sichere Datumsfilter: DASL/Jet-Datumsliterale werden mit win32api.GetDateFormat(LOCALE_USER_DEFAULT, ...) formatiert. Outlook parst Filterdaten im Systemgebietsschema – ein US-formatiertes 07/02/2026 wird auf einem deutschen System als 7. Februar gelesen.

• COM-Apartment-Disziplin: CoInitialize/CoUninitialize werden in einem einzigen Helfer (_run_com) ausbalanciert, statt ad hoc aufgerufen zu werden.

• --version: meldet die tatsächlich installierte Version (Upstream hatte einen Tippfehler, der immer dev ausgab).

Ergänzungen:

• calendarPath-Parameter bei allen Ereignis-Tools und in jedem Ereignis-Dict ausgegeben, sodass Ereignisse über mehrere/geteilte Kalender adressierbar sind.

• busyStatus und meetingStatus werden bei Ereignissen offengelegt.

• createEvent mit calendarId speichert, verschiebt dann das Element in den Zielkalender und zeigt das verschobene Element an.

• Lange Nachrichtentexte werden mit einem Hinweis gekürzt, getMessage/getEvent für den vollständigen Text aufzurufen.

Sicherheitsmodell (unverändert von Upstream): jede ausgehende Aktion – sendMail, replyToMessage, forwardMessage, createEvent, Aufgaben – endet mit .Display(), nie mit .Send(). Das Element öffnet sich in Outlook und ein Mensch klickt auf Senden. Der Server kann selbst nichts senden.

Related MCP server: MCP Outlook Tools

Vollständige Tool-Liste (21)

Anforderungen

• Windows mit installiertem und konfiguriertem klassischen Outlook-Desktop-Client (der Server verbindet sich mit einer laufenden Instanz oder startet eine über COM)

• Python 3.10+

Installation

pip install git+https://github.com/K4uP/outlook-mcp.git

Bei Claude Code registrieren (Benutzerbereich):

claude mcp add --scope user outlook -- outlook-mcp-server

Wenn outlook-mcp-server nicht im PATH ist, verwenden Sie den vollständigen Pfad zum Konsolen- Skript, z. B. %LOCALAPPDATA%\Programs\Python\Python312\Scripts\outlook-mcp-server.exe. Starten Sie Claude Code danach neu und überprüfen Sie mit claude mcp list.

Bekannte Stolperfallen

• Die mcpServers-Konfiguration gehört in ~/.claude.json (Benutzerbereich) – sie in settings.json zu setzen, bewirkt nichts.

• listEvents ohne calendarPath mischt geteilte/Delegierten-Kalender ein; übergeben Sie den expliziten Kalenderpfad, wenn Sie die Verfügbarkeit einer Person benötigen.

• createEvent: Lassen Sie calendarId für den Standardkalender weg; einige Exchange-Setups schlagen fehl, wenn der Standardkalender mit expliziter ID adressiert wird.

• Über sendMail „gesendete" E-Mails werden nur angezeigt – nichts verlässt den Rechner, bis ein Mensch im Outlook-Fenster auf Senden klickt.

Lizenz

MIT – siehe LICENSE. Originalwerk Copyright (c) 2026 lihaokun; Erweiterungen und Korrekturen Copyright (c) 2026 Rene S. Kaup.