MCP.so
Sign In

MCP-MSGraph

@kevinbellinger

Repository

About MCP-MSGraph

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

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.

Frequently asked questions

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.

Comments

Basic information

Category

Other

Transports

stdio

Author

kevinbellinger

More Other MCP servers

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

ICSS

chokcoco

不止于 CSS

20.7K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K