How do I install the graph mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `GRAPH_TOKEN_ENCRYPTION_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Graph MCP Server

MCP server for Microsoft Teams, Outlook Calendar, Mail, and OneDrive via Microsoft Graph

Remote serverstreamable-httpPython

What is the Graph MCP Server?

MCP server for Microsoft Teams, Outlook Calendar, Mail, and OneDrive via Microsoft Graph

What the server does

Graph MCP is a Node.js MCP server that connects Claude Code and Codex to Microsoft Teams, Outlook mail and calendar, online meetings, OneDrive, users, and presence through Microsoft Graph. It runs locally over stdio and requires Node.js 22 or newer.

Credentials and setup notes

Node.js 22 or newer. - A Microsoft Entra ID app registration configured as a public client on the Mobile and desktop applications platform. - Redirect URI http://localhost:3000/auth/callback. - No client secret. Graph MCP uses delegated user authentication. Add these exact delegated permissions to the app registration: - offline_access - openid - profile - User.Read -

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
offline_access	openid
profile	User.Read
tokens-v2.enc	encrypted token data

How to install the Graph MCP Server

{
  "mcpServers": {
    "graph": {
      "command": "npx",
      "args": ["-y", "vitest"],
      "env": {
        "AZURE_CLIENT_ID": "your-value",
        "AZURE_TENANT_ID": "your-value",
        "GRAPH_TOKEN_ENCRYPTION_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Node.js 22 or newer. - A Microsoft Entra ID app registration configured as a public client on the Mobile and desktop applications platform. - Redirect URI http://localhost:3000/auth/callback. - No client secret. Graph MCP uses delegated user authentication. Add these exact delegated permissions to the app registration: - offline_access - openid - profile - User.Read -

Variable	Description	Required
AZURE_CLIENT_ID	Configuration value read at startup.	Optional
AZURE_TENANT_ID	Configuration value read at startup.	Optional
GRAPH_TOKEN_ENCRYPTION_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Graph MCP to offline access.”
“Use Graph MCP to profile.”
“Use Graph MCP to User.ReadBasic.All.”

Frequently asked questions

MCP server for Microsoft Teams, Outlook Calendar, Mail, and OneDrive via Microsoft Graph Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.