Skip to main content
Glama

Microsoft 365 MCP Server

npm version Node.js CI License: MIT

An MCP server that lets an AI assistant work in a user's Microsoft 365: mail, calendar, contacts, OneDrive and SharePoint files, Teams chats and channels, Planner, OneNote and To Do, all through Microsoft Graph.

It signs in as the user (delegated OAuth), so it reaches only what that user can already reach. Run it locally over stdio, or host it as a remote server with per-user sign-in.

Quick start

1. Register an app in Microsoft Entra ID. The server needs an application (client) ID. Create one under App registrations, add the redirect URI http://localhost on the Mobile and desktop platform, and grant the delegated Graph permissions for the domains you want. To keep MS365_TENANT_ID as common, choose an account type that covers every organization, plus personal accounts if you need them. For one organization only, choose single tenant and set MS365_TENANT_ID to its tenant ID. The full checklist lists every permission.

2. Add the server to your MCP client (Claude Desktop, Claude Code, VS Code, Cursor, …):

{
  "mcpServers": {
    "microsoft365": {
      "command": "npx",
      "args": ["-y", "microsoft365-mcp-server"],
      "env": {
        "MS365_CLIENT_ID": "your-app-client-id",
        "MS365_TENANT_ID": "common"
      }
    }
  }
}

3. Start your client. When the client starts the server, a browser opens to sign in. On a headless machine, set MS365_USE_DEVICE_CODE=true instead: the server prints a device code to its log, and the app registration needs Allow public client flows turned on. The sign-in is cached, so it survives restarts.

Related MCP server: m365-mcp-server

What it can do

99 tools. 27 of them need a work or school tenant, so they stay hidden until you set MS365_ORG_MODE=true.

Area

Tools

What the assistant can do

Mail

23

Read, search, send, reply, forward, move, and draft messages; save attachments

Calendar

9

List and manage events, find free time, accept or decline invitations

Contacts

7

List, search, create, update, delete, and export contacts

Files (OneDrive)

8

Browse, search, download, and upload files; create folders

SharePoint ¹

5

Browse sites, their drives and items; search a site's files

Documents

1

Extract readable text from PDF, DOCX, XLSX, and text files (read_document)

OneNote

10

List notebooks, sections and pages; read, create, update, copy, delete pages

To Do

8

Manage task lists and tasks, including repeating ones

Teams chats ¹

3

List chats and messages; send a chat message

Teams channels ¹

4

List teams, channels and messages; post to a channel

Meeting transcripts ¹

2

List and read Teams meeting transcripts

Planner ¹

8

List plans, buckets and tasks; create and update tasks

Users

3

Your own profile; look up other users ¹

Groups ¹

3

List groups and their members

Accounts

4

Check sign-in status, switch between accounts, supply a token

Graph query

1

Call any Microsoft Graph endpoint the user has access to (graph_query)

¹ Needs MS365_ORG_MODE=true. In the Users row, only the lookup of other users does; your own profile does not.

A few tools exist on only one transport: local file paths work over stdio, and upload links work over HTTP. Every tool carries MCP annotations (read-only, destructive, idempotent), so a client can tell reads from writes. The tool reference lists each one.

Keeping it safe

You decide how much the assistant can touch:

  • MS365_READ_ONLY=true hides every tool that writes.

  • MS365_REQUIRE_DRAFT=true removes direct email sending. The assistant can only write email drafts, which you review in Outlook and send yourself, or approve with send_draft. Teams messages and calendar invites still send.

  • MS365_PRESETS loads only some areas: personal, collaboration, productivity, rag, or all.

  • MS365_ENABLED_TOOLS loads only the tools whose names match a regex.

  • MS365_ALLOWED_MAILBOXES limits which other people's or shared mailboxes it may open.

  • MS365_TENANT_ID locks sign-in to one organization.

See Safety Layers for what Microsoft 365 can recover after a mistake, and what it can't.

Sign-in modes

Mode

MS365_AUTH_MODE

Use it when

Interactive

interactive

One person on their own machine (the default)

OAuth proxy

oauth-proxy

A hosted server where each user signs in through the MCP client

Client token

client-token

Your app already holds a Graph token and passes it in

Client secret

client-secret

Automation running as an app registration, with no user present

Certificate

certificate

The same, using a certificate instead of a secret

Each mode's settings are in Authentication. The main environment variables are listed in Environment Variables.

Hosting it as a remote server

