MCP.so
Sign In

Outlook MCP (Model Context Protocol) Server

@kacase

About Outlook MCP (Model Context Protocol) Server

An MCP Server for Microsoft Outlook using GraphAPI

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "outlook": {
      "command": "npx",
      "args": [
        "mcp_outlook"
      ],
      "env": {
        "AUTHORITY": "your-authority-id",
        "CLIENT_ID": "your-client-id",
        "MCP_SERVER_NAME": "outlook-mcp",
        "MCP_SERVER_VERSION": "1.0.0"
      }
    }
  }
}

Tools

17

Lists the user's calendar events for a specified time range

Creates a new calendar event. Ensure availability and user confirmation before sending invites.

Gets details of a specific calendar event

Updates an existing calendar event

Deletes a calendar event

Lists the user's emails from a specified folder

Sends a new email message

Gets details of a specific email message

Creates a draft email message without sending it

Marks an email message as read

Marks an email message as unread

Deletes an email message

Searches for people relevant to the current user (colleagues, contacts, etc.)

Gets details of a specific person by ID

Gets free/busy schedule information for specified users

Finds suitable meeting times for a group of attendees. Correct E-Mail addresses are required.

Adds one or more attendees to an existing calendar event. Fetches the event, merges new attendees with existing ones (avoiding duplicates), and updates the event.

Overview

What is Outlook MCP (Model Context Protocol) Server?

A Model Context Protocol server that integrates with Microsoft Outlook through Microsoft Graph API, allowing Claude and other LLMs to check calendar events, schedule new ones, read emails, and send messages.

How to use Outlook MCP (Model Context Protocol) Server?

Install via npx and configure the server in your Claude Desktop config with your Azure App registration details. Set the environment variables AUTHORITY (Tenant ID), CLIENT_ID, MCP_SERVER_NAME, and MCP_SERVER_VERSION. Run npx mcp_outlook or point to a local build.

Key features of Outlook MCP (Model Context Protocol) Server

  • Calendar event CRUD operations (list, create, get, update, delete)
  • Email CRUD operations (list, get, send, draft, mark read/unread, delete)
  • People search and retrieval within the organization
  • Full TypeScript implementation with Zod validation
  • Complies with Model Context Protocol for LLM tool integration

Use cases of Outlook MCP (Model Context Protocol) Server

  • Have an LLM check your upcoming calendar events and suggest meeting times
  • Automate sending emails or drafting replies via natural language instructions
  • Manage email inbox: mark as read, delete, or move messages
  • Search for a colleague’s contact details and schedule a meeting with them

FAQ from Outlook MCP (Model Context Protocol) Server

What prerequisites are needed?

Node.js 18+, a Microsoft 365 account, and an Azure App Registration with Graph API delegated permissions for Calendar and Mail.

What Graph API permissions are required?

For Calendar: Calendars.Read and Calendars.ReadWrite. For Email: Mail.Read, Mail.ReadWrite, and Mail.Send. For People: People.Read.

How do I set up the Azure App Registration?

Go to Azure Portal, create a new App Registration, add http://localhost as a redirect URI (Public client/native), and note the Client ID and Tenant ID.

Does the server run locally or via npx?

You can run it directly via npx mcp_outlook or by pointing Claude Desktop to a local build using node with the absolute path to build/index.js.

What data does it access?

It accesses your Microsoft 365 calendar events, emails, and people contacts on your behalf using delegated permissions.

Frequently asked questions

What prerequisites are needed?

Node.js 18+, a Microsoft 365 account, and an Azure App Registration with Graph API delegated permissions for Calendar and Mail.

What Graph API permissions are required?

For Calendar: `Calendars.Read` and `Calendars.ReadWrite`. For Email: `Mail.Read`, `Mail.ReadWrite`, and `Mail.Send`. For People: `People.Read`.

How do I set up the Azure App Registration?

Go to Azure Portal, create a new App Registration, add `http://localhost` as a redirect URI (Public client/native), and note the Client ID and Tenant ID.

Does the server run locally or via npx?

You can run it directly via `npx mcp_outlook` or by pointing Claude Desktop to a local build using `node` with the absolute path to `build/index.js`.

What data does it access?

It accesses your Microsoft 365 calendar events, emails, and people contacts on your behalf using delegated permissions.

Comments

More Communication MCP servers