MCP-MSGraph

Name: MCP-MSGraph
Author: kevinbellinger

@kevinbellinger

Repository

About MCP-MSGraph

A prototype MCP server which reads a user profile from Microsoft Graph.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-msgraph": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP-MSGraph?

MCP-MSGraph is a prototype MCP (Model Context Protocol) server that reads a user profile from Microsoft Graph. It serves as a proof of concept for connecting MCP to data stored in Microsoft Graph.

How to use MCP-MSGraph?

Clone the repository, create a Python virtual environment, install the required packages (fastapi, uvicorn, requests, requests-oauthlib, pydantic), then edit main.py to replace placeholder values with your Azure AD Application ID, Tenant ID, and Client Secret. Start the server with uvicorn main:app --reload and send an HTTP POST request to http://localhost:8000/mcp with a JSON body containing action, contextId, and data.userId.

Key features of MCP-MSGraph

Reads a user profile from Microsoft Graph via a single MCP action (readUserProfile)
Uses OAuth2 authentication with Azure AD
Runs as a local FastAPI server
Accepts requests over HTTP at the /mcp endpoint

Use cases of MCP-MSGraph

Demonstrating how an MCP server can retrieve personal data from Microsoft Graph
Prototyping AI assistants that need to query Microsoft 365 user profiles
Testing MCP integration with Microsoft identity and data platforms

FAQ from MCP-MSGraph

What exactly does MCP-MSGraph do?

It reads a user profile from Microsoft Graph using the readUserProfile action. It is a prototype and proof of concept, not a production‑ready server.

How do I get the credentials needed to run MCP-MSGraph?

You must create an Azure AD application in the Azure Portal, note the Application (client) ID and client secret, and add the User.Read.All API permission (delegated or application, with admin consent).

What are the runtime dependencies for MCP-MSGraph?

Python 3, plus the packages fastapi, uvicorn, requests, requests-oauthlib, and pydantic.

How can I test MCP-MSGraph after starting it?

Send a curl request like: curl -X POST http://localhost:8000/mcp -H "Content-Type: application/json" -d '{"action":"readUserProfile","contextId":"abc123","data":{"userId":"[email protected]"}}'. A successful response returns a JSON object with the user’s profile data.