OutlookMCPServer

Bei diesem Projekt handelt es sich um einen MCP-Server, der Claude Desktop über die Microsoft Graph-API Zugriff auf Ihre E-Mails, Ihren Kalender und (bald) Ihre Dateien in Microsoft 365 gewährt.

✨ Funktionen

• ✅ E-Mail-Zugriff : Verfassen, beantworten, sortieren, suchen, filtern und analysieren Sie Ihren Posteingang von Claude oder einem MCP-kompatiblen Agenten

• 🔜 Kalenderunterstützung : Nach Datum auflisten, E-Mails verfassen, löschen (demnächst verfügbar: E-Mail aktualisieren, Suchen)

• 🚧 OneDrive-Unterstützung : Mögliche zukünftige Ausrichtung, nachdem E-Mail und Kalender robust sind

Related MCP server: outlook-mcp-server

🧱 Technologie-Stack

• msgraph (modernes Microsoft Graph SDK)

• azure.identity mit DeviceCodeCredential und TokenCachePersistenceOptions

• FastMCP – einfache MCP-kompatible Serverschnittstelle

• uv – schnelles Python-Abhängigkeits- und Umgebungsmanagement

⚙️ Voraussetzungen

Dies ist derzeit so aufgebaut:

• Lokale Ausführung unter macOS

• Kann mit Claude Desktop verwendet werden

• Authentifizieren mit einer bei Azure registrierten Anwendung

⚠️ Sie müssen über Administratorzugriff auf einen Azure-Mandanten verfügen, um dies zu konfigurieren. Die App-Registrierung erfordert die Zustimmung für Microsoft Graph-Bereiche (z. B. Mail.Read , Calendars.Read ), die in den meisten Organisationen standardmäßig nicht vom Benutzer einwilligen kann .

🚀 Erste Schritte

# Set up the environment
uv venv
uv pip install -r uv.lock

# Run locally using MCP Inspector
mcp dev main.py (expect errors)

Es ist viel einfacher, die Dinge im Inspector zum Laufen zu bringen, bevor man versucht, in Claude zu debuggen.

🔐 Authentifizierungs-Setup

Bevor Sie die Anwendung ausführen, müssen Sie Folgendes einrichten:

1. Erstellen Sie einen auth_cache-Ordner im Projektstamm (siehe Hinweis):

mkdir -p auth_cache

2. Erstellen Sie eine .env-Datei im Projektstamm

touch .env

3. Fügen Sie der .env-Datei Folgendes hinzu:

echo "AZURE_CLIENT_ID=<your-id-from-Azure-portal-here>" > .env
echo "AZURE_TENANT_ID=<your-id-from-Azure-portal-here>" >> .env
echo "AZURE_GRAPH_SCOPES=User.Read Mail.Read Mail.Send Mail.ReadWrite" >> .env

HINWEIS: Beim ersten Ausführen authentifiziert sich die Anwendung mithilfe des DeviceCodeCredential-Flows und erstellt bei Erfolg automatisch auth_record.json im Ordner auth_cache.

Sie müssen über Administratorzugriff auf einen Azure-Mandanten verfügen, um eine Anwendung mit diesen Berechtigungen zu registrieren.

Claude für Desktop-Integration

Zur Integration mit Claude Desktop fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "outlook": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "azure-identity,mcp[cli],msgraph-core,msgraph-sdk",
        "mcp",
        "run",
        "/absolute/path/to/OutlookMCPServer"
      ]
    }
  }
}

In Claude Desktop finden Sie die JSON-Datei unter Einstellungen/Entwickler/Konfiguration bearbeiten.

HINWEIS: Möglicherweise müssen Sie "uv" durch eine absolute Referenz in "command" ersetzen.

Starten Sie Claude Desktop jedes Mal neu, wenn Sie eine Änderung an der Konfiguration oder am Servercode vornehmen.

📦 Ordnerstruktur

.
├── README.md
├── main.py
├── settings.py
├── auth_cache/
│   └── auth_record.json
├── mcpserver/
│   └── graph/
│       ├── __init__.py
│       ├── calendar_service.py
│       ├── controller.py
│       ├── mail_service.py
│   ├── __init__.py
│   ├── auth_wrapper.py
│   ├── context_manager.py
│   ├── mail_query.py
│   ├── message_info.py
│   └── server.py
├── tests/
├── .env
├── __init__.py
├── main.py

📌 Roadmap

• Mail-Integration (FERTIG)

• Authentifizierung in Claude Desktop (FERTIG)

• Kalenderintegration (KERN FERTIG)

• Optionale OneDrive-Integration

• Windows-Unterstützung

📄 Lizenz

MIT

Copyright (c) 2024 Enthoosa AI

Hiermit wird jeder Person, die eine Kopie dieser Software und der zugehörigen Dokumentationsdateien (die „Software“) erhält, unentgeltlich die Genehmigung erteilt, mit der Software uneingeschränkt zu verfahren, insbesondere das Recht, die Software zu verwenden, zu kopieren, zu ändern, zusammenzufügen, zu veröffentlichen, zu verteilen, unterzulizenzieren und/oder Kopien der Software zu verkaufen und diese Rechte unter den folgenden Bedingungen anderen Personen zu übertragen:

Der obige Copyright-Vermerk und dieser Genehmigungsvermerk müssen in allen Kopien oder wesentlichen Teilen der Software enthalten sein.

DIE SOFTWARE WIRD „WIE VORLIEGEND“ BEREITGESTELLT, OHNE JEGLICHE AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GARANTIE, EINSCHLIESSLICH DER GARANTIE DER MARKTGÄNGIGKEIT, DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND DER NICHTVERLETZUNG. IN KEINEM FALL HAFTEN DIE AUTOREN ODER URHEBERRECHTSINHABER FÜR ANSPRÜCHE, SCHÄDEN ODER ANDERE VERBINDLICHKEITEN, OB AUS VERTRAG, UNERLAUBTER HANDLUNG ODER ANDERWEITIG, DIE AUS DER SOFTWARE ODER DER NUTZUNG ODER DEM ANDEREN UMGANG MIT DER SOFTWARE ENTSTEHEN, DAMIT IN VERBINDUNG STEHEN.