outlook-mcp
The Modular Outlook MCP Server connects the Claude application with Microsoft Outlook using the Microsoft Graph API. It features a modular design, supporting email management and authentication, and can be configured and extended for additional functionalities.
Modular Outlook MCP Server
This project implements a modular Outlook MCP Server that integrates with Microsoft Outlook via the Microsoft Graph API.
Features
- Authentication: OAuth 2.0 with Microsoft Graph API.
- Email Management: Capabilities to list, search, read, and send emails.
- Modular Structure: Separation of concerns for maintainability.
- OData Filter Handling: Manage OData query formatting.
- Test Mode: Test without real API calls.
Azure App Registration & Configuration
Steps include registering an app in the Azure Portal, configuring permissions, and setting up a client secret. Specific permissions needed include offline_access, User.Read, Mail.Read, and others.
Configuration
Configure server parameters by editing config.js
. Adjust server name, version, test mode, authentication, email settings, and API endpoints.
Usage with Claude Desktop
Instructions on integrating with Claude Desktop through configuration, authentication, and usage of email tools.
Running Standalone
You can test the server standalone with ./test-modular-server.sh
.
Authentication Flow
Authentication involves starting a local server, using a tool to get URLs, and storing tokens.
Troubleshooting
Detailed steps for resolving issues related to authentication, OData filters, and API calls.
Extending the Server
Instructions for adding functionality, creating modules, implementing handlers, and exporting tools.