ms-graph-mcp

<p align="center"> </p>

<h1 align="center">Microsoft Graph MCP Package</h1>

<p align="center"> <b>Seamless Microsoft Graph Integration for AI Agents.</b> </p>

A TypeScript MCP (Model Context Protocol) package for personal Microsoft Graph access via CLI. This package enables AI agents to interact with personal Microsoft Graph APIs (Outlook, Calendar, etc.) through a local CLI interface.

• Local-First: Prioritizes local execution and user data control.
• Multi-Tenant Support: Works with both personal Microsoft accounts and enterprise tenants.
• Secure Authentication: Implements OAuth 2.0 Authorization Code Flow with PKCE.
• Secure Token Storage: Stores the MSAL token cache at ~/.config/ms-graph-mcp/msal_cache.json with restricted file permissions (0600).
• User Control: Provides CLI commands for permission management and revocation.
• MCP Standard: Adheres to the Model Context Protocol for broad agent compatibility.

This package is designed to be integrated as a connection within the Manus UI, allowing AI agents to directly invoke its functionalities. It communicates via stdio, sending and receiving JSON payloads.

Before using the MCP CLI, you need to initialize it once to authenticate with your Microsoft account. This process will guide you through granting necessary permissions.

bunx --bun @frustrated/ms-graph-mcp init

This will:

1. Start a local HTTP server to receive the OAuth callback.
2. Print an authentication URL — open it in your browser to sign in.
3. Grant consent for the requested scopes.
4. Save the MSAL token cache to ~/.config/ms-graph-mcp/msal_cache.json.

Once initialized, Manus agents will typically run the MCP server to interact with Microsoft Graph. The server listens for JSON requests on stdin and outpu