oauth-proxy mode turns the server into an OAuth 2.1 authorization server in front of Entra ID. Each user signs in from their own MCP client, and each request runs with that user's own Graph token. The repo ships a Dockerfile and docker-compose.yml. Set MS365_CLIENT_ID, MS365_CLIENT_SECRET and MS365_OAUTH_BASE_URL first; the compose file refuses to start without them:

docker compose up -d

Then point the client at https://your-host/mcp. DEPLOYMENT.md covers the app registration, reverse proxy, Dokploy, and hardening.

Also in this repo

This is a pnpm monorepo. The server above is packages/microsoft365, published to npm as microsoft365-mcp-server. Alongside it:

  • packages/graph: an app-only Microsoft Graph server for headless, tenant-wide document search and retrieval, with no user signed in. It ships as the Docker image ghcr.io/sapientsai/microsoft-mcp-server and replaces the archived sapientsai/microsoft-mcp-server.

  • packages/core: Graph plumbing both servers share, such as uploads, paging, errors, and auth types. Internal, not published.

  • packages/extract: turns PDF, DOCX, XLSX, and text files into plain text. Internal, not published.

Pick by who signs in: microsoft365 when a person is there to consent, graph when only a service credential is.

Development

Requires Node.js 22.16 or later and pnpm.

pnpm install
pnpm validate   # format, lint, test, and build every package
pnpm --filter microsoft365-mcp-server inspect   # build and open the MCP Inspector

License

MIT. Some shared code is adapted from other MIT projects; see NOTICE.


Sponsored by SapientsAI — Building agentic AI for businesses

Available Tools

97 tools
batch_move_messagesMove Email Messages in BulkA
Destructive

Move several messages to the same folder in one call. Resolves the destination once and returns a single summary instead of one result per message. Reports any failures individually.

Inputs: destination (required), message_ids (required), mailbox.

copy_onenote_pageCopy OneNote PageB

Copy a OneNote page to another section. Runs asynchronously in OneNote.

Inputs: page_id (required), section_id (required).

create_contactCreate ContactC

Create a new contact

Inputs: given_name (required), email, surname, job_title, +2 more.

create_draftCreate Email DraftB

Create a new email draft in the Drafts folder

Inputs: to (required), body (required), subject (required), cc, +3 more.

create_eventCreate Calendar EventC
Destructive

Create a new calendar event

Inputs: start (required), subject (required), end, body, +11 more.

create_folderCreate OneDrive FolderC

Create a new folder in OneDrive

Inputs: name (required), parent_id (required).

create_forward_draftCreate Forward DraftA

Create a forward draft in the Drafts folder with the original quoted underneath. Review, then send with send_draft.

Inputs: to (required), message_id (required), comment, mailbox.

create_onenote_notebookCreate OneNote NotebookC

Create a new OneNote notebook

Inputs: display_name (required).

create_onenote_pageCreate OneNote PageA

Create a OneNote page in a section. Content is HTML — OneNote supports a constrained subset and silently drops unsupported CSS/tags.

Inputs: title (required), content (required), section_id (required).

create_onenote_sectionCreate OneNote SectionC

Create a new section in a OneNote notebook

Inputs: notebook_id (required), display_name (required).

create_planner_bucketCreate Planner BucketC
Destructive

Create a new bucket (column) in a Planner plan

Inputs: name (required), plan_id (required).

create_planner_taskCreate Planner TaskC
Destructive

Create a new Planner task

Inputs: title (required), plan_id (required), due_date, bucket_id, +1 more.

create_reply_all_draftCreate Reply-All DraftA

Create a reply-all draft (to all recipients) in the Drafts folder. Threads into the conversation with the original quoted underneath. Review, then send with send_draft.

Inputs: comment (required), message_id (required), mailbox.

create_reply_draftCreate Reply DraftA

Create a reply draft (to the sender) in the Drafts folder. Threads into the conversation with the original quoted underneath. Review, then send with send_draft.

Inputs: comment (required), message_id (required), mailbox.

create_todo_listCreate To Do ListA

Create a new To Do list. Graph cannot share a list — the new list is private until someone shares it in the To Do app

Inputs: display_name (required).

create_todo_taskCreate To Do TaskA

Create a new To Do task, optionally recurring. With linked_resource, the task is tagged with its source, and a create whose external_id is already on a task in the list returns that task instead of a second copy, so a retry is safe. That check reads the whole list first

