Outlook Mail + Calendar + OneDrive

Outlook Mail + Calendar + OneDrive

Virtual assistant with Outlook Mail, Calendar, and early OneDrive support (requires Azure admin).

13
Stars
4
Forks
0
Releases

Overview

OutlookMCPServer is an MCP server that gives Claude Desktop access to Microsoft 365 mail, calendar, and files through the Microsoft Graph API. It leverages the modern Microsoft Graph SDK (msgraph) and Azure Identity's DeviceCodeCredential with persistent token caching to authenticate against Azure AD. The server exposes an MCP-compliant interface via FastMCP, enabling Claude to read and manage mail, calendar events, and file metadata from OneDrive and SharePoint. It runs locally on macOS and is intended for use with Claude Desktop. Authentication requires an Azure-registered application and tenant admin consent for Graph scopes (e.g., Mail.Read, Calendars.Read). Setup includes creating an auth_cache directory to persist authentication state and a .env file defining AZURE_CLIENT_ID, AZURE_TENANT_ID, and AZURE_GRAPH_SCOPES. On first run, the application uses Device Code flow and will create auth_record.json in auth_cache if successful. The project includes a modular folder structure under mcpserver/graph with services for mail, calendar, files, and a controller/server that ties MCP requests to Graph API calls. Getting started instructions cover cloning, virtual env setup with uv, and running via MCP Inspector for debugging.

Details

Owner
Norcim133
Language
Python
License
MIT License
Updated
2025-12-07

Features

Mail access

Compose, Respond, Sort, Search, Filter, and Analyze your inbox from Claude or any MCP-compatible agent.

Calendar support

Find invites, List Events, Compose/Update/Send Events.

OneDrive support

Search files, get file metadata.

SharePoint support

Load drives, search files, get file metadata.

Audience

Claude Desktop usersOperate email, calendar, and file workflows through Claude on macOS via the MCP server.
Azure administrators / IT adminsRegister an app and grant Graph scopes (e.g., Mail.Read, Calendars.Read) with tenant admin consent.

Tags

Microsoft GraphMailCalendarOneDriveSharePointMCPClaude DesktopAzureDevice Code CredentialAuthenticationGraph APImacOSAzure ADOAuth