ms-365-mcp-server

# ms-365-mcp-server [](https://www.npmjs.com/package/@softeria/ms-365-mcp-server) [](https://github.com/softeria/ms-365-mcp-server/actions/workflows/build.yml) [](https://github.com/softeria/ms-365-mcp-server/blob/main/LICENSE) Microsoft 365 MCP Server A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Microsoft Office services through the Graph API. ## Prerequisites - Node.js >= 20 (recommended) - Node.js 14+ may work with dependency warnings ## Features - Authentication via Microsoft Authentication Library (MSAL) - Comprehensive Microsoft 365 service integration - Read-only mode support for safe operations - Tool filtering for granular access control ## Output Format: JSON vs TOON The server supports two output formats that can be configured globally: ### JSON Format (Default) Standard JSON output with pretty-printing: ```json { "value": [ { "id": "1", "displayName": "Alice Johnson", "mail": "alice@example.com", "jobTitle": "Software Engineer" } ] } ``` ### (experimental) TOON Format [Token-Oriented Object Notation](https://github.com/toon-format/toon) for efficient LLM token usage: ``` value[1]{id,displayName,mail,jobTitle}: "1",Alice Johnson,alice@example.com,Software Engineer ``` **Benefits:** - 30-60% fewer tokens vs JSON - Best for uniform array data (lists of emails, calendar events, files, etc.) - Ideal for cost-sensitive applications at scale **Usage:** (experimental) Enable TOON format globally: Via CLI flag: ```bash npx @softeria/ms-365-mcp-server --toon ``` Via Claude Desktop configuration: ```json { "mcpServers": { "ms365": { "command": "npx", "args": ["-y", "@softeria/ms-365-mcp-server", "--toon"] } } } ``` Via environment variable: ```bash MS365_MCP_OUTPUT_FORMAT=toon npx @softeria/ms-365-mcp-server ``` ## Supported Services & Tools ### Personal Account Tools (Available by default) **Email (Outlook)** _{list-mail-messages, list-mail-folders, list-mail-folder-messages, get-mail-message, send-mail, delete-mail-message, create-draft-email, move-mail-message} **Calendar** _{list-calendars, list-calendar-events, get-calendar-event, get-calendar-view, create-calendar-event, update-calendar-event, delete-calendar-event} **OneDrive Files** _{list-drives, get-drive-root-item, list-folder-files, download-onedrive-file-content, upload-file-content, upload-new-file, delete-onedrive-file} **Excel Operations** _{list-excel-worksheets, get-excel-range, create-excel-chart, format-excel-range, sort-excel-range} **OneNote** _{list-onenote-notebooks, list-onenote-notebook-sections, list-onenote-section-pages, get-onenote-page-content, create-onenote-page} **To Do Tasks** _{list-todo-task-lists, list-todo-tasks, get-todo-task, create-todo-task, update-todo-task, delete-todo-task} **Planner** _{list-planner-tasks, get-planner-plan, list-plan-tasks, get-planner-task, create-planner-task} **Contacts** _{list-outlook-contacts, get-outlook-contact, create-outlook-contact, update-outlook-contact, delete-outlook-contact} **User Profile** _{get-current-user} **Search** _search-query ### Organization Account Tools (Requires --org-mode flag) **Teams & Chats** _{list-chats, get-chat, list-chat-messages, get-chat-message, send-chat-message, list-chat-message-replies, reply-to-chat-message, list-joined-teams, get-team, list-team-channels, get-team-channel, list-channel-messages, get-channel-message, send-channel-message, list-team-members} **SharePoint Sites** _{search-sharepoint-sites, get-sharepoint-site, get-sharepoint-site-by-path, list-sharepoint-site-drives, get-sharepoint-site-drive-by-id, list-sharepoint-site-items, get-sharepoint-site-item, list-sharepoint-site-lists, get-sharepoint-site-list, list-sharepoint-site-list-items, get-sharepoint-site-list-item, get-sharepoint-sites-delta} **Shared Mailboxes** _{list-shared-mailbox-messages, list-shared-mailbox-folder-messages, get-shared-mailbox-message, send-shared-mailbox-mail} **User Management** _list-users ## Organization/Work Mode To access work/school features (Teams, SharePoint, etc.), enable organization mode using any of these flags: ```json { "mcpServers": { "ms365": { "command": "npx", "args": ["-y", "@softeria/ms-365-mcp-server", "--org-mode"] } } } ``` Organization mode must be enabled from the start to access work account features. Without this flag, only personal account features (email, calendar, OneDrive, etc.) are available. ## Shared Mailbox Access To access shared mailboxes, you need: 1. **Organization mode**: Shared m