ms-365

This MCP server provides a programmable interface to interact with Microsoft 365 services through the Microsoft Graph API. It supports a range of Microsoft 365 features such as email, calendar, OneDrive, Excel, OneNote, Planner, and user/profile queries, with additional organization/work account features accessible by enabling organization mode. By running the server with npx, Claude Desktop or Claude Code CLI integrations can issue MCP commands to list, get, create or modify resources across personal and organizational Microsoft accounts. The server also supports an experimental TOON output format to reduce token usage when consuming large lists of results. To switch between output formats, you can enable toon mode globally via CLI flags or environment variables as described in the integration guides.

Prerequisites:

• Node.js v20 or newer (Node.js 14+ may work with warnings)
• npm (included with Node.js) or pnpm/yarn as desired

Installation steps:

1. Install Node.js 20+ from the official source if you haven’t already.
2. Use npx to run the MCP server directly from the package registry without a local install:

npx -y @softeria/ms-365-mcp-server

3. (Optional) Install locally or globally if you prefer a persistent setup:

npm install -g @softeria/ms-365-mcp-server
# then run with:
ms365-mcp-server

4. To enable organization/work mode features (work/school accounts) add the --org-mode flag when starting:

npx -y @softeria/ms-365-mcp-server --org-mode

5. To enable the experimental TOON output format globally via CLI:

npx @softeria/ms-365-mcp-server --toon

6. Refer to Claude Desktop/Code CLI integration examples in the README to wire this MCP server into your workflow.

Tips and notes:

• Default output format is JSON; TOON is experimental and reduces token usage for large data sets.
• You can enable organization mode (--org-mode) to access Teams, SharePoint, and related organization-level features.
• Environment variable MS365_MCP_OUTPUT_FORMAT can override output format, e.g., MS365_MCP_OUTPUT_FORMAT=toon npx @softeria/ms-365-mcp-server
• For Claude Desktop integration, you can embed the command and arguments exactly as shown in the README examples for personal or work accounts.
• If you encounter permissions or scope issues, ensure the signed-in Microsoft account has the appropriate Graph API permissions and, for shared mailboxes, that delegation and Exchange permissions are configured.