M365 Copilot

v1.0.0Cloud Servicesstable

M365 Copilot MCP Server - Model Context Protocol server for Microsoft 365 Copilot integration

m365copilotmcpai-integration
Share:
14
Stars
0
Downloads
0
Weekly
0/5

What is M365 Copilot?

M365 Copilot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to m365 copilot mcp server - model context protocol server for microsoft 365 copilot integration

M365 Copilot MCP Server - Model Context Protocol server for Microsoft 365 Copilot integration

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • M365 Copilot MCP Server - Model Context Protocol server for

Use Cases

Integrate Microsoft 365 Copilot with MCP servers.
chenxizhang

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMar 4, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx m365copilot

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use M365 Copilot

The M365 Copilot MCP Server exposes Microsoft 365 Copilot's indexed organizational data — emails, Teams chats, meeting transcripts, SharePoint documents, and people records — to any MCP-compatible AI client via three focused tools: retrieval, search, and conversational chat. It uses OAuth 2.0 browser authentication on first run, falling back to Device Code Flow on headless systems, so setup requires no manual token management. Developers and knowledge workers who want to query their M365 corpus through Claude Desktop, GitHub Copilot, or other MCP clients will benefit from this server.

Prerequisites

  • Node.js 20 or higher installed
  • A Microsoft 365 account with an active Microsoft 365 Copilot license
  • Microsoft Graph delegated permissions: Sites.Read.All, Files.Read.All, Mail.Read, Chat.Read, ChannelMessage.Read.All, OnlineMeetingTranscript.Read.All, People.Read.All, ExternalItem.Read.All
  • An MCP-compatible client: Claude Desktop, Claude Code, or GitHub Copilot (VS Code)
1

Add the server to Claude Code via CLI

The easiest setup uses the Claude Code CLI to register the npx-based server directly. On Windows, use the cmd wrapper instead.

# macOS / Linux:
claude mcp add --scope user --transport stdio m365-copilot -- npx -y m365-copilot-mcp

# Windows:
claude mcp add --scope user --transport stdio m365-copilot -- cmd /c "npx -y m365-copilot-mcp"
2

Or configure Claude Desktop manually

If you prefer Claude Desktop, add the server entry directly to the configuration file.

{
  "mcpServers": {
    "m365-copilot": {
      "command": "npx",
      "args": ["-y", "m365-copilot-mcp"]
    }
  }
}
3

Authenticate with Microsoft 365 on first run

The server automatically opens a browser window for Microsoft 365 OAuth login the first time it runs. On headless systems it prints a Device Code Flow URL and code — open that URL in any browser and enter the code.

4

Optionally configure a custom Azure AD app

If your organization requires a custom app registration instead of the built-in credentials, set these optional environment variables.

{
  "mcpServers": {
    "m365-copilot": {
      "command": "npx",
      "args": ["-y", "m365-copilot-mcp"],
      "env": {
        "AZURE_CLIENT_ID": "your-custom-app-client-id",
        "AZURE_TENANT_ID": "your-tenant-id",
        "REDIRECT_URI": "http://localhost"
      }
    }
  }
}

M365 Copilot Examples

Client configuration

Claude Desktop configuration for the M365 Copilot MCP server using npx.

{
  "mcpServers": {
    "m365-copilot": {
      "command": "npx",
      "args": ["-y", "m365-copilot-mcp"]
    }
  }
}

Prompts to try

Example prompts using the three M365 Copilot tools: retrieval, search, and chat.

- "Search my Microsoft 365 for documents about the 2025 budget proposal."
- "Retrieve the transcript from my last Teams meeting with the engineering team."
- "Find emails from last week about the product launch."
- "What did my colleague mention about project timelines in our recent chat?" (uses m365copilotchat with timezone "America/New_York")

Troubleshooting M365 Copilot

Browser does not open for authentication on macOS

Ensure your terminal has permission to open URLs. Try running 'npx -y m365-copilot-mcp' directly in your terminal first — it will print the auth URL you can open manually. On headless systems it automatically falls back to Device Code Flow.

Permission errors or empty search results

The signed-in Microsoft 365 account must have an active Copilot license and the required Graph API permissions. Confirm with your IT admin that the account has access to Chat.Read, ChannelMessage.Read.All, and Files.Read.All.

m365copilotchat tool fails with timezone errors

The m365copilotchat tool requires an IANA timezone string (e.g., 'America/New_York', 'Europe/London'). Make sure your prompt or the tool call includes a valid IANA timezone identifier, not an abbreviation like 'EST'.

Frequently Asked Questions about M365 Copilot

What is M365 Copilot?

M365 Copilot is a Model Context Protocol (MCP) server that m365 copilot mcp server - model context protocol server for microsoft 365 copilot integration It connects AI assistants to external tools and data sources through a standardized interface.

How do I install M365 Copilot?

Follow the installation instructions on the M365 Copilot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with M365 Copilot?

M365 Copilot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is M365 Copilot free to use?

Yes, M365 Copilot is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "m365copilot": { "command": "npx", "args": ["-y", "m365copilot"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use M365 Copilot?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides