microsoft365-mcp-server
Microsoft 365 MCP Server
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 |
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 ( |
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 ( |
¹ 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=truehides every tool that writes.MS365_REQUIRE_DRAFT=trueremoves direct email sending. The assistant can only write email drafts, which you review in Outlook and send yourself, or approve withsend_draft. Teams messages and calendar invites still send.MS365_PRESETSloads only some areas:personal,collaboration,productivity,rag, orall.MS365_ENABLED_TOOLSloads only the tools whose names match a regex.MS365_ALLOWED_MAILBOXESlimits which other people's or shared mailboxes it may open.MS365_TENANT_IDlocks 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 |
| Use it when |
Interactive |
| One person on their own machine (the default) |
OAuth proxy |
| A hosted server where each user signs in through the MCP client |
Client token |
| Your app already holds a Graph token and passes it in |
Client secret |
| Automation running as an app registration, with no user present |
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 -dThen 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 imageghcr.io/sapientsai/microsoft-mcp-serverand replaces the archivedsapientsai/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 InspectorLicense
MIT. Some shared code is adapted from other MIT projects; see NOTICE.
Sponsored by SapientsAI — Building agentic AI for businesses
Available Tools
97 toolsbatch_move_messagesMove Email Messages in BulkADestructive
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 EventCDestructive
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 BucketCDestructive
Create a new bucket (column) in a Planner plan
Inputs: name (required), plan_id (required).
create_planner_taskCreate Planner TaskCDestructive
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 ContactADestructive
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 DraftADestructive
Delete an unsent draft. Refuses any message that is not a draft.
Inputs: message_id (required), mailbox.
delete_eventDelete Calendar EventCDestructive
Delete a calendar event
Inputs: event_id (required), calendar_id.
delete_onenote_pageDelete OneNote PageADestructive
Delete a OneNote page. This cannot be undone via the API.
Inputs: page_id (required).
delete_todo_listDelete To Do ListADestructive
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 TaskADestructive
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 FileARead-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 TimesARead-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 StatusARead-only
Get current authentication status, mode, and scopes
Inputs: no named parameters.
get_contactRead ContactCRead-only
Get detailed contact information
Inputs: contact_id (required).
get_drive_itemGet OneDrive File DetailsCRead-only
Get file or folder metadata
Inputs: item_id (required).
get_eventRead Calendar EventBRead-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 GroupCRead-only
Get detailed group information
Inputs: group_id (required).
get_meGet My ProfileBRead-only
Get the authenticated user's profile
Inputs: no named parameters.
get_meeting_transcriptRead Meeting TranscriptARead-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 MessageARead-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 PageBRead-only
Get OneNote page content as HTML
Inputs: page_id (required).
get_planner_taskRead Planner TaskCRead-only
Get detailed Planner task information
Inputs: task_id (required).
get_siteGet SharePoint SiteCRead-only
Get SharePoint site details
Inputs: site_id (required).
get_userGet Person's ProfileCRead-only
Get a specific user's profile
Inputs: user_id (required).
graph_queryRaw Microsoft Graph RequestADestructive
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 AccountsBRead-only
List all registered accounts and show which is the default
Inputs: no named parameters.
list_attachmentsList Email AttachmentsARead-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 CalendarsARead-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 RangeARead-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 MessagesCRead-only
List recent messages in a channel
Inputs: team_id (required), channel_id (required), top, fetch_all_pages.
list_channelsList Teams ChannelsCRead-only
List channels in a team
Inputs: team_id (required), fetch_all_pages.
list_chat_messagesRead Teams Chat MessagesARead-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 ChatsARead-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 ContactsCRead-only
List contacts
Inputs: top, filter, fetch_all_pages.
list_drive_itemsList OneDrive FilesCRead-only
List files and folders in OneDrive
Inputs: folder_id, folder_path, fetch_all_pages.
list_eventsList Calendar EventsARead-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 MembersCRead-only
List members of a group
Inputs: group_id (required), fetch_all_pages.
list_groupsList GroupsBRead-only
List groups in the organization
Inputs: top, filter, fetch_all_pages.
list_mail_foldersList Mail FoldersARead-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 TranscriptsARead-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 MessagesARead-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 NotebooksCRead-only
List OneNote notebooks
Inputs: fetch_all_pages.
list_onenote_pagesList OneNote PagesCRead-only
List pages in a OneNote section
Inputs: section_id (required), fetch_all_pages.
list_onenote_sectionsList OneNote SectionsCRead-only
List sections in a OneNote notebook
Inputs: notebook_id (required), fetch_all_pages.
list_planner_bucketsList Planner BucketsARead-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 TasksCRead-only
List tasks in a Planner plan
Inputs: plan_id (required), fetch_all_pages.
list_plansList Planner PlansARead-only
List all Planner plans visible to you, aggregated across your group memberships
Inputs: no named parameters.
list_site_drivesList SharePoint Document LibrariesBRead-only
List document libraries (drives) in a SharePoint site
Inputs: site_id (required).
list_site_itemsList SharePoint FilesBRead-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 SitesARead-only
List SharePoint sites. Without a query, returns followed sites. With a query, searches all sites.
Inputs: query.
list_teamsList TeamsBRead-only
List teams you are a member of
Inputs: fetch_all_pages.
list_todo_listsList To Do ListsCRead-only
List Microsoft To Do task lists
Inputs: fetch_all_pages.
list_todo_tasksList To Do TasksARead-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 OrganizationCRead-only
List users in the organization
Inputs: top, filter, fetch_all_pages.
move_messageMove Email MessageADestructive
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 MessagesADestructive
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 TextARead-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 InvitationADestructive
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 HeadersARead-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 ContactsBRead-only
Search contacts by name or email
Inputs: query (required), top.
search_filesSearch OneDrive FilesARead-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 EmailCRead-only
Search email messages
Inputs: query (required), top, mailbox.
search_site_filesSearch SharePoint FilesARead-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 MessageBDestructive
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 MessageADestructive
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 DraftCDestructive
Send an existing email draft
Inputs: message_id (required), mailbox.
send_forwardForward EmailADestructive
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 EmailCDestructive
Send a new email message
Inputs: to (required), body (required), subject (required), mailbox, +1 more.
send_replySend Email ReplyADestructive
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 AllADestructive
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 TokenBDestructive
Set or update the access token (client-token auth mode only)
Inputs: access_token (required), expires_on.
set_todo_task_stateSet To Do Task StateADestructiveIdempotent
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 SendersARead-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 AccountBDestructive
Switch the default account for subsequent tool calls
Inputs: account_id (required).
update_contactUpdate ContactADestructive
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 DraftADestructive
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 EventCDestructive
Update an existing calendar event
Inputs: event_id (required), end, body, start, +11 more.
update_onenote_page_contentUpdate OneNote PageBDestructive
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 TaskADestructive
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 DetailsADestructive
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 TaskCDestructive
Update a To Do task
Inputs: list_id (required), task_id (required), body, title, +6 more.
upload_fileUpload Text File to OneDriveADestructive
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 OneDriveADestructive
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
Scored across 97 tools
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.
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.
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.
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
Related MCP Connectors
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Related MCP Servers
- AlicenseBqualityAmaintenanceA 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.203125,353 npm1,140MIT
- AlicenseNot gradedqualityCmaintenanceA 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
- AlicenseAqualityBmaintenanceA 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.28159 npm3MIT
- MIT