M365 MCP Client for Claude: Step-by-Step Setup Guide

Prerequisites

• A Claude account (Free, Pro, Team, or Enterprise; the connector works across plans).
• Microsoft 365 work or school account with access to SharePoint, OneDrive, Outlook, and/or Teams.
• For organization/tenant admins: Global Administrator or appropriate Entra ID role to consent permissions.
• Claude Desktop app (recommended for best MCP experience) or access to Claude.ai / Claude Code.
• Modern web browser for authentication flows.

Note: The official M365 Connector uses Anthropic's hosted MCP implementation. It leverages Microsoft Graph with delegated permissions and does not require running a local server.

Step 1: Enable the M365 Connector (Team & Enterprise Admins)

1. Log in to Claude as an organization owner.
2. Go to Organization settings > Connectors (or Integrations).
3. Click Browse connectors or Add More.
4. Search for and select Microsoft 365 (or "M365 Connector for Claude by Anthropic").
5. Enable the connector for your organization.

This step makes the connector available to team members. Individual users on Free/Pro plans can often connect directly without admin intervention.

Step 2: Admin Consent in Microsoft Entra ID (Required for Most Tenants)

The setup creates two enterprise applications in your tenant:

• M365 MCP Server for Claude
• M365 MCP Client for Claude

Admin steps:

1. Go to the Microsoft Entra admin center.
2. Navigate to Enterprise applications.
3. Search for and select M365 MCP Server for Claude.
4. Go to Permissions > Admin consent tab.
5. Review and grant the requested Microsoft Graph delegated permissions (typically including Files.Read.All, Mail.Read, Calendars.Read, Chats.Read, etc.).
6. Repeat the process for M365 MCP Client for Claude.

Optional: Restrict access

• In each app's Properties, set Assignment required? to Yes.
• Under Users and groups, assign specific users or security groups.

Consent URLs (replace {your-tenant-id}):

• Server: https://login.microsoftonline.com/{your-tenant-id}/adminconsent?client_id=07c030f6-5743-41b7-ba00-0a6e85f37c17
• Client: https://login.microsoftonline.com/{your-tenant-id}/adminconsent?client_id=08ad6f98-a4f8-4635-bb8d-f1a3044760f0

Step 3: Install and Configure Claude Desktop (Recommended)

1. Download and install Claude Desktop if not already installed.
2. Open Claude Desktop.
3. Click the menu (hamburger icon) > Settings > Developer (or Integrations).
4. Look for the Microsoft 365 connector or MCP section.
5. Click Connect or Add Microsoft 365.
6. Follow the Microsoft login flow and grant the requested permissions.

After successful authentication, the connector will appear as an active MCP integration.

Step 4: Connect and Test in Claude

1. Start a new conversation in Claude Desktop (or Claude.ai).
2. Mention the connector explicitly if needed, e.g., "Using my Microsoft 365 data, summarize my recent emails from last week."
3. Try sample prompts:
   • "Search my OneDrive for the latest project proposal document."
   • "Summarize key points from my Teams chat with the marketing team."
   • "List upcoming meetings from my Outlook calendar and suggest preparation notes."
   • "Find and analyze the Q3 financial report in SharePoint."

Claude will automatically use the MCP tools to fetch real-time context from Microsoft 365 via Microsoft Graph.

Example expected behavior: Claude responds with accurate, grounded information pulled directly from your files, emails, or calendar instead of hallucinating.

Step 5: Verify Permissions and Troubleshoot Access

• In Entra ID, check the enterprise apps for granted consents.
• Review sign-in logs for the MCP apps.
• Test with minimal scopes first, then expand permissions as needed.

Common Issues & Troubleshooting

• "Connector not found" or authentication fails: Ensure admin consent is completed and the apps are visible in Entra ID. Try incognito mode or clear browser cache.
• Permission errors: Revisit the Admin consent tab and grant missing Graph permissions. Common ones include Mail.ReadWrite, Files.ReadWrite.All, Calendars.ReadWrite.
• No data returned: Confirm your M365 account has access to the requested resources. The connector uses delegated permissions (on behalf of the signed-in user).
• Enterprise restriction: If "Assignment required" is enabled, ask your admin to assign you to the app.
• Claude Desktop not detecting connector: Restart the app completely (quit from system tray). Check Settings > Developer for MCP servers list.
• Rate limits or delays: Microsoft Graph and Claude have usage quotas; wait a few seconds or reduce complex multi-tool requests.
• Personal vs Work account: The official connector works best with work/school accounts. Personal Microsoft accounts (MSA) may have limited support.

If issues persist, consult the official Claude Help Center article on enabling the Microsoft 365 connector.

Next Steps

• Explore advanced usage: Combine M365 with other MCP servers (e.g., web scraping, code tools, or databases) for powerful multi-tool agent workflows.
• Security best practices: Regularly review granted permissions in Entra ID and revoke if no longer needed. Use least-privilege scopes.
• Build custom extensions: For advanced needs, explore open-source M365 MCP servers like Lokka or PnP CLI for Microsoft 365 (self-hosted options).
• Team adoption: Share this guide with colleagues and monitor usage via Microsoft Entra sign-in logs.

You're now ready to supercharge Claude with your Microsoft 365 data for smarter, context-aware productivity.