Microsoft 365 MCP Server

Microsoft 365 MCP Server

An MCP server that gives Claude Desktop and Claude Code access to your Microsoft 365 email (Outlook) and calendar via Microsoft Graph API.

Quick Start Overview

Setting up this MCP server requires two main steps:

1. Azure AD Setup (5-10 minutes, one-time): Create an app registration in Azure to get your credentials
2. Local Installation (5 minutes): Install the server and configure Claude Desktop or Claude Code

Both are detailed below with step-by-step instructions.

Tools Included

Azure AD Setup (Required First)

Before you can use this MCP server, you need to create an Azure AD App Registration to get your MS_CLIENT_ID and MS_TENANT_ID. This only needs to be done once.

Step 1: Create the App Registration

1. Go to the Azure Portal

   • Navigate to portal.azure.com
   • Sign in with your Microsoft 365 account

2. Access App Registrations

   • In the top search bar, type "App registrations"
   • Click on App registrations from the search results

3. Create New Registration

   • Click "+ New registration" button at the top
   • Fill in the registration form:
     • Name: MS365 MCP Server (or any name you prefer)
     • Supported account types: Select "Accounts in this organizational directory only (Single tenant)"
     • Redirect URI:
       • Select "Mobile and desktop applications" from the dropdown
       • Enter: http://localhost
   • Click "Register" button

4. Copy Your Credentials

   • You'll be taken to the app's Overview page
   • Copy and save these two values (you'll need them later):
     • Application (client) ID → This is your MS_CLIENT_ID
     • Directory (tenant) ID → This is your MS_TENANT_ID
   • Keep these values handy — you'll use them in the setup steps below

Step 2: Set API Permissions

1. Navigate to API Permissions

   • In the left sidebar, click "API permissions"

2. Add Microsoft Graph Permissions

   • Click "+ Add a permission"
   • Select "Microsoft Graph"
   • Select "Delegated permissions"

3. Add Required Permissions

   • Search for and add each of these permissions:
     • ✅ Mail.Read - Read your emails
     • ✅ Mail.ReadWrite - Create and manage email drafts
     • ✅ Mail.Send - Send emails from your account
     • ✅ Calendars.Read - Read your calendar
     • ✅ User.Read - Read basic profile information
   • Click "Add permissions" when done

4. Grant Admin Consent

   • Back on the API permissions page, look for the "Grant admin consent for [Your Organization]" button
   • If you're an admin: Click the button and confirm
   • If you're not an admin: Ask your IT administrator to grant consent
   • You should see green checkmarks under the "Status" column for all permissions

Step 3: Verify Your Setup

Your Azure configuration is complete when you have:

• ✅ Application (client) ID copied
• ✅ Directory (tenant) ID copied
• ✅ All five permissions added and granted (green checkmarks)

Now you're ready to proceed with the local installation!

Local Installation

Prerequisites

• Python 3.10+
• Claude Desktop or Claude Code CLI installed
• MS_CLIENT_ID and MS_TENANT_ID from Azure setup above

Step 1: Clone or Download the Project

Copy the ms365-mcp-server folder to a permanent location on your machine:

# Example: put it in your home directory
cp -r ms365-mcp-server ~/ms365-mcp-server
cd ~/ms365-mcp-server

Step 2: Create a Virtual Environment and Install Dependencies

cd ~/ms365-mcp-server
python3 -m venv .venv
source .venv/bin/activate       # macOS/Linux
# .venv\Scripts\activate        # Windows

pip install -r requirements.txt

Step 3: First-Time Authentication

Run the server once manually to complete the interactive Microsoft login:

cd ~/ms365-mcp-server
source .venv/bin/activate

export MS_CLIENT_ID="your-client-id-here"
export MS_TENANT_ID="your-tenant-id-here"

python server.py

This will open your browser for Microsoft login. Sign in and grant permissions. Once done, a token_cache.json file is created — this stores your refresh token so you won't need to log in again (token