Skip to content
MCP server

Microsoft 365 MCP Server

300+ Microsoft Graph tools for Outlook, Calendar, OneDrive, Teams and SharePoint

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.186.0
Listing updated
today

Similar MCP servers

About Microsoft 365 MCP Server

Microsoft 365 MCP Server is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Each tool maps one-to-one to a Microsoft Graph endpoint and is defined declaratively in an endpoints file. By default the server exposes personal-account tools covering Outlook mail, Calendar, OneDrive files, Excel, OneNote, To Do, Planner, Contacts, profile and search. An --org-mode flag adds Teams and chats, online meetings with transcripts and recordings, attendance reports, SharePoint sites and lists, shared mailboxes, user management, presence and virtual events.

Limiting the surface is a central design point. You can run read-only, pick a preset, filter tools by regex with --enabled-tools, and add an --allowed-scopes boundary so tools whose Graph scopes are not covered are hidden. --list-permissions prints the exact permissions a configuration needs, useful where admin consent must be pre-approved. An experimental TOON output format is claimed to use 30 to 60 percent fewer tokens than JSON on list-style data.

It authenticates through MSAL and supports the Global, China (21Vianet) and GCC High clouds; GCC High needs your own app registration. Node.js 20 or higher is recommended.

Install

Run in a terminal

claude mcp add ms-365-mcp-server -- npx -y @softeria/ms-365-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ms-365-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ms-365-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ms-365-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ms-365-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ms-365-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

list-mail-messages
List mail messages
get-mail-message
Get one mail message
list-drives
List drives
get-drive-item
Get a drive item
download-bytes
Download file bytes
list-custom-emojis
List Teams custom emojis (org mode)
create-custom-emoji
Create a Teams custom emoji (org mode)

What it does

Personal and org modes
Mail, calendar and files by default; Teams, SharePoint and more with --org-mode.
Read-only mode
Restricts the server to safe read operations.
Scope allowlist
Hides tools whose Graph permissions are outside an allowed scope list.
Tool filtering and presets
Regex filters and presets shrink the tool surface and token use.
Permission listing
--list-permissions reports what admin consent is required.
Multi-cloud
Works with Global, China 21Vianet and GCC High clouds.
TOON output
Experimental compact output format for lists.

Good for

  • Search and summarise Outlook mail from an assistant
  • Schedule meetings and read calendar events
  • Read Excel or OneDrive files in a chat
  • Pre-approve minimal Graph scopes for an enterprise rollout
  • List Teams custom emojis in an organisation

Pricing

Open source

Free npm package; Microsoft 365 licensing applies separately

Microsoft 365 MCP Server FAQ

Which Microsoft clouds work?

Global, China (21Vianet) and GCC High.

How do I enable Teams and SharePoint tools?

Start the server with --org-mode.

Can I make it read-only?

Yes, with the --read-only option.

How do I see which permissions are needed?

Run it with --list-permissions, optionally with --org-mode or a preset.

Is Microsoft 365 MCP Server free?

Yes. Microsoft 365 MCP Server is open source, so you can use and self-host it for free.

How do I add Microsoft 365 MCP Server to Claude Code?

Run this command in your terminal: claude mcp add ms-365-mcp-server -- npx -y @softeria/ms-365-mcp-server

What are the best alternatives to Microsoft 365 MCP Server?

The closest alternatives to Microsoft 365 MCP Server are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers