outlook-mcp

# Outlook Calendar MCP Server Outlook/Microsoft 365 calendars are connected via MCP(Model Context Protocol) to automate agent scheduling, querying, creating, editing, and deleting. > Acknowledgements: This initial version was rapidly prototyped by VibeCoding. ## Quick Start ```bash # 1. Install dependencies uv sync --python=3.11 --prerelease=allow # 2. Set environment variables cp env_example.txt .env # Fill in Azure AD information in .env file # 3. Run server uv run outlook-mcp ``` ## Features - Schedule query/create/edit/delete - Microsoft account OAuth authentication - Claude Desktop integration support ## Add to Claude Desktop Add to Claude Desktop settings file: ```json { "mcpServers": { "outlook-calendar": { "command": "uv", "args": ["run", "outlook-mcp"], "cwd": "/path/to/your/outlook_mcp" } } } ``` **Settings file location:** - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` ## Usage Examples Use in Claude like this: ``` Show me my schedule for this week Add a team meeting schedule for tomorrow at 2 PM ``` ## 📁 Project Structure ``` outlook_mcp/ ├── src/ # Core library │ ├── mcp_server.py # MCP + FastAPI integrated server │ ├── auth_manager.py # OAuth authentication management │ ├── outlook_client.py # Microsoft Graph API client │ └── config.py # Configuration management ├── scripts/ # Utility tools │ ├── check_env.py # Environment variable check │ └── test_client.py # Function test └── docs/ # Documentation ├── azure_ad_setup.md # Azure AD setup guide └── claude_setup.md # Claude Desktop setup ``` ## Documentation - [Azure Entra ID Setup Guide](docs/azure_ad_setup.md) - [Claude Desktop Setup](docs/claude_setup.md)