Microsoft MCP

Access Microsoft services like Outlook, Calendar, and OneDrive via the Microsoft Graph API.

Powerful MCP server for Microsoft Graph API - a complete AI assistant toolkit for Outlook, Calendar, OneDrive, and Contacts.

- Email Management: Read, send, reply, manage attachments, organize folders
- Calendar Intelligence: Create, update, check availability, respond to invitations
- OneDrive Files: Upload, download, browse with pagination
- Contacts: Search and list contacts from your address book
- Multi-Account: Support for multiple Microsoft accounts (personal, work, school)
- Unified Search: Search across emails, files, events, and people

# Add Microsoft MCP server (replace with your Azure app ID) claude mcp add microsoft-mcp -e MICROSOFT_MCP_CLIENT_ID=your-app-id-here -- uvx --from git+https://github.com/elyxlz/microsoft-mcp.git microsoft-mcp # Start Claude Desktop claude

# Email examples > read my latest emails with full content > reply to the email from John saying "I'll review this today" > send an email with attachment to alice@example.com # Calendar examples > show my calendar for next week > check if I'm free tomorrow at 2pm > create a meeting with Bob next Monday at 10am # File examples > list files in my OneDrive > upload this report to OneDrive > search for "project proposal" across all my files # Multi-account > list all my Microsoft accounts > send email from my work account

- list_emails- List emails with optional body content
- get_email- Get specific email with attachments
- create_email_draft- Create email draft with attachments support
- send_email- Send email immediately with CC/BCC and attachments
- reply_to_email- Reply maintaining thread context
- reply_all_email- Reply to all recipients in thread
- update_email- Mark emails as read/unread
- move_email- Move emails between folders
- delete_email- Delete emails
- get_attachment- Get email attachment content
- search_emails- Search emails by query

- list_events- List calendar events with details
- get_event- Get specific event details
- create_event- Create events with location and attendees
- update_event- Reschedule or modify events
- delete_event- Cancel events
- respond_event- Accept/decline/tentative response to invitations
- check_availability- Check free/busy times for scheduling
- search_events- Search calendar events

- list_contacts- List all contacts
- get_contact- Get specific contact details
- create_contact- Create new contact
- update_contact- Update contact information
- delete_contact- Delete contact
- search_contacts- Search contacts by query

- list_files- Browse OneDrive files and folders
- get_file- Download file content
- create_file- Upload files to OneDrive
- update_file- Update existing file content
- delete_file- Delete files or folders
- search_files- Search files in OneDrive

- unified_search- Search across emails, events, and files
- list_accounts- Show authenticated Microsoft accounts
- authenticate_account- Start authentication for a new Microsoft account
- complete_authentication- Complete the authentication process after entering device code
- Go toAzure Portal→ Microsoft Entra ID → App registrations
- New registration → Name:microsoft-mcp
- Supported account types: Personal + Work/School
- Authentication → Allow public client flows: Yes
- API permissions → Add these delegated permissions:

git clone https://github.com/elyxlz/microsoft-mcp.git cd microsoft-mcp uv sync

# Set your Azure app ID export MICROSOFT_MCP_CLIENT_ID="your-app-id-here" # Run authentication script uv run authenticate.py # Follow the prompts to authenticate your Microsoft accounts

{ "mcpServers": { "microsoft": { "command": "uvx", "args": ["--from", "git+https://github.com/elyxlz/microsoft-mcp.git", "microsoft-mcp"], "env": { "MICROSOFT_MCP_CLIENT_ID": "your-app-id-here" } } } }

{ "mcpServers": { "microsoft": { "command": "uv", "args": ["--directory", "/path/to/microsoft-mcp", "run", "microsoft-mcp"], "env": { "MICROSOFT_MCP_CLIENT_ID": "your-app-id-here" } } } }

All tools require anaccount_idparameter as the first argument:

# List accounts to get IDs accounts = list_accounts() account_id = accounts[0]["account_id"] # Use account for operations send_email(account_id, "user@example.com", "Subject", "Body") list_emails(account_id, limit=10, include_body=True) create_event(account_id, "Meeting", "2024-01-15T10:00:00Z", "2024-01-15T11:00:00Z")

# Run tests uv run pytest tests/ -v # Type checking uv run pyright # Format code uvx ruff format . # Lint uvx ruff check --fix --unsafe-fixes .

# Get account ID first accounts = list_accounts() account_id = accounts[0]["account_id"] # List latest emails with full content emails = list_emails(account_id, limit=10, include_body=True) # Reply maintaining thread reply_to_email(account_id, email_id, "Thanks for your message. I'll review and get back to you.") # Forward with attachments email = get_email(email_id, account_id) attachments = [get_attachment(email_id, att["id"], account_id) for att in email["attachments"]] send_email(account_id, "boss@company.com", f"FW: {email['subject']}", email["body"]["content"], attachments=attachments)

# Get account ID first accounts = list_accounts() account_id = accounts[0]["account_id"] # Check availability before scheduling availability = check_availability(account_id, "2024-01-15T10:00:00Z", "2024-01-15T18:00:00Z", ["colleague@company.com"]) # Create meeting with details create_event( account_id, "Project Review", "2024-01-15T14:00:00Z", "2024-01-15T15:00:00Z", location="Conference Room A", body="Quarterly review of project progress", attendees=["colleague@company.com", "manager@company.com"] )

- Tokens are cached locally in~/.microsoft_mcp_token_cache.json
- Use app-specific passwords if you have 2FA enabled
- Only request permissions your app actually needs
- Consider using a dedicated app registration for production

- Authentication fails: Check your CLIENT_ID is correct
- "Need admin approval": UseMICROSOFT_MCP_TENANT_ID=consumersfor personal accounts
- Missing permissions: Ensure all required API permissions are granted in Azure
- Token errors: Delete~/.microsoft_mcp_token_cache.jsonand re-authenticate

Integrates with the Cal.com Calendar API for appointment scheduling.

Manage schedules using the Dooray API. Requires API key, member ID, and calendar ID to be configured.

Local email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCP. Apache-2.0 licensed.

Connects AI agents to the Feishu/Lark platform to automate document processing, conversation management, and calendar scheduling via its OpenAPI.

Connect AI agents to Feishu/Lark APIs for automating tasks like document processing, conversation management, and calendar scheduling.

Connect AI agents to Feishu/Lark APIs for document processing, conversation management, and calendar scheduling.

Integrates with the Google Calendar API to read, create, update, and delete calendar events.

A service for managing multiple email accounts from various providers like 163, Gmail, QQ, and Outlook.

Interact with Microsoft Outlook for calendar management, email operations, and search functionality.

Calculate the dollar value of hours lost to unnecessary meetings and get the data you need to reclaim your day direct from your Google or Microsoft calendar.