M365 MCP

MCP server for Microsoft 365 via the Microsoft Graph API. Read-only access to your profile, calendar, email, Teams chats, OneDrive files, and meeting transcripts from any MCP client.

Installation

Claude Code

claude mcp add m365-mcp -e MS365_MCP_CLIENT_ID=your-client-id -e MS365_MCP_TENANT_ID=your-tenant-id -- npx -y @masonator/m365-mcp

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "m365-mcp": {
      "command": "npx",
      "args": ["-y", "@masonator/m365-mcp"],
      "env": {
        "MS365_MCP_CLIENT_ID": "your-azure-ad-client-id",
        "MS365_MCP_TENANT_ID": "your-azure-ad-tenant-id"
      }
    }
  }
}

First Run

On first use, the server opens your browser to sign in with Microsoft. After granting consent, tokens are stored locally at ~/.config/m365-mcp/tokens.json (permissions 600) and refreshed automatically.

Environment Variables

| Variable | Required | Description | | ------------------------- | -------- | ------------------------------------------------------------------------------ | | MS365_MCP_CLIENT_ID | Yes | Azure AD application (client) ID | | MS365_MCP_TENANT_ID | Yes | Azure AD tenant ID | | MS365_MCP_CLIENT_SECRET | No | Azure AD client secret (confidential clients only) | | MS365_MCP_TIMEZONE | No | Timezone for calendar (default: system timezone) | | MS365_MCP_REDIRECT_URL | No | OAuth redirect URI (default: dynamic port, http://localhost:{port}/callback) |

Azure AD Setup

Register an application in Azure AD with these settings:

1. App registration > New registration
2. Redirect URI: http://localhost (Web platform) — or set a fixed URI via MS365_MCP_REDIRECT_URL
3. Certificates & secrets > New client secret
4. API permissions > Add the following delegated permissions:
   • User.Read
   • Calendars.Read
   • Mail.Read
   • Chat.Read
   • Files.Read
   • OnlineMeetingTranscript.Read.All
   • Sites.Read.All

Tools

ms_auth_status

Check connection status. If not connected, opens browser to sign in.

ms_profile

Fetch your Microsoft 365 profile — display name, email, job title, office location.

ms_calendar

Fetch calendar events. Defaults to today.

| Parameter | Description | | --------- | -------------------------- | | date | Specific date (YYYY-MM-DD) | | start | Start of range (ISO 8601) | | end | End of range (ISO 8601) |

ms_mail

Read recent emails with optional keyword search.

| Parameter | Description | | --------- | ----------------------------------- | | search | Keyword to filter emails | | count | Number of emails (1-25, default 10) |

ms_chat

Read Teams chats. Without chat_id lists recent chats; with chat_id returns messages from that thread.

| Parameter | Description | | --------- | ---------------------------------- | | chat_id | Specific chat thread ID | | count | Number of items (1-25, default 10) |

ms_files

Browse or search OneDrive files.

| Parameter | Description | | --------- | -------------------------------- | | path | Folder path (e.g., /Documents) | | search | Search across OneDrive | | count | Max items (1-50, default 20) |

ms_transcripts

Fetch Teams meeting transcripts. Returns previews (~3000 chars) with a transcript_id for drill-down to the full transcript.

| Parameter | Description | | --------------- | --------------------------------------------- | | date | Date (YYYY-MM-DD) | | start | Start of range (ISO 8601) | | end | End of range (ISO 8601) | | transcript_id | ID from a previous list call for full content |

Development

git clone https://github.com/StuMason/m365-mcp.git
cd m365-mcp
npm install
npm run build
npm test

Contributing

See CONTRIBUTING.md for details.

License

MIT - Stu Mason