MSGraph MCP Server

by timfurlongio.github.timfurlong/msgraph-mcpv0.5.1

MCP server for Microsoft Graph: Outlook mail and calendar, plus read-only Microsoft Teams

1Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active19d ago

Install MSGraph MCP server

claude mcp add msgraph -e MSGRAPH_MCP_CLIENT_ID='<msgraph-mcp-client-id>' -e MSGRAPH_MCP_TENANT_ID='<msgraph-mcp-tenant-id>' -- uvx msgraph-mcp-server

{
  "mcpServers": {
    "msgraph": {
      "command": "uvx",
      "args": [
        "msgraph-mcp-server"
      ],
      "env": {
        "MSGRAPH_MCP_CLIENT_ID": "<msgraph-mcp-client-id>",
        "MSGRAPH_MCP_TENANT_ID": "<msgraph-mcp-tenant-id>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "msgraph": {
      "command": "uvx",
      "args": [
        "msgraph-mcp-server"
      ],
      "env": {
        "MSGRAPH_MCP_CLIENT_ID": "<msgraph-mcp-client-id>",
        "MSGRAPH_MCP_TENANT_ID": "<msgraph-mcp-tenant-id>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "msgraph": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "msgraph-mcp-server"
      ],
      "env": {
        "MSGRAPH_MCP_CLIENT_ID": "<msgraph-mcp-client-id>",
        "MSGRAPH_MCP_TENANT_ID": "<msgraph-mcp-tenant-id>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "msgraph": {
      "command": "uvx",
      "args": [
        "msgraph-mcp-server"
      ],
      "env": {
        "MSGRAPH_MCP_CLIENT_ID": "<msgraph-mcp-client-id>",
        "MSGRAPH_MCP_TENANT_ID": "<msgraph-mcp-tenant-id>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
MSGRAPH_MCP_CLIENT_ID	yes	—	Client ID of your Entra (Azure AD) app registration
MSGRAPH_MCP_TENANT_ID	yes	—	Entra tenant ID (or 'common' / 'organizations' / 'consumers')
MSGRAPH_MCP_TOKEN_CACHE_PATH	—	—	Override the token cache location (default ~/.msgraph-mcp/token_cache.bin)

Freshness

Active — last maintenance signal 19d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-21 · 19d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-21 · 19d ago · official registry · v0.5.1

FAQ

›How do I install the MSGraph MCP server in Claude Code?

Run: claude mcp add msgraph -e MSGRAPH_MCP_CLIENT_ID='<msgraph-mcp-client-id>' -e MSGRAPH_MCP_TENANT_ID='<msgraph-mcp-tenant-id>' -- uvx msgraph-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does MSGraph require an API key?

Yes. It expects MSGRAPH_MCP_CLIENT_ID, MSGRAPH_MCP_TENANT_ID.

›Can I use MSGraph as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is MSGraph in the official MCP registry?

Yes, as io.github.timfurlong/msgraph-mcp.