outlook-mcp

Connect the Outlook/Microsoft 365 calendar with MCP (Model Context Protocol) to automate the agent's schedule querying/creating/modifying/deleting. > Acknowledgements: This initial version was quickly 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 # Enter Azure AD information in the .env file # 3. Run the server uv run outlook-mcp ``` ## Features - Schedule querying/creating/modifying/deleting - Microsoft account OAuth authentication - Support for Claude Desktop integration ## Add to Claude Desktop Add to the Claude Desktop configuration file: ```json { "mcpServers": { "outlook-calendar": { "command": "uv", "args": ["run", "outlook-mcp"], "cwd": "/path/to/your/outlook_mcp" } } } ``` **Configuration file location:** - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` ## Usage Example Use in Claude as follows: ``` Show me my schedule for this week Please add a team meeting to my schedule at 2 PM tomorrow ``` ## 📁 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 # Check environment variables │ └── test_client.py # Functionality testing └── 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)