MCP.so
Sign In

MCP MSGraph

@kevinbellinger

Basic information

Category

Other

Transports

stdio

Author

kevinbellinger

About MCP MSGraph

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

MCP MSGraph config

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

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

MCP MSGraph tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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).

3

What are the runtime dependencies for MCP-MSGraph?

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

4

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":"someUser@yourtenant.onmicrosoft.com"}}'`. A successful response returns a JSON object with the user’s profile data.

Comments

More Other MCP servers