Inputs: title (required), list_id (required), body, due_date, +5 more.

delete_contactDelete ContactA
Destructive

Delete a contact. Intended for duplicates: first copy anything the duplicate holds that the kept contact lacks (emails, phones, notes, birthday) onto the kept contact with update_contact, then delete. Returns the deleted contact's details so they are not lost from the conversation.

Inputs: contact_id (required).

delete_draftDelete Email DraftA
Destructive

Delete an unsent draft. Refuses any message that is not a draft.

Inputs: message_id (required), mailbox.

delete_eventDelete Calendar EventC
Destructive

Delete a calendar event

Inputs: event_id (required), calendar_id.

delete_onenote_pageDelete OneNote PageA
Destructive

Delete a OneNote page. This cannot be undone via the API.

Inputs: page_id (required).

delete_todo_listDelete To Do ListA
Destructive

Delete a To Do list and every task in it. There is no API to restore it, so treat it as permanent. A list that still holds tasks needs force: true. The built-in Tasks and Flagged Emails lists can't be deleted.

Inputs: list_id (required), force.

delete_todo_taskDelete To Do TaskA
Destructive

Delete a To Do task. There is no API to restore it, so treat it as permanent. Deleting a repeating task ends the whole series and needs force: true.

Inputs: list_id (required), task_id (required), force.

download_fileDownload OneDrive FileA
Read-only

Get a file's metadata and download URL. Returns content inline for text files under 100KB. For a SharePoint file, pass drive_id as well — without it the item is looked up in your own OneDrive and will not be found. For readable text from PDF/DOCX/XLSX, use read_document instead; come here when extraction fails (scanned PDFs, unsupported types, files over the extraction cap) or you need raw bytes.

Inputs: item_id (required), drive_id.

export_contactsExport Contacts to Local FileA

Export every contact in the signed-in mailbox to a local JSON file and return its path. Covers the default Contacts folder and every contact folder beneath it, with all fields (emails, phones, addresses, categories, birthday, notes, folder path). Use this to reconcile or bulk-process contacts; use list_contacts or search_contacts to look one up.

Inputs: out_dir.

find_meeting_availabilityFind Meeting TimesA
Read-only

Find meeting time suggestions where all participants are free, ranked by confidence. Searches between after_date_time and before_date_time for a slot of duration_minutes. Read-only: suggests times only — use create_event to book one.

Inputs: participants (required), after_date_time (required), before_date_time (required), max_candidates, +2 more.

get_auth_statusGet Sign-in StatusA
Read-only

Get current authentication status, mode, and scopes

Inputs: no named parameters.

get_contactRead ContactC
Read-only

Get detailed contact information

Inputs: contact_id (required).

get_drive_itemGet OneDrive File DetailsC
Read-only

Get file or folder metadata

Inputs: item_id (required).

get_eventRead Calendar EventB
Read-only

Get detailed information about a calendar event. The body comes back as plain text by default; a Teams invite's text still includes its join link and any meeting ID and passcode.

Inputs: event_id (required), time_zone, body_format, calendar_id.

get_groupGet GroupC
Read-only

Get detailed group information

Inputs: group_id (required).

get_meGet My ProfileB
Read-only

Get the authenticated user's profile

Inputs: no named parameters.

get_meeting_transcriptRead Meeting TranscriptA
Read-only

Get the text of one Teams meeting transcript, as timestamped WebVTT utterances. Works for attendees, not just the organizer. Falls back to a speaker-less transcript automatically when the tenant has speaker attribution disabled.

Inputs: transcript_id (required), offset, max_chars, meeting_id, +2 more.

get_messageRead Email MessageA
Read-only

Get a specific email message with full body content. Pass body_format:'text' for marketing or newsletter mail — Graph converts server-side, avoiding tens of thousands of characters of HTML and CSS.

Inputs: message_id (required), mailbox, body_format.

get_onenote_page_contentRead OneNote PageB
Read-only

Get OneNote page content as HTML

Inputs: page_id (required).

get_planner_taskRead Planner TaskC
Read-only

Get detailed Planner task information

Inputs: task_id (required).

get_siteGet SharePoint SiteC
Read-only

Get SharePoint site details

Inputs: site_id (required).

get_userGet Person's ProfileC
Read-only

Get a specific user's profile

Inputs: user_id (required).

graph_queryRaw Microsoft Graph RequestA
Destructive

