Outlook Kalender MCP-Server

Ein MCP-Server (Model Context Protocol) für C#, der deinen lokalen Microsoft Outlook-Kalender ausliest und Termine für beliebige Zeiträume zurückgibt.

---

Voraussetzungen

Anforderung	Details
Betriebssystem	Windows (COM-Interop erfordert Windows)
Microsoft Outlook	Outlook 2016 / 2019 / 2021 / 365 (lokal installiert)
.NET SDK	.NET 8.0 oder neuer
Claude Desktop	Für die MCP-Integration

---

Installation & Build

# 1. Projektordner öffnen
cd OutlookMcpServer

# 2. Abhängigkeiten wiederherstellen
dotnet restore

# 3. Server bauen
dotnet build -c Release

# 4. (Optional) Pfad zur fertigen EXE ermitteln
# → bin\Release\net8.0-windows\OutlookMcpServer.exe

---

Claude Desktop einrichten

Öffne die Konfigurationsdatei von Claude Desktop:

%APPDATA%\Claude\claude_desktop_config.json

Füge den folgenden Block hinzu (Pfad anpassen!):

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "C:\\Pfad\\zu\\OutlookMcpServer\\bin\\Release\\net8.0-windows\\OutlookMcpServer.exe"
    }
  }
}

Tipp: Alternativ kann der Server auch mit dotnet run gestartet werden:

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "dotnet",
      "args": ["run", "--project", "C:\\Pfad\\zu\\OutlookMcpServer\\OutlookMcpServer.csproj"]
    }
  }
}

---

Verfügbare Tools

get_calendar_appointments

Liest Termine für einen beliebigen Zeitraum.

Parameter	Typ	Beschreibung
startDate	string	Startdatum (Format: YYYY-MM-DD)
endDate	string	Enddatum (Format: YYYY-MM-DD)
filter	string	(Optional) Suchbegriff in Betreff, Ort oder Beschreibung
maxResults	int	(Optional) Max. Anzahl Termine, Standard: 100

Beispiel-Anfragen an Claude:

• „Zeige mir alle Termine im Mai 2025"
• „Welche Meetings habe ich nächste Woche?"
• „Suche nach Terminen mit dem Stichwort 'Review' im Juni"

---

get_today_appointments

Gibt alle Termine für heute zurück. Keine Parameter nötig.

---

get_upcoming_appointments

Gibt die nächsten N Tage ab heute zurück.

Parameter	Typ	Beschreibung
days	int	Anzahl Tage ab heute (Standard: 7)
maxResults	int	Max. Anzahl Termine (Standard: 20)

---

list_calendars

Listet alle verfügbaren Kalender-Ordner in Outlook auf (nützlich bei mehreren Konten).

---

Ausgabeformat

Die Tools geben Markdown zurück, das Claude direkt anzeigen kann:

# Outlook-Termine: 01.05.2025 – 31.05.2025
Gefunden: 12 Termin(e)

## Montag, 05. Mai 2025

### Team-Meeting
- **Zeitraum:** 10:00 – 11:00 Uhr (60 Min.)
- **Ort:** Konferenzraum 2
- **Organisator:** Max Mustermann
- **Wiederholung:** Ja

---

Hinweise & Bekannte Einschränkungen

• Outlook muss gestartet sein, wenn der MCP-Server verwendet wird (COM-Verbindung).
• Es wird immer der Standard-Kalender ausgelesen. Für weitere Kalender (z. B. freigegebene) müsste GetCalendarAppointments angepasst werden.
• Wiederkehrende Termine (IncludeRecurrences = true) werden korrekt expandiert.
• Vertrauliche Termine werden mit entsprechendem Hinweis markiert, aber vollständig angezeigt (lokaler Zugriff).

---

Troubleshooting

Problem	Lösung
COMException: Class not registered	Outlook ist nicht installiert
COMException: The server is not available	Outlook muss laufen
Keine Termine gefunden	Zeitraum prüfen; list_calendars aufrufen
Build-Fehler: COM-Referenz nicht gefunden	Outlook-Interop-Assemblies via NuGet: Microsoft.Office.Interop.Outlook

Alternativer NuGet-Ansatz (falls COM-Referenz fehlt)

Falls die direkte COM-Referenz im .csproj Probleme macht, ersetze sie durch:

<PackageReference Include="Microsoft.Office.Interop.Outlook" Version="15.0.47

... [View full README on GitHub](https://github.com/CorinnaJohnAdesso/OutlookMcpServer#readme)