Claude Integration with MCP for Microsoft Graph API

What is Claude Integration with MCP for Microsoft Graph API?

This repository provides a complete solution for integrating Claude with a Model Context Protocol (MCP) server to access Microsoft Graph API. It is designed for developers who want to use Claude to query and manage Microsoft 365 data through Graph API endpoints.

How to use Claude Integration with MCP for Microsoft Graph API?

Clone the repository, then install dependencies for both the mcp-server and claude-app directories using npm install. Configure environment variables by copying .env.example files and editing them with your Azure AD credentials and Anthropic API key. Start the MCP server with npm start in the mcp-server directory, then start the Claude application with npm start in the claude-app directory. Use the provided test-client.js or curl to test endpoints.

Key features of Claude Integration with MCP for Microsoft Graph API

• Step-by-step integration guide for Claude and MCP server
• MCP server making requests to Microsoft Graph API
• Claude application with chat and organization analysis endpoints
• Environment variable configuration for Azure AD and Anthropic API
• Customizable system prompt and specialized Graph API functions
• Optional caching with Redis and Docker support

Use cases of Claude Integration with MCP for Microsoft Graph API

• Querying organizational users and groups using natural language in Claude
• Analyzing organizational data (e.g., user counts, directory structure)
• Automating Graph API interactions through Claude’s chat interface
• Securing access to Microsoft 365 data with Azure AD authentication
• Building custom AI assistants that can manage Microsoft Graph resources

FAQ from Claude Integration with MCP for Microsoft Graph API

What credentials are required to set up the integration?

You need an Azure AD tenant ID, client ID, and client secret from the Azure Portal, plus an Anthropic API key. These are configured in the respective .env files.

How can I test the MCP server after setup?

Use the provided test-client.js script in the mcp-server directory, or send a curl request to http://localhost:3000/api/graph with the appropriate headers and JSON body.

Is the consistencyLevel parameter supported?

The consistencyLevel parameter is generally not supported in many Graph API configurations and has been removed from all default requests. You can manually add it to queryParams if needed, but test carefully.

What security considerations are covered?

The MCP server uses Azure AD authentication, and the Claude application should implement proper authentication. Role-based access control, data retention policies, and audit logging are recommended for sensitive operations.

How do I troubleshoot JSON parsing errors?

Ensure requests use valid JSON with double quotes for keys and string values. Do not nest JSON strings improperly or use single quotes. Check the request format in test-client.js for examples.