mcp-outlook-com

MCP-Server für Claude Desktop: lesender Zugriff auf E-Mails, Kalender und Anhänge im klassischen Outlook über das COM-Objektmodell, dazu das Anlegen von E-Mail-Entwürfen und das Vorbereiten von Besprechungseinladungen.

Schreibend werden nur Entwürfe angelegt (neue Mail, Antwort, Weiterleitung); bestehende Entwürfe werden nicht geändert. Besprechungseinladungen werden vorbefüllt in einem Outlook-Fenster geöffnet, aber nicht gespeichert. Es wird nichts gesendet, verschoben oder gelöscht; dafür gibt es bewusst kein Werkzeug. Mails werden beim Lesen nicht als gelesen markiert. Anhänge werden zum Lesen kurz in ein temporäres Verzeichnis gespeichert und danach wieder gelöscht.

Installation

Installiert wird das Paket (Wheel) eines Releases in eine eigene virtuelle Umgebung, z. B. %USERPROFILE%\.mcp\outlook\.venv. Die Abhängigkeiten kommen dabei mit, Git wird nicht benötigt. Die Prüfsumme (SHA256) des Wheels steht in den Release Notes.

py -3.12 -m venv "$env:USERPROFILE\.mcp\outlook\.venv"
& "$env:USERPROFILE\.mcp\outlook\.venv\Scripts\python.exe" -m pip install https://github.com/StefanZHAW/mcp-outlook-com/releases/download/v<Version>/mcp_outlook_com-<Version>-py3-none-any.whl

Alternativ startet uv den Server mit uvx direkt aus dem Wheel, ohne eigene virtuelle Umgebung (Beispiel unter Konfiguration). uv legt die Umgebung beim ersten Start selbst an und nimmt sie danach aus seinem Cache.

Ein Push auf main ändert an installierten Rechnern nichts. Neue Stände kommen erst mit einem Release und einer erneuten Installation dorthin.

Gestartet wird der Server mit mcp-outlook-com.exe aus der virtuellen Umgebung oder mit python -m mcp_outlook_com.

Related MCP server: Microsoft 365 MCP Server

Werkzeuge

Entwürfe

Entwürfe werden mit Save im Ordner Entwürfe gespeichert, nie gesendet. Gesendet wird nur von Hand in Outlook. Mit open_in_outlook öffnet sich der Entwurf zusätzlich in einem Outlook-Fenster zum Prüfen.

• Der Text (body) wird als HTML eingefügt, Zeilenumbrüche bleiben erhalten. Mit body_is_html kann ein HTML-Fragment übergeben werden.

• Die Schrift (Standard Aptos 12 pt) wird direkt an jedem Absatz gesetzt. Sonst gälte die Formatvorlage der Mail, die bei Antworten von der Originalmail stammt und je nach Outlook-Version abweicht. Eigene Schriftangaben in einem HTML-Fragment haben Vorrang.

• Die Standardsignatur fügt Outlook selbst ein, wie beim Verfassen einer Mail (Signatur für neue Mails bzw. für Antworten und Weiterleitungen).

• Einmal angelegte Entwürfe ändert der Server nicht mehr. Korrekturen in Outlook vornehmen oder einen neuen Entwurf anlegen.

• Die Originalmail wird beim Antworten oder Weiterleiten nicht verändert.

Besprechungseinladungen

open_meeting_draft öffnet eine vorbefüllte Einladung (Betreff, Beginn, Ende bzw. Dauer, Ort, erforderliche und optionale Teilnehmende, Räume, Text) in einem Outlook-Fenster. Sie wird weder gespeichert noch gesendet: Gesendet oder gespeichert wird von Hand im Fenster, wird es ohne Speichern geschlossen, bleibt nichts zurück. Bis dahin blockiert sie keine Zeit im Kalender.

• Ohne Teilnehmende und Räume entsteht ein einfacher Termin.

• Eine Teams-Besprechung wird im Fenster über die Schaltfläche hinzugefügt (oder automatisch, wenn das in Teams für alle Besprechungen eingestellt ist).

• Der Text wird als reiner Text übernommen.