Execute an arbitrary Microsoft Graph API query. Use this for operations not covered by other tools.

Inputs: path (required), method (required), body, headers, +1 more.

list_accountsList Signed-in AccountsB
Read-only

List all registered accounts and show which is the default

Inputs: no named parameters.

list_attachmentsList Email AttachmentsA
Read-only

List a message's attachments with name, content type and size. Returns a read_document path for file attachments so their text can be extracted (PDF, Office, etc); cloud links and embedded Outlook items are marked as not readable that way.

Inputs: message_id (required), mailbox.

list_calendarsList CalendarsA
Read-only

List the calendars you can see: your own, and any shared with you. Returns each calendar's ID for the calendar_id parameter of the event tools, and marks the default calendar and any you cannot edit.

Inputs: no named parameters.

list_calendar_viewList Calendar Events in a Date RangeA
Read-only

List event instances on the calendar between start_date_time and end_date_time. Expands recurring series into individual occurrences (unlike list_events which returns series masters). Use this for 'what's on my calendar this week'.

Inputs: end_date_time (required), start_date_time (required), top, time_zone, +1 more.

list_channel_messagesRead Teams Channel MessagesC
Read-only

List recent messages in a channel

Inputs: team_id (required), channel_id (required), top, fetch_all_pages.

list_channelsList Teams ChannelsC
Read-only

List channels in a team

Inputs: team_id (required), fetch_all_pages.

list_chat_messagesRead Teams Chat MessagesA
Read-only

List messages in a Teams chat, newest first. Each message is a line '- () [You] [App] [Urgent|High importance] [Mentions you] (ID: )' (flags only when they apply), followed by its text on a ' > ' line. System events (joins, renames) and deleted messages are left out.

Inputs: chat_id (required), top, since, max_chars, +1 more.

list_chatsList Teams ChatsA
Read-only

List your Teams chats (1:1, group, and meeting chats), most recent message first. Each line names the chat by its topic or its members and shows when the last message was sent and by whom. Note: the self-chat (notes to self) is not listed here — use chat_id '48:notes' to send to it directly.

Inputs: top, since, fetch_all_pages.

list_contactsList ContactsC
Read-only

List contacts

Inputs: top, filter, fetch_all_pages.

list_drive_itemsList OneDrive FilesC
Read-only

List files and folders in OneDrive

Inputs: folder_id, folder_path, fetch_all_pages.

list_eventsList Calendar EventsA
Read-only

List calendar event resources (/me/events). Returns series masters for recurring meetings, NOT individual occurrences. For 'what's on my calendar between X and Y' use list_calendar_view instead — it expands recurrences into instances.

Inputs: top, filter, time_zone, calendar_id, +1 more.

list_group_membersList Group MembersC
Read-only

List members of a group

Inputs: group_id (required), fetch_all_pages.

list_groupsList GroupsB
Read-only

List groups in the organization

Inputs: top, filter, fetch_all_pages.

list_mail_foldersList Mail FoldersA
Read-only

List mail folders with item and unread counts, for resolving move destinations. Top-level folders only — a folder reporting subfolders has children this does not list.

Inputs: mailbox, fetch_all_pages.

list_meeting_transcriptsList Meeting TranscriptsA
Read-only

List the transcripts of a Teams meeting. Identify the meeting by meeting_id, or by join_web_url taken from a calendar event's onlineMeeting.joinUrl. Returns transcript IDs for get_meeting_transcript.

Inputs: meeting_id, join_web_url.

list_messagesList Email MessagesA
Read-only

List email messages, newest first. Covers every folder (Inbox, Sent Items, Archive, ...) unless folder is set. Each line shows the sender's name and address, the received time, the Graph message ID and the internetMessageId.

Inputs: top, filter, folder, mailbox, +2 more.

list_onenote_notebooksList OneNote NotebooksC
Read-only

List OneNote notebooks

Inputs: fetch_all_pages.

list_onenote_pagesList OneNote PagesC
Read-only

List pages in a OneNote section

Inputs: section_id (required), fetch_all_pages.

list_onenote_sectionsList OneNote SectionsC
Read-only

List sections in a OneNote notebook

Inputs: notebook_id (required), fetch_all_pages.

list_planner_bucketsList Planner BucketsA
Read-only

List the buckets (columns) in a Planner plan. Use a bucket ID with create_planner_task.

Inputs: plan_id (required).

list_planner_tasksList Planner TasksC
Read-only

