What is an MCP Server?

An MCP (Model Context Protocol) Server acts as a bridge, allowing AI models to access and interact with external data sources and tools using a standardized interface.

What is Microsoft Graph?

Microsoft Graph is a RESTful web API that enables you to access Microsoft Cloud service resources, such as user and group data in Microsoft Entra ID.

How does the Microsoft Graph MCP Server help?

It connects AI assistants like Claude to Microsoft Graph, allowing them to securely query data from Microsoft Entra ID, such as user and group information.

What are the prerequisites for using this MCP server?

You need Node.js 14+, Python 3.8+, a Microsoft Entra ID App Registration with appropriate permissions, and optionally, API keys for securing the server.

How do I create a Microsoft Entra ID App Registration?

Follow the steps in the documentation to register a new application in the Azure Portal, grant it the necessary API permissions, and create a client secret.

What tools are available in the MCP server?

The server exposes tools like listUsers, getUser, searchUsers, listGroups, and getGroupMembers to retrieve data from Microsoft Entra ID.

How is security handled?

API key authentication is used (but bypassed for AI assistants), client credentials are used for Microsoft Graph authentication, and it’s recommended to use the principle of least privilege when assigning API permissions.

How do I integrate this server with Claude?

Configure Claude Desktop by adding a new MCP server entry, referencing the GitHub repository, and providing your tenant ID, client ID, and client secret in the environment variables.

Can I extend the server to add more Microsoft Graph API capabilities?

Yes, you can add new tool definitions in the add_graph_tools function and implement the corresponding handler function.

What do I do if I get an “Invalid API Key Error”?

Ensure the API key in your client configuration matches one of the keys in your environment variables, or set AI_ASSISTANT=true when using with AI assistants.

What is UBOS?

UBOS is a full-stack AI Agent Development Platform that helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model and Multi-Agent Systems.