# Microsoft 365 MCP Server

> Microsoft 365 MCP Server is an open-source MCP server for productivity. 300+ Microsoft Graph tools for Outlook, Calendar, OneDrive, Teams and SharePoint. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/softeria/ms-365-mcp-server
- **MCP Registry name:** io.github.Softeria/ms-365-mcp-server
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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)

## 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.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/microsoft-365-mcp-server