List tasks in a Planner plan

Inputs: plan_id (required), fetch_all_pages.

list_plansList Planner PlansA
Read-only

List all Planner plans visible to you, aggregated across your group memberships

Inputs: no named parameters.

list_site_drivesList SharePoint Document LibrariesB
Read-only

List document libraries (drives) in a SharePoint site

Inputs: site_id (required).

list_site_itemsList SharePoint FilesB
Read-only

List files and folders in a SharePoint site's document library

Inputs: site_id (required), drive_id, folder_id, folder_path.

list_sitesList SharePoint SitesA
Read-only

List SharePoint sites. Without a query, returns followed sites. With a query, searches all sites.

Inputs: query.

list_teamsList TeamsB
Read-only

List teams you are a member of

Inputs: fetch_all_pages.

list_todo_listsList To Do ListsC
Read-only

List Microsoft To Do task lists

Inputs: fetch_all_pages.

list_todo_tasksList To Do TasksA
Read-only

List tasks in a To Do list, or what changed in it since your last call. For changes, call once with delta: true, which returns every task and a 'Delta token: …' line; keep the token and pass it as delta_token next time to get only the tasks added, changed or removed since (removed ones as 'Removed: ()' lines), and a new token. Completing a repeating task makes Graph keep the series and split off the finished occurrence as a new, already-completed task with a new id, so an unseen completed task is a done occurrence, not new work. Your own writes come back as changes too. The Flagged Emails list (wellknownListName flaggedEmails) holds the emails flagged in Outlook; each of its tasks carries (Mail: ), the id the mail tools use, when its Outlook link parses

Inputs: list_id (required), delta, delta_token, extension_name, +1 more.

list_usersList People in OrganizationC
Read-only

List users in the organization

Inputs: top, filter, fetch_all_pages.

move_messageMove Email MessageA
Destructive

Move a message to another mail folder. Destination accepts a well-known name (archive, deleteditems, inbox, junkemail), a top-level folder display name, or a folder ID. A well-known name always wins over a custom folder of the same name, and the confirmation says which was used. Subfolders cannot be resolved by name — pass their ID. Moving to deleteditems is recoverable; use list_mail_folders to see what exists.

Inputs: message_id (required), destination (required), mailbox.

move_messages_matchingMove Matching Email MessagesA
Destructive

Move every message in a folder that matches a sender list and/or an OData filter — the bulk step of an inbox clean-up. Pass senders (addresses from summarize_senders) and/or filter; a whole folder with no condition is refused. Destination deleteditems is how to bulk-delete: it is reversible from Deleted Items, and a hard delete is deliberately not offered.

SAFE BY DEFAULT: dry_run is true unless set to false. A dry run fetches the matching set and reports the count, date range, sender breakdown and newest subjects, moving nothing — read it before re-running with dry_run: false. A live run refuses to move more than limit messages (default 1000) so a mis-scoped filter cannot empty a folder; raise limit explicitly when the dry-run count is intended.

Moves go through Graph JSON batching (20 per round-trip, throttling retried), so thousands of messages take seconds, not minutes, and no message IDs pass through the caller.

Inputs: folder (required), destination (required), limit, filter, +3 more.

read_documentRead Document TextA
Read-only

Download a file from SharePoint or OneDrive and return its readable text content. Supports DOCX, PDF, XLSX, and text-based files. Use instead of download_file when you need document contents. Pair with search_site_files (SharePoint) or search_files (OneDrive) to get IDs, then pass /drives/{driveId}/items/{itemId}/content or /me/drive/items/{id}/content. Text extraction only, no OCR: scanned PDFs return no text — for those, and for images, use save_attachment and read the file.

Inputs: path (required), format, max_chars, api_version.

respond_to_eventRespond to Meeting InvitationA
Destructive

Accept, decline or tentatively accept a meeting invitation. By default the organizer gets the response by email, with the comment if one is given.

Inputs: event_id (required), response (required), comment, send_response.

save_attachmentSave Email Attachment to DiskA

Save a mail attachment to a local file and return its path. Use for anything read_document cannot extract text from — scanned PDFs, photographed documents, images — and for handing a file to another tool. Read the saved file directly: PDFs and images are viewable without text extraction. Omit attachment_id when the message has exactly one attachment; otherwise get IDs from list_attachments.

Inputs: message_id (required), mailbox, out_dir, attachment_id.

scan_messagesScan Email HeadersA
Read-only