• Eine geöffnete Einladung kann der Server nicht mehr ändern, da sie keine EntryID hat. Korrekturen im Fenster vornehmen oder eine neue Einladung öffnen.

Freigegebene Kalender und Frei/Gebucht

list_events mit shared_mailbox liest die Termine aus dem Kalenderordner der anderen Person. Dafür braucht es eine Freigabe mit Leserechten («Alle Details» bzw. «Prüfer»). Bei der Standardfreigabe «Frei/Gebucht», auch mit Titel und Ort, liefert Outlook dort keine Termine, obwohl die Kalenderansicht in Outlook belegte Zeiten zeigt: Diese Ansicht stammt aus dem Verfügbarkeitsdienst von Exchange, nicht aus dem Kalenderordner.

get_free_busy und find_meeting_times nutzen deshalb Recipient.FreeBusy wie die Terminplanung in Outlook und funktionieren mit jeder Frei/Gebucht-Freigabe innerhalb der Organisation. Externe Adressen werden nicht unterstützt.

Zu beachten:

• Die Auflösung ist das gewählte Raster (interval_minutes, Standard 15 Minuten). Ein Termin von 08:15 bis 08:55 belegt den Block 08:15 bis 09:00.

• Ein ganztägiger Eintrag «Anderswo tätig» überdeckt in Outlook alle anderen Termine des Tages. find_meeting_times wertet ihn als belegt und weist darauf hin.

• Wie weit in die Zukunft Daten verfügbar sind, bestimmt die Veröffentlichung von Frei/Gebucht in Exchange.

Konfiguration

Über Umgebungsvariablen im Abschnitt env des Eintrags in claude_desktop_config.json:

Beispiel für den Eintrag in claude_desktop_config.json (Pfad an die eigene Installation anpassen):

{
  "mcpServers": {
    "outlook": {
      "command": "C:\\Users\\<Benutzer>\\.mcp\\outlook\\.venv\\Scripts\\mcp-outlook-com.exe",
      "env": {
        "PYTHONUTF8": "1",
        "OUTLOOK_MCP_MAX_RESULTS": "50",
        "OUTLOOK_MCP_MAX_BODY_CHARS": "20000"
      }
    }
  }
}

Mit uvx statt eigener Installation (uvx muss im PATH liegen, sonst den vollständigen Pfad angeben; die Version steht in der Adresse des Wheels):

{
  "mcpServers": {
    "outlook": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "https://github.com/StefanZHAW/mcp-outlook-com/releases/download/v<Version>/mcp_outlook_com-<Version>-py3-none-any.whl",
        "mcp-outlook-com"
      ]
    }
  }
}

Nach einer Änderung Claude Desktop vollständig beenden und neu starten.

Voraussetzungen

• Windows mit dem klassischen Outlook (das neue Outlook bietet keinen COM-Zugriff)

• Python 3.12 (die Abhängigkeiten installiert das Paket mit)

• Ausführung als normaler Benutzer, nicht mit Administratorrechten

Entwicklung

Lokal testen, ohne Claude Desktop:

uv venv --python 3.12
uv pip install -e .
.venv\Scripts\python.exe -c "import mcp_outlook_com.server"

Der Code liegt in mcp_outlook_com/server.py. Abhängigkeiten stehen in pyproject.toml (dependencies); das Paket bringt sie bei der Installation mit. mcp bleibt auf 1.x begrenzt, da Version 2 die API ändern kann.

Bei jedem Push auf main und jedem Pull-Request baut der Workflow CI das Wheel und prüft unter Windows, dass es sich installieren und importieren lässt.

Releases

1. Version in pyproject.toml erhöhen (z. B. 1.0.0 → 1.1.0), committen und auf main pushen.

2. Tag setzen und pushen:

   git tag v1.1.0
   git push origin v1.1.0

3. Der Workflow Release prüft, dass Tag und Version übereinstimmen, baut das Wheel und erstellt den Release mit dem Wheel, der Prüfsumme (SHA256) und automatisch erzeugten Release Notes. Die Release Notes lassen sich danach auf GitHub ergänzen.

Referenzen

• Model Context Protocol

• MCP Python SDK

• Outlook-Objektmodell (VBA-Referenz)

• pywin32

Lizenz

MIT