Outlook MCP

This is a modular Outlook MCP server project that integrates Claude with Outlook through the Microsoft Graph API, providing functions such as authentication and email management.

Communication tools Artificial intelligence chatbots #Email management #Modular #API integration #Authentication service .JavaScript

rating : 2.5 points

downloads : 44

update time : 2025-04-28

What is the Outlook MCP Server?

This is a modular server program that allows the Claude AI assistant to access your Microsoft Outlook mailbox via standard protocols. It provides secure email management functions, including operations such as viewing, searching, and sending emails.

How to use the Outlook MCP Server?

Before use, you need to authorize your Microsoft account first. Then you can directly manage your Outlook mailbox through the Claude interface. The whole process is secure and convenient, without the need to handle complex API calls directly.

Applicable scenarios

Suitable for users who need to manage emails through an AI assistant, especially in scenarios where they need to quickly find important emails, automatically organize the inbox, or intelligently compose email replies.

Main features

Security authenticationUses the OAuth 2.0 protocol to perform secure authentication with the Microsoft Graph API, ensuring the security of account information

Email managementSupports complete email operation functions such as listing, searching, reading, and sending emails

Modular designAdopts a clear modular structure, facilitating function expansion and maintenance

Test modeProvides a simulated data function, allowing you to test functions without connecting to the real API

Advantages and limitations

Advantages

No need to directly operate the complex Graph API. You can manage emails through simple instructions

The modular design makes function expansion simple and convenient

The complete test mode facilitates development and debugging

Follows standard protocols and integrates seamlessly with Claude

Limitations

Currently only supports basic email functions and does not support calendar and contact management

Users need to manually authorize access to the mailbox

Advanced search functions require knowledge of OData query syntax

How to use

Configure Claude

Copy the configuration in claude - config - sample.json to the configuration file of Claude Desktop

Start the server

Run the test script to start the local server

Account authorization

Use the authenticate tool in Claude to obtain the authorization link and complete the Microsoft account login

Start using

After authorization is completed, you can use various email management tools

Usage examples

Find important customer emailsQuickly find emails from specific customers that contain the keyword 'contract'

Intelligent email replyAutomatically generate a reply based on the received email content

Organize the inboxMove emails that meet specific conditions to the specified folder

Frequently Asked Questions

How do I know if the authorization is successful?

Why can't I find some emails?

How to expand more functions?

What is the difference between the test mode and the real mode?

Related resources

Microsoft Graph API documentation

Official Graph API reference documentation

OData query syntax guide

Official guide to the OData query language

Project GitHub repository

Server source code and latest version

🚀 Modular Outlook MCP Server

This is a modular implementation of an Outlook MCP (Model Context Protocol) server, which is used to connect Claude with Microsoft Outlook via the Microsoft Graph API.

🚀 Quick Start

This modular Outlook MCP server enables seamless integration between Claude and Microsoft Outlook using the Microsoft Graph API. Below are the steps and details to get you started.

📦 Installation

Configuration

To configure the server, edit the config.js file to modify the following settings:

Server name and version
Test mode settings
Authentication parameters
Email field selection
API endpoints

💻 Usage Examples

Usage on Claude Desktop

Copy the example configuration from claude-config-sample.json to your Claude Desktop configuration.
Restart Claude Desktop.
Use the authenticate tool for Microsoft authentication.
Manage your Outlook account using the email tools.

Stand - alone Operation

To test the server, use the following command:

./test-modular-server.sh

This will directly connect to the server using the MCP Inspector, allowing you to test the available tools.

✨ Features

Authentication: Microsoft Graph API authentication based on OAuth 2.0.
Email Management: List, search, read, and send emails.
Modular Structure: Clear separation of concerns for easy maintenance.
OData Filter Handling: Proper escaping and formatting of OData queries.
Test Mode: Use mock responses for testing without actual API calls.

📚 Documentation

Directory Structure

/modular/
├── index.js                 # Entry point
├── config.js                # Configuration settings
├── auth/                    # Authentication module
│   ├── index.js             # Authentication export
│   ├── token-manager.js     # Token storage and refresh
│   └── tools.js             # Authentication - related tools
├── email/                   # Email functionality
│   ├── index.js             # Email export
│   ├── list.js              # List emails
│   ├── search.js            # Search emails
│   ├── read.js              # Read emails
│   └── send.js              # Send emails
└── utils/                   # Utility functions
    ├── graph-api.js         # Microsoft Graph API helper
    ├── odata-helpers.js     # OData query construction
    └── mock-data.js         # Test mode data

Authentication Process

Start the local authentication server on port 3333 (using outlook-auth-server.js).
Use the authenticate tool to obtain the authentication URL.
Complete the authentication in the browser.
Tokens are stored in ~/.outlook-mcp-tokens.json.