Scan message headers compactly as ref|received|from|subject|flags. Scope with folder and narrow with filter or search. Pass refs to get_message, list_attachments, move_message or batch_move_messages. Both filter and search scans page using Graph nextLink cursors: when a result says INCOMPLETE, call scan_messages with the returned cursor alone until no cursor remains. A short or empty page can still have a continuation. Search returns at most 1,000 results, so use filter and exhaust its cursors when mailbox coverage matters. A header is not a message: open messages and attachments the subject cannot rule out.

Inputs: top, cursor, filter, folder, +2 more.

search_contactsSearch ContactsB
Read-only

Search contacts by name or email

Inputs: query (required), top.

search_filesSearch OneDrive FilesA
Read-only

Search OneDrive/SharePoint files. Search results show folders without item counts or sizes, which search does not report; use list_drive_items or get_drive_item for those.

Inputs: query (required), top, fetch_all_pages.

search_messagesSearch EmailC
Read-only

Search email messages

Inputs: query (required), top, mailbox.

search_site_filesSearch SharePoint FilesA
Read-only

Search files within a SharePoint site. Search results show folders without item counts or sizes, which search does not report; use list_drive_items or get_drive_item for those.

Inputs: query (required), site_id (required), top, drive_id, +1 more.

send_channel_messagePost Teams Channel MessageB
Destructive

Send a message to a Teams channel, or reply in a thread with reply_to_message_id

Inputs: content (required), team_id (required), channel_id (required), format, +1 more.

send_chat_messageSend Teams Chat MessageA
Destructive

Send a Teams chat message, either in an existing chat (chat_id) or to people by email (to). With to, one person reuses your one-on-one chat with them, or starts it; two or more start a new group chat every call, so reuse the returned chat_id for follow-ups. Use chat_id '48:notes' to send to the user's self-chat (notes to self).

Inputs: content (required), to, topic, format, +1 more.

send_draftSend Email DraftC
Destructive

Send an existing email draft

Inputs: message_id (required), mailbox.

send_forwardForward EmailA
Destructive

Forward an email to new recipients and send immediately. Quotes the original. Use create_forward_draft to review before sending.

Inputs: to (required), message_id (required), comment, mailbox.

send_messageSend EmailC
Destructive

Send a new email message

Inputs: to (required), body (required), subject (required), mailbox, +1 more.

send_replySend Email ReplyA
Destructive

Reply to the sender of an email and send immediately. Threads into the conversation and quotes the original. Use create_reply_draft to review before sending.

Inputs: comment (required), message_id (required), mailbox.

send_reply_allSend Email Reply to AllA
Destructive

Reply to all recipients of an email and send immediately. Threads into the conversation and quotes the original. Use create_reply_all_draft to review before sending.

Inputs: comment (required), message_id (required), mailbox.

set_access_tokenSet Access TokenB
Destructive

Set or update the access token (client-token auth mode only)

Inputs: access_token (required), expires_on.

set_todo_task_stateSet To Do Task StateA
DestructiveIdempotent

Set only a To Do task's status, importance and your own extension fields, for unattended use. It can't change the title, notes, dates or repeat pattern, or delete. The same call twice changes nothing more, so a failed call is safe to repeat. Completing a repeating task is refused; use update_todo_task. Complete only tasks you created, and change importance only on tasks carrying your extension, so the person's own choices are never overwritten

Inputs: list_id (required), task_id (required), status, extension, +1 more.

summarize_sendersSummarize Email SendersA
Read-only

Count a folder's messages by sender, server-side, without listing them. Returns one row per sender (count, unread, first and last date, address, name, latest subject), most frequent first — the starting point for cleaning a large inbox: newsletters, promotions and notifications show up as a few hundred senders repeating.

Reads every matching message in the folder (paged internally, up to ~50,000) so the counts are complete; only the summary is returned. Narrow with filter (OData, e.g. a receivedDateTime range) when only part of a folder matters. Use group_by: domain to see families of senders, then group_by: address to get the addresses move_messages_matching needs.

Inputs: top, filter, folder, mailbox, +1 more.

switch_accountSwitch AccountB
Destructive

Switch the default account for subsequent tool calls

Inputs: account_id (required).

update_contactUpdate ContactA
Destructive

Update fields on an existing contact. Only the fields passed are changed. List fields (email_addresses, business_phones, home_phones, categories) REPLACE the whole list — read the contact first and pass the complete new list; an empty list clears it.

