Microsoft MCP

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

Features

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

Quick Start with Claude Desktop

# 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

Usage Examples

# 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 [email protected]

# 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

Available Tools

Email Tools

read_emails - Read emails with full body content
get_email - Get specific email with attachments
reply_to_email - Reply maintaining thread context
send_email - Send with CC/BCC and attachments
mark_email_read - Mark emails as read/unread
move_email - Move between folders
download_attachment - Download email attachments

Calendar Tools

get_calendar_events - List events with full details
check_availability - Check free/busy times
create_event - Create with location and attendees
update_event - Reschedule or modify events
delete_event - Cancel events
respond_to_event - Accept/decline invitations

Contact & File Tools

get_contacts - Search or list contacts
list_files - Browse OneDrive with pagination
upload_file - Upload files to OneDrive
download_file - Download file content
delete_file - Delete files or folders

Utility Tools

search - Universal search across all services
list_accounts - Show authenticated accounts

Manual Setup

1. Azure App Registration

Go to Azure 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:
- Mail.ReadWrite
- Calendars.ReadWrite
- Files.ReadWrite
- Contacts.Read
- People.Read
- User.Read
Copy Application ID

2. Installation

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

3. Authentication

# 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

4. Claude Desktop Configuration

Add to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "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"
      }
    }
  }
}

Or for local development:

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

Multi-Account Support

All tools support an optional account_id parameter:

# Use default account
send_email("[email protected]", "Subject", "Body")

# Use specific account  
send_email("[email protected]", "Subject", "Body", account_id="account-id-here")

# List accounts to get IDs
list_accounts()

Development

# Run tests
uv run pytest tests/ -v

# Type checking
uv run pyright

# Format code
uvx ruff format .

# Lint
uvx ruff check --fix --unsafe-fixes .

Example: AI Assistant Scenarios

Smart Email Management

# Read latest emails with full content
emails = read_emails(count=10, include_body=True)

# Reply maintaining thread
reply_to_email(email_id, "Thanks for your message. I'll review and get back to you.")

# Forward with attachments
email = get_email(email_id)
attachments = [download_attachment(email_id, att["id"]) for att in email["attachments"]]
send_email("[email protected]", f"FW: {email['subject']}", email["body"]["content"], attachments=attachments)

Intelligent Scheduling

# Check availability before scheduling
availability = check_availability("2024-01-15T10:00:00Z", "2024-01-15T18:00:00Z", ["[email protected]"])

# Create meeting with details
create_event(
    "Project Review",
    "2024-01-15T14:00:00Z", 
    "2024-01-15T15:00:00Z",
    location="Conference Room A",
    body="Quarterly review of project progress",
    attendees=["[email protected]", "[email protected]"]
)

Security Notes

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

Troubleshooting

Authentication fails: Check your CLIENT_ID is correct
"Need admin approval": Use MICROSOFT_MCP_TENANT_ID=consumers for personal accounts
Missing permissions: Ensure all required API permissions are granted in Azure
Token errors: Delete ~/.microsoft_mcp_token_cache.json and re-authenticate

License

MIT