Microsoft 365 MCP Server — Claude Code MCP server: setup guide
Connects coding agents to Microsoft 365 services via Graph API, covering Outlook mail, calendars, OneDrive, Planner, and Teams.
claude mcp add ms-365-mcp-server -- npx -y @softeria/ms-365-mcp-serverWhat Microsoft 365 MCP Server does
This server maps over 300 tools directly to Microsoft Graph API endpoints. By default, it exposes personal productivity tools: Outlook emails, calendar scheduling, OneDrive storage, Excel spreadsheets, OneNote, and To Do task lists. Corporate features like Teams chat logs, meeting transcripts, and SharePoint document libraries require launching with --org-mode.
Authentication runs through MSAL. The server connects to international Microsoft 365, 21Vianet in China, and GCC High environments. For GCC High, configure an application in your sovereign cloud tenant, specify MS365_MCP_CLIENT_ID with MS365_MCP_TENANT_ID, and pass --cloud gcc-high. When reading large datasets, the optional TOON format cuts token overhead by 30-60% compared to standard JSON.
Node.js 20 or higher is required to prevent dependency failures. In restricted enterprise setups, protect your data by applying --read-only or narrowing Graph permissions through --allowed-scopes.
What it helps with
- manage Outlook emails and calendar appointments
- search and edit spreadsheets or documents in OneDrive
- create and update task lists in Microsoft To Do and Planner
- retrieve Teams meeting recordings, transcripts, and SharePoint data
Example prompts for the agent
- Show my unread emails from Outlook received today
- Schedule a calendar event for tomorrow at 11:00 AM
- Fetch the active project tasks from Microsoft Planner
How to install Microsoft 365 MCP Server
Platform CLI
claude mcp add ms-365-mcp-server -- npx -y @softeria/ms-365-mcp-serverPlatform CLI
codex mcp add microsoft-365-mcp-server -- npx -y @softeria/ms-365-mcp-serverConfig file
{
"mcpServers": {
"microsoft-365-mcp-server": {
"command": "npx",
"args": [
"-y",
"@softeria/ms-365-mcp-server"
]
}
}
}Config file
{
"servers": {
"microsoft-365-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@softeria/ms-365-mcp-server"
]
}
}
}Platform CLI
gemini mcp add microsoft-365-mcp-server npx -y @softeria/ms-365-mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Microsoft 365 MCP Server
How to install Microsoft 365 MCP Server in Claude Code?
Run claude mcp add microsoft-365-mcp-server -- npx -y @softeria/ms-365-mcp-server. Node.js 20 or higher must be installed on your machine.
What is the difference between personal and organization modes?
Personal mode runs by default and provides access to your own mailbox, OneDrive files, and tasks. Adding --org-mode enables tenant-level resources including Teams chats, call recordings, shared mailboxes, and SharePoint lists.
How does TOON output format work?
Pass --toon or set MS365_MCP_OUTPUT_FORMAT=toon to format array payloads as compact tabular data. This reduces context consumption by 30-60% when returning lists of emails, events, or directory users.