Inputs: contact_id (required), surname, birthday, nickname, +9 more.

update_draftEdit Email DraftA
Destructive

Edit an unsent draft: its subject, body or recipients. Only fields you pass change. Refuses any message that is not a draft. Send it afterward with send_draft.

Inputs: message_id (required), cc, to, bcc, +4 more.

update_eventUpdate Calendar EventC
Destructive

Update an existing calendar event

Inputs: event_id (required), end, body, start, +11 more.

update_onenote_page_contentUpdate OneNote PageB
Destructive

Append to or modify a OneNote page's content without rewriting it. Targets an element (default 'body') and applies an action. Content is HTML.

Inputs: content (required), page_id (required), action, target, +1 more.

update_planner_taskUpdate Planner TaskA
Destructive

Update a Planner task (title, percent_complete — 100 closes it — due date, priority). The ETag is auto-fetched if omitted; pass one only to enforce optimistic concurrency.

Inputs: task_id (required), etag, title, due_date, +2 more.

update_planner_task_detailsUpdate Planner Task DetailsA
Destructive

Update a Planner task's details: description, checklist items, and references (links). The ETag is fetched automatically. Add, update, or remove entries — updates merge (omitted fields keep their current value); update/remove of a missing item is reported as skipped, not a silent no-op. Checklist items are addressed by their GUID (from get_planner_task); references by their URL.

Inputs: task_id (required), description, preview_type, add_checklist, +5 more.

update_todo_taskUpdate To Do TaskC
Destructive

Update a To Do task

Inputs: list_id (required), task_id (required), body, title, +6 more.

upload_fileUpload Text File to OneDriveA
Destructive

Upload TEXT content (plain text, markdown, CSV, JSON, HTML, XML) to OneDrive inline via this tool call. For binary files (docx, pdf, images, etc.), use get_upload_config (HTTP/SSE) or upload_file_from_path (stdio/local) — never base64-encode binary into this tool's content param. Max ~4 MB text.

Inputs: path (required), content (required), content_type, conflict_behavior.

upload_file_from_pathUpload Local File to OneDriveA
Destructive

Upload a local file to OneDrive by reading it from disk on the server. The file must exist on this machine's filesystem. If you generated the file in a cloud container (e.g., claude.ai), first use Desktop Commander's write_file to save it to the user's local filesystem, then call this tool with that local path. Supports files up to 250 MB (chunked session upload above 4 MB). Intermediate folders are auto-created.

Inputs: path (required), local_path (required), content_type, conflict_behavior.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 97 tools

    Disambiguation3/5

    The set covers many distinct M365 workloads, but several tools overlap heavily: list_messages, scan_messages, search_messages, and summarize_senders all operate on mail, while download_file, read_document, get_drive_item, and search_files overlap in file access. Descriptions usually clarify when to use each, but the sheer number of near-neighbors makes misselection likely.

    Naming Consistency5/5

    Names are uniformly snake_case and almost always follow a verb_noun pattern such as list_messages, create_event, update_todo_task, and search_site_files. Variants like graph_query and get_me are minor exceptions but do not break the overall convention.

    Tool Count2/5

    97 tools is far too many for reliable agent selection, even for a broad Microsoft 365 server. The surface covers many domains, but operations could be consolidated or grouped to reduce context burden and selection error.

    Completeness4/5

    Coverage is broad across mail, calendar, contacts, OneDrive, SharePoint, Teams, Planner, OneNote, To Do, users/groups, and auth, with graph_query as an escape hatch. Some lifecycle gaps remain, such as file/folder delete or move, planner task deletion, and team/channel creation, but core workflows are covered.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      A Model Context Protocol server that enables interaction with Microsoft 365 services (Excel, Calendar, Mail, OneDrive, Teams, etc.) through the Graph API, allowing AI assistants to manage Microsoft 365 resources via natural language.
      203
      125,353 npm
      1,140
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A production-ready MCP server that provides secure, delegated access to Microsoft 365 services including Email, SharePoint, OneDrive, and Calendar. It enables AI models to search messages, browse files, manage calendar events, and parse document contents using OAuth 2.1 authentication.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A comprehensive MCP server for Dokploy that provides 14 action-based tools covering the full DevOps lifecycle with minimal token usage. It enables AI assistants to manage projects, applications, databases, domains, servers, and more through a unified interface.
      28
      159 npm
      3
      MIT