outlook-mcp

outlook-mcp

61

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.