MSFT-Mail+Kalender

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

🧱 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:

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

mkdir -p auth_cache

Erstellen Sie eine .env-Datei im Projektstamm

touch .env

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

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

MSFT-Mail+Kalender

Related MCP Servers

Google Workspace MCP Server
epaproditus
A
security
A
license
A
quality
Provides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
Last updated -
8
13
JavaScript
MIT License
MCP Google Workspace Server
j3k0
-
security
A
license
-
quality
Enables interaction with Gmail and Google Calendar using the MCP protocol, supporting multiple Google accounts, email management, and calendar operations through natural language.
Last updated -
5
TypeScript
MIT License
Outlook Calendar MCP
merajmehrabi
A
security
A
license
A
quality
The Outlook Calendar MCP enables Claude to directly manage Microsoft Outlook calendars on Windows systems, offering a privacy-focused solution that keeps all data local. Users can view events, create meetings, find free time slots, and manage multiple calendars without their data leaving their machi
Last updated -
7
39
10
MIT License
Google Workspace MCP Server
rishipradeep-think41
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for interacting with Gmail and Calendar APIs, enabling programmatic management of emails and calendar events.
Last updated -
8
7
JavaScript
MIT License

View all related MCP servers

MSFT-Mail+Calendar