outlook-mcp

An MCP server that gives the agent access to mail, calendar, OneDrive files and Power Automate flows through Microsoft Graph

  • 455 ★ on the repository
  • Last commit
MCP server

Broad access

Why this level

  • Reads and sends mail, changes calendar and files
  • Handles a client secret and access tokens
  • Can trigger Power Automate flows
All reasons and checks

ryaker/outlook-mcp

Install

Manual install

git clone https://github.com/ryaker/outlook-mcp.git
cd outlook-mcp
npm install

Then register an Azure app and set the environment variables.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Reads and sends mail, changes calendar and files
  • Handles a client secret and access tokens
  • Can trigger Power Automate flows

This is third-party code. Review the repository files before installing.

What it does

outlook-mcp connects the agent to Microsoft 365 services through Microsoft Graph. It exposes mail tools: list, search, read, send, mark as read, plus folders and rules. For the calendar it can list, create, accept, decline and delete events. It also covers OneDrive with list, search, download, upload and share links, and it can trigger Power Automate flows and view their run history. The server runs locally and connects to Claude via MCP config, with access granted over OAuth.

Who it is for. For people on Microsoft 365 who want to hand mail, calendar and files to an agent.

Good fit when

  • You want the agent to triage and send Outlook mail
  • You need to work with calendar events and mail folders
  • You need to fetch and share OneDrive files or run Power Automate flows

Not a fit when

  • You have no Microsoft 365 account or Azure app registration
  • You cannot trust the agent to send mail and act on work data

Example request

Show my latest Outlook emails and create a calendar event for tomorrow at 3 pm

MCP

Transport
stdio
Authentication
OAuth

Environment variables

OUTLOOK_CLIENT_ID required
Application client ID from the Azure app registration.
OUTLOOK_CLIENT_SECRET required, secret
The Azure app client secret value.
MS_TENANT_ID
Tenant ID for single-tenant apps.

Limitations

You need a Microsoft 365 account and an Azure app registration with the right permissions and a client secret. The repository has no license file. Power Automate support is limited: only solution-aware, manual-trigger flows are reachable.

How to disable. Remove the server from the client's MCP config, delete the token file ~/.outlook-mcp-tokens.json and the repository folder.

FAQ

Which services are supported?

Outlook mail and calendar, OneDrive files and folders, and Power Automate.

How does sign-in work?

Through OAuth 2.0 with Microsoft Graph, and tokens are saved locally in a file in your home directory.

Discussion

No questions or reviews yet.

Official

A local MCP server for Mac and Windows that lets an agent work with mail, messengers, calendars and files.

MCP serverBroad access80Repository stars

An MCP gateway with OAuth, Entra roles and send confirmation for 21Vianet Microsoft 365: mail, calendar, files, Teams

MCP serverBroad access90Repository stars

Microsoft 365 MCP Server

ms-365-mcp-server

An unofficial MCP server for Microsoft 365 and Office through the Graph API: mail, files, calendar, sign-in with a Microsoft account and an organization mode

MCP serverBroad access1.1KRepository stars

An email MCP with 52 tools: the agent reads, searches, sends and sorts mail across several accounts over IMAP and SMTP, and schedules sends

MCP serverBroad access158Repository stars

MCP email server over IMAP and SMTP: an agent searches, reads, sorts and sends mail across several mailboxes

MCP serverBroad access391Repository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
outlook-mcp (this card)noOAuth455
Thunderbird MCPnoAPI key443a Thunderbird extension and MCP bridge
Nextcloud MCP ServernoAPI key411connects an agent to Nextcloud

README in short

The README presents the server as a Microsoft 365 assistant over Microsoft Graph and Power Automate. It lists tools across three areas: Outlook mail and calendar, OneDrive files, and Power Automate flows. It walks through Azure app registration, the required permissions, the client secret, and the environment variables. It shows a Claude Desktop config that launches via node plus an OAuth sign-in. There is a test mode with mock data and a troubleshooting section.

README badge

Report a problem