Hosting

Local stdio process

Transport

stdio

Endpoint

Local process; no hosted endpoint documented

Authentication

No credentials were configured; the tested read-only tool “list-accounts” succeeded in an isolated environment. Other tools may have additional requirements.

Requirements

• Node.js 18+
• The npm package repository matched the repository linked from the public profile.

Setup steps

1. npx -y @softeria/ms-365-mcp-server@0.170.0

The large 197-tool snapshot is not independently confirmed against current server-generated profiles; configuration and authorization determine exposed tools.

• login

  Authenticate with Microsoft account

  Parameters: force
  01
• logout

  Log out from Microsoft account

  02
• verify-login

  Check current Microsoft authentication status

  03
• list-accounts

  List all Microsoft accounts configured in this server. Use this to discover available account emails before making tool calls. Reflects accounts added mid-session via --login.

  04
• select-account

  Select a Microsoft account as the default. Accepts email address (e.g. user@outlook.com) or account ID. Use list-accounts to discover available accounts.

  Parameters: account
  05
• remove-account

  Remove a Microsoft account from the cache. Accepts email address (e.g. user@outlook.com) or account ID. Use list-accounts to discover available accounts.

  Parameters: account
  06
• graph-batch

  Combine up to 20 Graph requests into a single HTTP call. Body: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Returns { responses: [{ id, status, body, headers }] } in arbitrary order — match by id. Use cases: (1) parallelize many small reads (e.g. fetch 15 mail messages by id in one round-trip); (2) sequence dependent writes via dependsOn; (3) batch many Excel range writes into one call to dramatically reduce latency on large workbook builds. Note: each sub-request URL is relative to the Graph version root (/me/..., /drives/..., NOT https://graph.microsoft.com/v1.0/...). 💡 TIP: Combine up to 20 Graph requests into a single HTTP call. Body: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Returns { responses: [{ id, status, body, headers }] } in arbitrary order — match by id. Use c

  Parameters: body, includeHeaders, excludeResponse, confirm
  07
• get-drive-item

  All items contained in the drive. Read-only. Nullable. 💡 TIP: Gets metadata for a file or folder: name, size, lastModifiedDateTime, createdBy, webUrl, file (mimeType, hashes), folder (childCount), parentReference, and @microsoft.graph.downloadUrl. For large drive/SharePoint files, call get-download-url with target=/drives/{drive-id}/items/{driveItem-id}/content to fetch out-of-band with no Authorization header. For small files where base64 in the tool response is acceptable, call download-bytes with the same /content target.

  Parameters: select, expand, driveId, driveItemId, fetchAllPages, includeHeaders, excludeResponse
  08
• move-rename-onedrive-item

  Move or rename a OneDrive item. 💡 TIP: Move and/or rename a file or folder. To move, provide parentReference with the target folder's id. To rename, provide a new name. Both can be done in a single request.

  Parameters: body, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  09
• delete-onedrive-file

  Delete a OneDrive file.

  Parameters: If-Match, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  10
• list-folder-files

  Return a collection of DriveItems in the children relationship of a DriveItem. DriveItems with a non-null folder or package facet can have one or more child DriveItems.

  Parameters: top, skip, search, filter, count, orderby, select, expand, driveId, driveItemId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  11
• create-onedrive-folder

  Create a OneDrive folder. 💡 TIP: Creates a new folder inside the specified drive item. Body must include name (string) and folder ({}) fields. Use @microsoft.graph.conflictBehavior to control behavior on name conflict: 'rename' (default), 'replace', or 'fail'.

  Parameters: body, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  12
• upload-file-content

  The content stream, if the item represents a file. 💡 TIP: Body is a base64-encoded string of the file bytes; the server decodes it before PUT. Graph accepts up to 250MB here, but the whole string travels as a tool argument and a truncated one decodes to a truncated file with no error, so use create-upload-session rather than emitting a large base64 string. For new files use path format: /items/root:/path/to/file.txt:/content. Overwrites existing files without warning.

  Parameters: body, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  13
• copy-drive-item

  Copy a drive item. 💡 TIP: Asynchronously copy a file or folder to a new location and/or name. Body: { parentReference: { driveId: '...', id: '...' }, name?: 'New Name.xlsx' }. Returns 202 Accepted with a Location header pointing at a monitor URL for the async job. Ideal for duplicating templates (e.g. clone an Armhr Census Template per prospect), bulk file provisioning, or preserving an immutable snapshot of a working file.

  Parameters: body, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  14
• create-drive-item-share-link

  Create a link to share a driveItem driveItem. The createLink action creates a new sharing link if the specified link type doesn't already exist for the calling application. If a sharing link of the specified type already exists for the app, the existing sharing link is returned. DriveItem resources inherit sharing permissions from their ancestors. 💡 TIP: Create a shareable link for a file or folder WITHOUT sending an email invitation. Body: { type: 'view' | 'edit' | 'embed', scope: 'anonymous' | 'organization' | 'users', password?: string, expirationDateTime?: ISO-8601, retainInheritedPermissions?: boolean }. Returns a permission with link.webUrl. Pair with share-drive-item when you want to grant explicit access; use this when you only need a URL to paste into a doc/email/chat without triggering OneDrive notifications.

  Parameters: body, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  15
• create-upload-session

  Create an upload session. 💡 TIP: For large file uploads (no size limit, and no minimum unlike the Outlook attachment session). Returns a pre-authenticated uploadUrl; the caller PUTs the bytes there itself. This server does not perform the PUT. For new files use path: /items/{parentId}:/{fileName}:/createUploadSession. Body (optional): { item: { '@microsoft.graph.conflictBehavior': 'rename' } }.

  Parameters: body, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  16
• get-drive-delta

  Track changes in a driveItem and its children over time. Your app begins by calling delta without any parameters. The service starts enumerating the drive's hierarchy, returning pages of items and either an @odata.nextLink or an @odata.deltaLink, as described below. Your app should continue calling with the @odata.nextLink until you no longer see an @odata.nextLink returned, or you see a response with an empty set of changes. After you have finished receiving all the changes, you may apply them to your local state. To check for changes in the future, call delta again with the @odata.deltaLink from the previous response. Deleted items are returned with the deleted facet. Items with this property set should be removed from your local state. 💡 TIP: Tracks changes to a driveItem and its children over time. Returns a collection of driveItems that have been created, modified, or deleted. Use get-drive-root-item first to get the root driveItem-id, then pass it here. Supports $select and del

  Parameters: top, skip, search, filter, count, select, orderby, expand, driveId, driveItemId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  17
• share-drive-item

  Send a sharing invitation for a driveItem. A sharing invitation provides permissions to the recipients and, optionally, sends them an email to notify them that the item was shared. 💡 TIP: Shares a file or folder with specific users. Body: { recipients: [{ email: 'user@example.com' }], roles: ['read'], sendInvitation: true, message: 'Please review this file.' }. Roles: 'read', 'write', 'owner'. Set requireSignIn to true to require authentication.

  Parameters: body, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  18
• list-drive-item-permissions

  The set of permissions for the item. Read-only. Nullable. 💡 TIP: Lists all permissions (sharing links, direct access, inherited) on a file or folder. Each permission has roles, grantedTo (user), link (sharing URL), and inheritedFrom.

  Parameters: top, skip, search, filter, count, orderby, select, expand, driveId, driveItemId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  19
• delete-drive-item-permission

  Delete a drive item permission. 💡 TIP: Removes a specific permission from a file or folder. Only permissions that are not inherited can be deleted. Use list-drive-item-permissions first to find the permission ID.

  Parameters: If-Match, driveId, driveItemId, permissionId, includeHeaders, excludeResponse, confirm
  20
• create-drive-item-preview

  Create a drive item preview. 💡 TIP: Generate a short-lived embeddable preview URL for a file (Office docs, PDFs, images). Body: { page?: number | string, zoom?: number, viewer?: 'onedrive' | 'office' }. Returns getUrl (interactive) and postUrl (form-post). Useful for surfacing inline previews in summary emails or chat messages without needing the recipient to open the file.

  Parameters: body, driveId, driveItemId, includeHeaders, excludeResponse, confirm
  21
• list-drive-item-thumbnails

  Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable. 💡 TIP: Lists thumbnail sets for a file. Each set contains small (96px), medium (176px), large (800px) thumbnails with url and dimensions. Returns empty for unsupported types (text docs). Use $select=small,medium,large or $expand=small($select=url) to fetch specific sizes. The returned URLs are short-lived — fetch the bytes immediately.

  Parameters: top, skip, search, filter, count, orderby, select, expand, driveId, driveItemId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  22
• list-drive-item-versions

  The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable. 💡 TIP: Lists version history of a file. Each version has id, lastModifiedDateTime, lastModifiedBy, and size. Use the version id with /versions/{id}/content to download a specific version.

  Parameters: top, skip, search, filter, count, orderby, select, expand, driveId, driveItemId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  23
• list-excel-tables

  Represents a collection of tables associated with the workbook. Read-only. 💡 TIP: Lists all named tables in a workbook. Each table has id, name, showHeaders, showTotals, columns, and style. Use the table name or id with other table endpoints.

  Parameters: top, skip, search, filter, count, orderby, select, expand, driveId, driveItemId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  24
• get-excel-table

  Represents a collection of tables associated with the workbook. Read-only. 💡 TIP: Gets a specific table by name or ID. Returns table properties including columns, showHeaders, showTotals, and style.

  Parameters: select, expand, driveId, driveItemId, workbookTableId, fetchAllPages, includeHeaders, excludeResponse
  25
• list-excel-table-rows

  The list of all the rows in the table. Read-only. 💡 TIP: Lists all rows in a table. Each row has index and values (array of cell values). Use $top and $skip for pagination on large tables.

  Parameters: top, skip, search, filter, count, orderby, select, expand, driveId, driveItemId, workbookTableId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  26
• add-excel-table-rows

  Add Excel table rows. 💡 TIP: Adds rows to a table. Body: { values: [['col1val', 'col2val', 'col3val'], ['row2col1', 'row2col2', 'row2col3']] }. Each inner array is one row. Values must match the number of columns in the table.

  Parameters: body, driveId, driveItemId, workbookTableId, includeHeaders, excludeResponse, confirm
  27
• update-excel-table-row

  Update an Excel table row. 💡 TIP: Update a single row in a formal Excel table by zero-based row index. Body: { values: [[...]] } with one inner array matching the column count.

  Parameters: body, driveId, driveItemId, workbookTableId, index, includeHeaders, excludeResponse, confirm
  28
• delete-excel-table-row

  Delete an Excel table row. 💡 TIP: Delete a single row from a formal Excel table by zero-based row index.

  Parameters: driveId, driveItemId, workbookTableId, index, includeHeaders, excludeResponse, confirm
  29
• list-excel-worksheets

  Represents a collection of worksheets associated with the workbook. Read-only.

  Parameters: top, skip, search, filter, count, orderby, select, expand, driveId, driveItemId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  30
• create-excel-chart

  Creates a new chart.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, includeHeaders, excludeResponse, confirm
  31
• sort-excel-range

  Sort an Excel range.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, includeHeaders, excludeResponse, confirm
  32
• get-excel-range

  Get an Excel range.

  Parameters: driveId, driveItemId, workbookWorksheetId, address, fetchAllPages, includeHeaders, excludeResponse
  33
• update-excel-range

  Update an Excel range. 💡 TIP: Set cell values, formulas, or number format on any range — does NOT require the worksheet to be a formal Excel table. Body: { values: [['v1','v2','v3']] } for a single row, or [['a','b'],['c','d']] for multi-row. Use this for append (target the next empty row's address, e.g. 'A172:H172'), update (target a single cell like 'H42'), or prepend-style edits (read existing, concatenate, write back). Number of inner-array values must match the column count of the address.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  34
• clear-excel-range

  Clear an Excel range. 💡 TIP: Clear cell contents and/or formatting on the given range. Body: { applyTo: 'All' | 'Formats' | 'Contents' }. 'Contents' wipes values but keeps formatting; 'Formats' resets styling but keeps values; 'All' wipes both. Use this to reset a worksheet section before a fresh write rather than overwriting cell-by-cell.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  35
• delete-excel-range

  Delete an Excel range. 💡 TIP: Delete cells at the given range, shifting remaining content. Body: { shift: 'Up' } or { shift: 'Left' }. Use 'Up' to delete entire rows.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  36
• get-excel-range-format

  Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties. Read-only. 💡 TIP: Reads a range's format: alignment, wrapText, columnWidth, rowHeight. Font, fill, and borders are nested and omitted by default; add font, fill, and borders to the $expand parameter to include them in one call. Cell styling often encodes meaning (a fill or font color flagging status such as tentative or reconciled), so expand these to interpret what the cells mean.

  Parameters: select, expand, driveId, driveItemId, workbookWorksheetId, address, fetchAllPages, includeHeaders, excludeResponse
  37
• format-excel-range

  Format an Excel range. 💡 TIP: Apply rangeFormat properties to a specific range. Required path param 'address' (e.g. 'A1:E5' or 'Sheet1!A1:E5'). Body: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Font, fill, and borders are NOT set here; use format-excel-range-font, format-excel-range-fill, and format-excel-range-border for those.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  38
• format-excel-range-border

  Format an Excel range border. 💡 TIP: Sets one border side. The {sideIndex} path param selects which side: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown, or DiagonalUp. To outline all four edges, call once per side.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, sideIndex, includeHeaders, excludeResponse, confirm
  39
• format-excel-range-fill

  Format an Excel range fill. 💡 TIP: Set the background fill color of a range's cells.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  40
• format-excel-range-font

  Format an Excel range font. 💡 TIP: Set font formatting on a range: bold, italic, underline, size, color, and font name.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  41
• insert-excel-range

  Insert an Excel range. 💡 TIP: Insert blank cells at the given range, shifting existing content. Body: { shift: 'Down' } or { shift: 'Right' }. Use 'Down' to insert blank rows above existing data.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  42
• merge-excel-range

  Merge an Excel range. 💡 TIP: Merge the cells in the given range into a single cell. Body: { across: false } merges the entire range into one cell; { across: true } merges each row separately. Useful for building styled headers, banner rows, and report layouts.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  43
• unmerge-excel-range

  Unmerge an Excel range. 💡 TIP: Unmerge any merged cells within the given range back into individual cells. No request body. Inverse of merge-excel-range.

  Parameters: driveId, driveItemId, workbookWorksheetId, address, includeHeaders, excludeResponse, confirm
  44
• create-excel-table

  Create a new table. The range source address determines the worksheet under which the table will be added. If the table can't be added (for example, because the address is invalid, or the table would overlap with another table), an error is generated. 💡 TIP: Convert a worksheet range into a formal Excel table. Body: { address: 'A1:H171', hasHeaders: true }. Required before using add-excel-table-rows / update-excel-table-row / delete-excel-table-row on a plain-cells sheet.

  Parameters: body, driveId, driveItemId, workbookWorksheetId, includeHeaders, excludeResponse, confirm
  45
• get-excel-used-range

  Get an Excel used range. 💡 TIP: Get the smallest range that encompasses any cells with values or formatting on the worksheet. Returns address, values, formulas, numberFormat, rowCount, columnCount. Use this to discover the populated bounds of a sheet before reading or appending — avoids guessing how far data extends. Optional $select to trim the response.

  Parameters: driveId, driveItemId, workbookWorksheetId, fetchAllPages, includeHeaders, excludeResponse
  46
• get-drive-root-item

  The root folder of the drive. Read-only.

  Parameters: select, expand, driveId, fetchAllPages, includeHeaders, excludeResponse
  47
• search-onedrive-files

  Search the hierarchy of items for items matching a query. You can search within a folder hierarchy, a whole drive, or files shared with the current user. 💡 TIP: Searches for files in a drive by name or content. The q parameter searches file names, metadata, and file content. Returns matching driveItems with id, name, webUrl, size, lastModifiedDateTime. Use list-drives first to get the drive-id.

  Parameters: top, skip, search, filter, count, select, orderby, expand, driveId, q, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  48
• get-current-user

  Retrieve the properties and relationships of user object. This operation returns by default only a subset of the more commonly used properties for each user. These default properties are noted in the Properties section. To get properties that are not returned by default, do a GET operation for the user and specify the properties in a $select OData query option. Because the user resource supports extensions, you can also use the GET operation to get custom properties and extension data in a user instance. Customers through Microsoft Entra ID for customers can also use this API operation to retrieve their details.

  Parameters: ConsistencyLevel, select, expand, fetchAllPages, includeHeaders, excludeResponse
  49
• list-my-calendar-permissions

  The permissions of the users with whom the calendar is shared. 💡 TIP: Lists share recipients and delegates on the user's primary calendar. Returns calendarPermission objects with id, role ('none' | 'freeBusyRead' | 'limitedRead' | 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' | 'custom'), emailAddress { name, address }, isInsideOrganization, isRemovable, allowedRoles. Returns an empty collection when called by a delegate or share recipient (only the calendar owner sees the full list). For a non-primary calendar, use /me/calendars/{calendar-id}/calendarPermissions — not currently exposed.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  50
• create-my-calendar-permission

  Create a calendarPermission resource to specify the identity and role of the user with whom the specified calendar is being shared or delegated. 💡 TIP: Shares the user's primary calendar with another user (or sets up a delegate). Body: { emailAddress: { name: 'Adele Vance', address: 'adele@contoso.com' }, role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess', isInsideOrganization: true, isRemovable: true }. Use list-users to resolve the recipient SMTP. Returns the created calendarPermission with its id (used by update-my-calendar-permission and delete-my-calendar-permission).

  Parameters: body, includeHeaders, excludeResponse, confirm
  51
• update-my-calendar-permission

  Update my calendar permission. 💡 TIP: Changes the role (permission level) granted to an existing share recipient or delegate. Body: { role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' }. Only the role property is writable — to change the recipient's email or other properties, delete and recreate via delete-my-calendar-permission + create-my-calendar-permission. Get the permission id via list-my-calendar-permissions.

  Parameters: body, calendarPermissionId, includeHeaders, excludeResponse, confirm
  52
• delete-my-calendar-permission

  Delete my calendar permission. 💡 TIP: Revokes a calendar share or delegate access. Get the permission id via list-my-calendar-permissions. Permissions where isRemovable=false (e.g. the implicit 'My Organization' default) cannot be deleted — Graph returns an error.

  Parameters: If-Match, calendarPermissionId, includeHeaders, excludeResponse, confirm
  53
• list-calendars

  Get all the user's calendars (/calendars navigation property), get the calendars from the default calendar group or from a specific calendar group.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  54
• create-calendar

  Create a new calendar for a user. 💡 TIP: Creates a new personal calendar. Body: { name: 'My Calendar', color: 'auto' }. Available colors: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.

  Parameters: body, includeHeaders, excludeResponse, confirm
  55
• update-calendar

  Update a calendar. 💡 TIP: Updates a calendar's properties. Body: { name: 'New Name', color: 'lightBlue' }. Cannot update the default calendar's name.

  Parameters: body, calendarId, includeHeaders, excludeResponse, confirm
  56
• delete-calendar

  Delete a calendar other than the default calendar. 💡 TIP: Deletes a calendar and all its events. The default calendar cannot be deleted. This action cannot be undone.

  Parameters: If-Match, calendarId, includeHeaders, excludeResponse, confirm
  57
• get-specific-calendar-view

  List the occurrences, exceptions, and single instances of events over a time range, from one of the signed-in user's calendars addressed by calendar ID. 💡 TIP: Returns expanded recurring event instances (not just seriesMaster) within a date range for a specific calendar. Requires startDateTime and endDateTime query parameters in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Each instance includes seriesMasterId and type (occurrence/exception) fields for recurring event linkage. Use fetchAllPages=true to retrieve all results when there are many events. To find Teams meetings, use $select=subject,start,isOnlineMeeting,onlineMeetingProvider,onlineMeeting and keep the events with isOnlineMeeting true and onlineMeetingProvider teamsForBusiness; neither property is filterable (isOnlineMeeting returns 400 ErrorInvalidProperty). Teams meetings expose their join link as onlineMeeting/joinUrl; the event resource has no joinWebUrl property. Pass that joinUrl to list-online-meetings as $filter=J

  Parameters: startDateTime, endDateTime, top, skip, search, filter, count, orderby, select, expand, calendarId, fetchAllPages, skiptoken, includeHeaders, excludeResponse, timezone, expandExtendedProperties
  58
• list-specific-calendar-events

  List events from one of the signed-in user's calendars, addressed by calendar ID. 💡 TIP: WARNING: Does NOT expand recurring events — only returns seriesMaster. Use get-specific-calendar-view instead.

  Parameters: top, skip, search, filter, count, orderby, select, expand, calendarId, fetchAllPages, skiptoken, includeHeaders, excludeResponse, timezone, expandExtendedProperties
  59
• create-specific-calendar-event

  Create a calendar event on a specific calendar. Requires calendarId (the target calendar's ID). Times use nested {dateTime, timeZone} objects — do NOT use startDateTime/startTimeZone. UTC is simplest for one-off events; for recurring events use the organizer's own time zone (from get-mailbox-settings or list-supported-time-zones) instead of UTC, since Graph resolves DST against that zone. 💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients.

  Parameters: body, calendarId, includeHeaders, excludeResponse, confirm
  60
• get-specific-calendar-event

  Get a single event from one of the signed-in user's calendars, addressed by calendar ID and event ID. Any calendar can be addressed this way, including the default one.

  Parameters: select, expand, calendarId, eventId, fetchAllPages, includeHeaders, excludeResponse, timezone, expandExtendedProperties
  61
• update-specific-calendar-event

  Update a specific calendar event. Requires calendarId (from list-calendars) and eventId (from list-specific-calendar-events or get-specific-calendar-view for that same calendar). Times use nested {dateTime, timeZone} objects. UTC is simplest for one-off events; for recurring events use the organizer's own time zone (from get-mailbox-settings or list-supported-time-zones) instead of UTC, since Graph resolves DST against that zone. 💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients. WARNING: Setting attendees replaces the entire attendee list — include all attendees, not just new ones.

  Parameters: body, calendarId, eventId, includeHeaders, excludeResponse, confirm
  62
• delete-specific-calendar-event

  Delete a specific calendar event. Requires calendarId (the target calendar's ID) and eventId (the event's own ID). 💡 TIP: Deleting a seriesMaster deletes ALL occurrences. To cancel a single occurrence, use the specific instance ID.

  Parameters: If-Match, calendarId, eventId, includeHeaders, excludeResponse, confirm
  63
• list-calendar-event-instances

  The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern, and exceptions modified, but doesn't include occurrences canceled from the series. Navigation property. Read-only. Nullable. 💡 TIP: Expand a recurring event into individual instances within a date range. Requires startDateTime and endDateTime query parameters in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Use this to see all occurrences of a recurring event.

  Parameters: startDateTime, endDateTime, top, skip, search, filter, count, orderby, select, expand, calendarId, eventId, fetchAllPages, skiptoken, includeHeaders, excludeResponse, timezone, expandExtendedProperties
  64
• get-calendar-view

  Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's default calendar, or from some other calendar of the user. 💡 TIP: Returns expanded recurring event instances (not just seriesMaster) within a date range for the default calendar. Requires startDateTime and endDateTime query parameters in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Use get-specific-calendar-view if you need a non-default calendar. To find Teams meetings, use $select=subject,start,isOnlineMeeting,onlineMeetingProvider,onlineMeeting and keep the events with isOnlineMeeting true and onlineMeetingProvider teamsForBusiness; neither property is filterable (isOnlineMeeting returns 400 ErrorInvalidProperty). To search by subject, use $filter=contains(subject,'keyword'). Teams meetings expose their join link as onlineMeeting/joinUrl; the event resource has no joinWebUrl property. Pass that joinUrl to list-online-meetings as $filter=JoinWebUrl eq '{url}'

  Parameters: startDateTime, endDateTime, top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse, timezone, expandExtendedProperties
  65
• list-calendar-view-delta

  Get a set of event resources that have been added, deleted, or updated in a calendarView (a range of events defined by start and end dates) of the user's primary calendar. Typically, synchronizing events in a calendarView in a local store entails a round of multiple delta function calls. The initial call is a full synchronization, and every subsequent delta call in the same round gets the incremental changes (additions, deletions, or updates). This allows you to maintain and synchronize a local store of events in the specified calendarView, without having to fetch all the events of that calendar from the server every time. 💡 TIP: Incremental sync of events within a time window. Required query params on first call: startDateTime, endDateTime (ISO 8601). Returns events in the window plus @odata.deltaLink; subsequent calls with that link return only changes. Expands recurring events to individual occurrences (unlike list-calendar-events-delta which returns the series master). Use this f

  Parameters: startDateTime, endDateTime, fetchAllPages, skiptoken, includeHeaders, excludeResponse, timezone
  66
• list-contact-folders

  Get the contact folder collection in the default Contacts folder of the signed-in user. 💡 TIP: Lists the user's Outlook contact folders (the named buckets that organize contacts). Always includes the built-in 'Contacts' folder; user-created folders also appear. Returns id, displayName, and parentFolderId. To identify the default folder, match displayName === 'Contacts'. Use this before list-contact-folder-contacts or create-contact-in-folder to discover folder ids. Supports OData query parameters.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  67
• create-contact-folder

  Create a new contactFolder under the user's default contacts folder. You can also create a new contactfolder as a child of any specified contact folder. 💡 TIP: Creates a new contact folder under the user's mailbox root. Body: { displayName: 'Family' }. Returns the created contactFolder with its id. To create a sub-folder under an existing folder, use create-contact-child-folder.

  Parameters: body, includeHeaders, excludeResponse, confirm
  68
• update-contact-folder

  Update the properties of contactfolder object. 💡 TIP: Updates a contact folder. Body: { displayName?: 'New name', parentFolderId?: '<id>' } — both displayName (rename) and parentFolderId (move) are writable. The default 'Contacts' folder may not be renameable. Get the folder id via list-contact-folders.

  Parameters: body, contactFolderId, includeHeaders, excludeResponse, confirm
  69
• delete-contact-folder

  Delete contactFolder other than the default contactFolder. 💡 TIP: Deletes a contact folder. The default 'Contacts' folder cannot be deleted — Graph returns an error. The folder (and its contents) typically lands in Deleted Items rather than being permanently removed. Get the folder id via list-contact-folders.

  Parameters: If-Match, contactFolderId, includeHeaders, excludeResponse, confirm
  70
• list-contact-folder-child-folders

  Get a collection of child folders under the specified contact folder. 💡 TIP: Lists immediate sub-folders under a given contact folder. Returns id, displayName, parentFolderId. Use list-contact-folders to discover top-level folders, then this tool to traverse one level deeper. Supports $filter, $top, $orderby. Note: contact folders are typically a flat list in Outlook clients, but Graph allows nesting via this endpoint.

  Parameters: top, skip, search, filter, count, orderby, select, expand, contactFolderId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  71
• create-contact-child-folder

  Create a new contactFolder as a child of a specified folder. You can also create a new contactFolder under the user's default contact folder. 💡 TIP: Creates a sub-folder under an existing contact folder. Body: { displayName: 'Sub-folder name' }. Use list-contact-folders to discover the parent id. The returned contactFolder has its own id usable with update-contact-folder, delete-contact-folder, list-contact-folder-contacts, and create-contact-in-folder — contactFolder ids are mailbox-unique regardless of nesting depth.

  Parameters: body, contactFolderId, includeHeaders, excludeResponse, confirm
  72
• list-contact-folder-contacts

  Get a contact collection from the default Contacts folder of the signed-in user (.../me/contacts), or from the specified contact folder. 💡 TIP: Lists contacts inside a specific folder. Pair with list-contact-folders to discover the folder id. Note: the existing list-outlook-contacts (GET /me/contacts) only returns contacts from the default folder — use this tool to read contacts from any folder. Supports $filter, $search='query', $orderby, $top, $select.

  Parameters: top, skip, search, filter, count, orderby, select, expand, contactFolderId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  73
• create-contact-in-folder

  Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder. 💡 TIP: Creates a contact inside a specific folder (instead of the default Contacts folder). Body is a contact resource: { givenName, surname, displayName, emailAddresses: [{ address, name }], businessPhones: [], mobilePhone, jobTitle, companyName, ... }. The existing create-outlook-contact (POST /me/contacts) writes to the default folder only; use this when organizing contacts into named folders. Get the folder id via list-contact-folders.

  Parameters: body, contactFolderId, includeHeaders, excludeResponse, confirm
  74
• list-outlook-contacts

  Get a contact collection from the default contacts folder of the signed-in user. There are two scenarios where an app can get contacts in another user's contact folder: 💡 TIP: $filter only supports startswith() — contains() and eq on emailAddresses do not work. Use $search as alternative for broader matching.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  75
• create-outlook-contact

  Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.

  Parameters: body, includeHeaders, excludeResponse, confirm
  76
• get-outlook-contact

  Retrieve the properties and relationships of a contact object. There are two scenarios where an app can get a contact in another user's contact folder:

  Parameters: select, expand, contactId, fetchAllPages, includeHeaders, excludeResponse
  77
• update-outlook-contact

  Update the properties of a contact object. 💡 TIP: emailAddresses array is replaced entirely — include all addresses, not just new ones.

  Parameters: body, contactId, includeHeaders, excludeResponse, confirm
  78
• delete-outlook-contact

  Delete a contact.

  Parameters: If-Match, contactId, includeHeaders, excludeResponse, confirm
  79
• list-drives

  Retrieve the list of Drive resources available for a target User, Group, or Site.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  80
• list-calendar-events

  Get a list of event objects in the user's mailbox. The list contains single instance meetings and series masters. To get expanded event instances, you can get the calendar view, or get the instances of an event. Currently, this operation returns event bodies in only HTML format. There are two scenarios where an app can get events in another user's calendar: 💡 TIP: WARNING: Does NOT expand recurring events — only returns seriesMaster. Use get-calendar-view instead to see individual occurrences within a date range.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse, timezone, expandExtendedProperties
  81
• create-calendar-event

  Create (schedule) a new calendar event — a meeting or appointment — on the user's calendar. Times use nested objects, not flat fields: start: {dateTime, timeZone}, end: {dateTime, timeZone}. Do NOT use startDateTime/startTimeZone. For one-off events, UTC is simplest (e.g. 3:30 PM AEDT = 04:30 UTC). For recurring events, use the organizer's own time zone name instead — Graph resolves DST against the zone in start.timeZone, so UTC drifts after DST changes. Get the zone from get-mailbox-settings, or validate one with list-supported-time-zones instead of guessing from memory. Set subject, location, body, and attendees; supports online meetings and recurrence. 💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients.

  Parameters: body, includeHeaders, excludeResponse, confirm
  82
• get-calendar-event

  Get the properties and relationships of the specified event object. Currently, this operation returns event bodies in only HTML format. There are two scenarios where an app can get an event in another user's calendar: Since the event resource supports extensions, you can also use the GET operation to get custom properties and extension data in an event instance.

  Parameters: select, expand, eventId, fetchAllPages, includeHeaders, excludeResponse, timezone, expandExtendedProperties
  83
• update-calendar-event

  Update an event on the default calendar. Requires eventId (the event's ID from get-calendar-view or list-calendar-events). Times use nested {dateTime, timeZone} objects. UTC is simplest for one-off events; for recurring events use the organizer's own time zone (from get-mailbox-settings or list-supported-time-zones) instead of UTC, since Graph resolves DST against that zone. 💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients. WARNING: Setting attendees replaces the entire attendee list — include all attendees, not just new ones.

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  84
• delete-calendar-event

  Removes the specified event from the containing calendar. If the event is a meeting, deleting the event on the organizer's calendar sends a cancellation message to the meeting attendees. 💡 TIP: Deleting a seriesMaster deletes ALL occurrences of the recurring event. To cancel a single occurrence, delete that specific instance ID from list-calendar-event-instances.

  Parameters: If-Match, eventId, includeHeaders, excludeResponse, confirm
  85
• accept-calendar-event

  Accept the specified event in a user calendar. 💡 TIP: Accepts a meeting invitation. Optional body: { sendResponse: true, comment: 'I will attend.' }. Set sendResponse to false to accept silently without notifying the organizer.

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  86
• add-calendar-event-attachment

  Use this API to add an attachment to an existing event. This operation limits the size of the attachment you can add to under 3 MB. If an organizer adds an attachment to a meeting event, the organizer can subsequently update the event to send the attachment and update the event for each attendee as well. 💡 TIP: Under 3MB only. Body requires @odata.type: {"@odata.type": "#microsoft.graph.fileAttachment", "name": "file.pdf", "contentBytes": "<base64>"}. At 3MB and above use create-calendar-event-attachment-upload-session.

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  87
• create-calendar-event-attachment-upload-session

  Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to the specified Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that's smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example. 💡 TIP: For attachments 3MB to 150MB; under 3MB use add-calendar-event-attachment. Body: { AttachmentItem: {

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  88
• cancel-calendar-event

  This action allows the organizer of a meeting to send a cancellation message and cancel the event. The action moves the event to the Deleted Items folder. The organizer can also cancel an occurrence of a recurring meeting by providing the occurrence event ID. An attendee calling this action gets an error (HTTP 400 Bad Request), with the following error message: 'Your request can't be completed. You need to be an organizer to cancel a meeting.' This action differs from Delete in that Cancel is available to only the organizer, and lets the organizer send a custom message to the attendees about the cancellation. 💡 TIP: Cancels a meeting (organizer only) and sends a cancellation message to all attendees. Body: { Comment (optional string, custom message) }. Use this instead of delete-calendar-event when you want attendees to see 'Canceled' in their calendar. Attendees calling this get HTTP 400 — they should use decline-calendar-event instead.

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  89
• decline-calendar-event

  Decline invitation to the specified event in a user calendar. If the event allows proposals for new times, on declining the event, an invitee can choose to suggest an alternative time by including the proposedNewTime parameter. For more information on how to propose a time, and how to receive and accept a new time proposal, see Propose new meeting times. 💡 TIP: Declines a meeting invitation. Optional body: { sendResponse: true, comment: 'Cannot attend, conflict.' }. The event remains in the calendar as declined unless the user deletes it.

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  90
• dismiss-calendar-event-reminder

  Dismiss a reminder that has been triggered for an event in a user calendar. 💡 TIP: Dismisses a triggered event reminder so it won't re-fire. No request body required. Pair with list-calendar-events or get-schedule to find active reminders.

  Parameters: eventId, includeHeaders, excludeResponse, confirm
  91
• forward-calendar-event

  This action allows the organizer or attendee of a meeting event to forward the meeting request to a new recipient. If the meeting event is forwarded from an attendee's Microsoft 365 mailbox to another recipient, this action also sends a message to notify the organizer of the forwarding, and adds the recipient to the organizer's copy of the meeting event. This convenience is not available when forwarding from an Outlook.com account. 💡 TIP: Forwards a meeting invitation to additional recipients. Body: { ToRecipients: [{ emailAddress: { address, name } }], Comment (optional) }. If the forwarder is an attendee (not organizer), the organizer is also notified and the new recipient is added to the organizer's attendee list.

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  92
• snooze-calendar-event-reminder

  Postpone a reminder for an event in a user calendar until a new time. 💡 TIP: Postpones a triggered event reminder. Body: { NewReminderTime: { dateTime (ISO 8601), timeZone (IANA or Windows, e.g. 'Pacific Standard Time') } }. The reminder will re-fire at the new time.

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  93
• tentatively-accept-calendar-event

  Tentatively accept the specified event in a user calendar. If the event allows proposals for new times, on responding tentative to the event, an invitee can choose to suggest an alternative time by including the proposedNewTime parameter. For more information on how to propose a time, and how to receive and accept a new time proposal, see Propose new meeting times. 💡 TIP: Tentatively accepts a meeting invitation. Optional body: { sendResponse: true, comment: 'I might be able to attend.' }. Use proposedNewTime to suggest an alternative: { proposedNewTime: { start: { dateTime, timeZone }, end: { dateTime, timeZone } } }.

  Parameters: body, eventId, includeHeaders, excludeResponse, confirm
  94
• list-calendar-events-delta

  Get a set of event resources that have been added, deleted, or updated in a calendarView (a range of events defined by start and end dates) of the user's primary calendar. Typically, synchronizing events in a calendarView in a local store entails a round of multiple delta function calls. The initial call is a full synchronization, and every subsequent delta call in the same round gets the incremental changes (additions, deletions, or updates). This allows you to maintain and synchronize a local store of events in the specified calendarView, without having to fetch all the events of that calendar from the server every time. 💡 TIP: Incremental sync of events across the default calendar. First call returns all events plus @odata.deltaLink. Subsequent calls with that link return only additions/updates/removals. Deltas expire after ~30 days — start over if the server returns 410 Gone. For a time-bounded view with delta semantics, use list-calendar-view-delta instead.

  Parameters: startDateTime, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  95
• get-mail-tips

  Get the MailTips of one or more recipients as available to the signed-in user. Note that by making a POST call to the getMailTips action, you can request specific types of MailTips to be returned for more than one recipient at one time. The requested MailTips are returned in a mailTips collection. 💡 TIP: Looks up MailTips for one or more recipients before sending an email — answers 'is this person on auto-reply / OOF?', 'will my email exceed their mailbox quota?', 'are they an external recipient?', 'is this a mailbox or distribution list?'. Body: { EmailAddresses: ['user@contoso.com', ...], MailTipsOptions: 'automaticReplies, mailboxFullStatus, customMailTip, externalMemberCount, totalMemberCount, maxMessageSize, deliveryRestriction, moderationStatus, recipientScope, recipientSuggestions' (comma-separated subset) }. Returns mailTips per recipient with the requested fields populated. Use this to short-circuit urgent emails when a recipient is OOF, or to warn before fanning out to a la

  Parameters: body, includeHeaders, excludeResponse
  96
• list-focused-inbox-overrides

  Get the overrides that a user has set up to always classify messages from certain senders in specific ways. Each override corresponds to an SMTP address of a sender. Initially, a user doesn't have any overrides. 💡 TIP: Lists Focused Inbox classification overrides — explicit rules that force messages from a given sender (by SMTP address) into either the Focused or Other tab, regardless of what the Outlook ML classifier would predict. Each override has id, classifyAs ('focused' or 'other'), and senderEmailAddress {name, address}. Returns an empty collection if the user has never set an override.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  97
• create-focused-inbox-override

  Create an override for a sender identified by an SMTP address. Future messages from that SMTP address will be consistently classified as specified in the override. Note 💡 TIP: Creates a Focused Inbox override for a sender. Body: { classifyAs: 'focused', senderEmailAddress: { name: 'Display Name', address: 'sender@example.com' } }. classifyAs must be 'focused' or 'other'. If an override already exists for that SMTP address, POST updates the existing override's name and classifyAs (use this to rename a sender). Resolve the sender's address with list-users or by reading a recent mail header — do not invent SMTP addresses.

  Parameters: body, includeHeaders, excludeResponse, confirm
  98
• update-focused-inbox-override

  Change the classifyAs field of an override as specified. You cannot use PATCH to change any other fields in an inferenceClassificationOverride instance. If an override exists for a sender and the sender changes his/her display name, you can use POST to force an update to the name field in the existing override. If an override exists for a sender and the sender changes his/her SMTP address, deleting the existing override and creating a new one with the new SMTP address is the only way to 'update' the override for this sender. 💡 TIP: Updates the classifyAs field of an existing override. Body: { classifyAs: 'focused' } or { classifyAs: 'other' }. Per Graph API, PATCH cannot change senderEmailAddress — to change the SMTP address, delete and recreate the override. To rename the display name only, POST a new override with the same SMTP address (it will overwrite the name).

  Parameters: body, inferenceClassificationOverrideId, includeHeaders, excludeResponse, confirm
  99
• delete-focused-inbox-override

  Delete an override specified by its ID. 💡 TIP: Deletes a Focused Inbox override. Future messages from that sender revert to the Outlook ML classifier's default behavior. Use list-focused-inbox-overrides to find the ID first.

  Parameters: If-Match, inferenceClassificationOverrideId, includeHeaders, excludeResponse, confirm
  100
• get-mailbox-settings

  Get the user's mailboxSettings. You can view all mailbox settings, or get specific settings. Users can set the following settings for their mailboxes through an Outlook client: Users can set their preferred date and time formats using Outlook on the web. Users can choose one of the supported short date or short time formats. This GET operation returns the format the user has chosen. Users can set the time zone they prefer on any Outlook client, by choosing from the supported time zones that their administrator has set up for their mailbox server. The administrator can set up time zones in the Windows time zone format or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. The Windows format is the default. This GET operation returns the user's preferred time zone in the format that the administrator has set up. If you want that time zone to be in a specific format (Windows or IANA), you can first update the preferred time zone in that format as

  Parameters: select, expand, fetchAllPages, includeHeaders, excludeResponse
  101
• update-mailbox-settings

  Enable, configure, or disable one or more of the following settings as part of a user's mailboxSettings: When updating the preferred date or time format for a user, specify it in respectively, the short date or short time format. When updating the preferred time zone for a user, specify it in the Windows or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. You can also further customize the time zone as shown in example 2 below. 💡 TIP: Updates mailbox settings. Common use: configure Out-of-Office (automatic replies). Body example: { automaticRepliesSetting: { status: 'scheduled', scheduledStartDateTime: { dateTime: '2026-03-28T17:00:00', timeZone: 'Eastern Standard Time' }, scheduledEndDateTime: { dateTime: '2026-04-01T08:00:00', timeZone: 'Eastern Standard Time' }, internalReplyMessage: 'I am OOO.', externalReplyMessage: 'I am out of office.' } }. Status values: disabled, alwaysEnabled, scheduled.

  Parameters: body, includeHeaders, excludeResponse, confirm
  102
• list-mail-folders

  Get the mail folder collection directly under the root folder of the signed-in user. The returned collection includes any mail search folders directly under the root. By default, this operation doesn't return hidden folders. Use a query parameter includeHiddenFolders to include them in the response. This operation doesn't return all mail folders in a mailbox, only the child folders of the root folder. To return all mail folders in a mailbox, each child folder must be traversed separately.

  Parameters: includeHiddenFolders, top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  103
• create-mail-folder

  Use this API to create a new mail folder in the root folder of the user's mailbox. If you intend a new folder to be hidden, you must set the isHidden property to true on creation. 💡 TIP: Creates a top-level mail folder. Use create-mail-child-folder to create a subfolder inside an existing folder. Use list-mail-folders to find existing folder IDs.

  Parameters: body, includeHeaders, excludeResponse, confirm
  104
• update-mail-folder

  Update the properties of mailfolder object. 💡 TIP: Renames a mail folder by updating its displayName. Use list-mail-folders to find the folder ID.

  Parameters: body, mailFolderId, includeHeaders, excludeResponse, confirm
  105
• delete-mail-folder

  Delete the specified mailFolder. The folder can be a mailSearchFolder. You can specify a mail folder by its folder ID, or by its well-known folder name, if one exists. 💡 TIP: Deletes a mail folder and all its contents. This action is irreversible. Use list-mail-folders to find the folder ID.

  Parameters: If-Match, mailFolderId, includeHeaders, excludeResponse, confirm
  106
• list-mail-child-folders

  Get the folder collection under the specified folder. You can use the .../me/mailFolders shortcut to get the top-level folder collection and navigate to another folder. By default, this operation doesn't return hidden folders. Use a query parameter includeHiddenFolders to include them in the response.

  Parameters: includeHiddenFolders, top, skip, search, filter, count, orderby, select, expand, mailFolderId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  107
• create-mail-child-folder

  Use this API to create a new child mailFolder. If you intend a new folder to be hidden, you must set the isHidden property to true on creation. 💡 TIP: Creates a subfolder inside an existing mail folder. Use list-mail-folders or list-mail-child-folders to find the parent folder ID.

  Parameters: body, mailFolderId, includeHeaders, excludeResponse, confirm
  108
• list-mail-rules

  Get all the messageRule objects defined for the user's inbox. 💡 TIP: Lists all message rules for a mail folder. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules. Each rule has displayName, sequence, isEnabled, conditions (fromAddresses, subjectContains, etc.), actions (moveToFolder, forwardTo, delete, etc.), and exceptions.

  Parameters: top, skip, search, filter, count, orderby, select, expand, mailFolderId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  109
• create-mail-rule

  Create a messageRule object by specifying a set of conditions and actions. Outlook carries out those actions if an incoming message in the user's Inbox meets the specified conditions. 💡 TIP: Creates a message rule for a mail folder. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules. Body: { displayName: 'Rule name', sequence: 1, isEnabled: true, conditions: { fromAddresses: [{ emailAddress: { address: 'user@example.com' } }] }, actions: { moveToFolder: 'folder-id' } }. Actions: moveToFolder, copyToFolder, forwardTo, forwardAsAttachmentTo, delete, markAsRead, markImportance, stopProcessingRules.

  Parameters: body, mailFolderId, includeHeaders, excludeResponse, confirm
  110
• update-mail-rule

  Change writable properties on a messageRule object and save the changes. 💡 TIP: Updates an existing message rule. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules. Send only the properties to change. Common use: { isEnabled: false } to disable a rule, or update conditions/actions.

  Parameters: body, mailFolderId, messageRuleId, includeHeaders, excludeResponse, confirm
  111
• delete-mail-rule

  Delete the specified messageRule object. 💡 TIP: Deletes a message rule permanently. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules.

  Parameters: If-Match, mailFolderId, messageRuleId, includeHeaders, excludeResponse, confirm
  112
• list-mail-folder-messages

  Get all the messages in the specified user's mailbox, or those messages in a specified folder in the mailbox. 💡 TIP: List read search Outlook emails within a specific mail folder. CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search="your search query here". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:alice AND importance:high". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter IMPORTANT: Always use $select to limit returned fields and reduce response size. Recommended default: $select=id,subject,from,toRecipients,receivedDateTime,b

  Parameters: top, skip, search, filter, count, orderby, select, expand, mailFolderId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  113
• list-mail-folder-messages-delta

  Get a set of messages added, deleted, or updated in a specified folder. A delta function call for messages in a folder is similar to a GET request, except that by appropriately applying state tokens in one or more of these calls, you can [query for incremental changes in the messages in that folder](/graph/delta-query-messages). It allows you to maintain and synchronize a local store of a user's messages without having to fetch the entire set of messages from the server every time. 💡 TIP: Incremental sync of messages within a mail folder. Graph only supports delta scoped to a folder — use mailFolder-id = 'inbox' for the well-known inbox, or another folder id from list-mail-folders. First call returns all messages plus @odata.deltaLink; subsequent calls with that link return only changes (created/updated/deleted). @odata.nextLink paginates within a single delta window. Deltas expire after ~30 days of inactivity — start over if the server returns 410. Prefer this over full re-list for

  Parameters: changeType, top, skip, search, filter, count, select, orderby, expand, mailFolderId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  114
• list-mail-messages

  List, search, and filter Outlook email messages in the signed-in user's mailbox across all folders. Returns message metadata (subject, from, receivedDateTime, isRead, hasAttachments) plus a body preview. Use $search for keyword queries, $filter to narrow by sender/read state/date, $top to limit page size, and $select to trim fields. 💡 TIP: List read search my Outlook emails across folders. CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search="your search query here". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:john AND importance:high". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://

  Parameters: includeHiddenMessages, top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  115
• create-draft-email

  Create a draft Outlook email message in the signed-in user's Drafts folder. Set subject, body, toRecipients, ccRecipients, and importance. The draft is saved, not sent — use send-mail to send a message directly, or send the draft afterwards.

  Parameters: body, includeHeaders, excludeResponse, confirm
  116
• get-mail-message

  Get a single Outlook email message by its message ID, including full subject, sender, recipients, body, and attachment flags. Use list-mail-messages first to obtain the message ID.

  Parameters: select, expand, messageId, fetchAllPages, includeHeaders, excludeResponse
  117
• update-mail-message

  Update an existing Outlook email message by its message ID — for example mark it read or unread (isRead), flag it (flag), change its categories, importance, or edit a draft's subject, body, or recipients.

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  118
• delete-mail-message

  Delete an Outlook email message by its message ID. This is a soft delete that moves the message to Deleted Items. 💡 TIP: Soft delete — moves to Deleted Items. To permanently delete, delete again from Deleted Items.

  Parameters: If-Match, messageId, includeHeaders, excludeResponse, confirm
  119
• get-mail-message-mime

  Download the raw MIME source (RFC 5322 .eml content) of an Outlook email message by its message ID. Returns the complete original message including headers and encoded attachments. 💡 TIP: Download an email message as raw RFC 5322 MIME content (.eml format). Use this when archiving an email to disk preserving all original headers, body, and inline-encoded attachments. Returns the MIME stream as text. Find the message id with list-mail-messages first.

  Parameters: includeHiddenMessages, messageId, Accept, fileName, fetchAllPages, includeHeaders, excludeResponse
  120
• list-mail-attachments

  Retrieve a list of attachment objects. 💡 TIP: Lists attachments on a message: id, name, contentType, size, isInline. To download the bytes, call download-bytes with target=/me/messages/{message-id}/attachments/{attachment-id}/$value (the /$value suffix returns raw bytes; the bare attachment URL embeds contentBytes in JSON which can truncate large files).

  Parameters: top, skip, search, filter, count, orderby, select, expand, messageId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  121
• add-mail-attachment

  Use this API to create a new Attachment. An attachment can be one of the following types: All these types of attachment resources are derived from the attachment resource. 💡 TIP: The only path for attachments under 3MB. contentBytes must carry the complete base64 verbatim; a truncated argument fails with 400 UnableToDeserializePostBody. At 3MB and above use create-mail-attachment-upload-session, which rejects anything smaller. Body requires @odata.type: {"@odata.type": "#microsoft.graph.fileAttachment", "name": "file.pdf", "contentBytes": "<base64>"}.

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  122
• delete-mail-attachment

  Delete a mail attachment.

  Parameters: If-Match, messageId, attachmentId, includeHeaders, excludeResponse, confirm
  123
• get-mail-attachment-content

  Download the raw bytes of a file attachment of an Outlook message in the signed-in user's mailbox, by message ID and attachment ID. 💡 TIP: Find the attachment id with list-mail-attachments first. With the server's blob output on, the bytes come back as a file resource; pass fileName (the attachment's name) to name it. Files over the server's download limit are refused with an error naming the limit.

  Parameters: messageId, attachmentId, fileName, fetchAllPages, includeHeaders, excludeResponse
  124
• create-mail-attachment-upload-session

  Create an upload session that allows an app to iteratively upload ranges of a file, so as to attach the file to the specified Outlook item. The item can be a message or event. Use this approach to attach a file if the file size is between 3 MB and 150 MB. To attach a file that's smaller than 3 MB, do a POST operation on the attachments navigation property of the Outlook item; see how to do this for a message or for an event. As part of the response, this action returns an upload URL that you can use in subsequent sequential PUT queries. Request headers for each PUT operation let you specify the exact range of bytes to be uploaded. This allows transfer to be resumed, in case the network connection is dropped during upload. The following are the steps to attach a file to an Outlook item using an upload session: See attach large files to Outlook messages or events for an example. 💡 TIP: For attachments 3MB to 150MB. Graph rejects smaller files with ErrorAttachmentSizeShouldNotBeLessThan

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  125
• copy-mail-message

  Copy a message to a folder within the user's mailbox. 💡 TIP: Copies a message to another mail folder. Body: { DestinationId: '<mailFolder-id or well-known name like inbox, archive, junkemail>' }. Returns the newly created message (with a new id) in the destination folder. For moving instead of copying, use move-mail-message.

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  126
• create-forward-draft

  Create a forward draft. 💡 TIP: Create a forward draft (does not send). Useful when user wants to review before sending.

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  127
• create-reply-draft

  Create a draft to reply to the sender of a message in either JSON or MIME format. When using JSON format: - Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error. - If replyTo is specified in the original message, per Internet Message Format (RFC 2822), you should send the reply to the recipients in replyTo, and not the recipients in from. - You can update the draft later to add reply content to the body or change other message properties. When using MIME format: - Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body. - Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply to a message in a single operation. 💡 TIP: For HTML replies pass Message.body.contentType: 'html' with Message.body.content as HTML. Note: supplying Message.body replaces the whole draft body, so

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  128
• create-reply-all-draft

  Create a draft to reply to the sender and all recipients of a message in either JSON or MIME format. When using JSON format: - Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error. - If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), you should send the reply to the recipients in the replyTo and toRecipients properties, and not the recipients in the from and toRecipients properties. - You can update the draft later to add reply content to the body or change other message properties. When using MIME format: - Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body. - Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, reply-all to a message in a single action. 💡 TIP: For HTML replies pass Message.body.contentType:

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  129
• forward-mail-message

  Forward a message using either JSON or MIME format. When using JSON format, you can: - Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error. - Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error. When using MIME format: - Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body. - Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to forward a message, and send it later. 💡 TIP: Forward an email preserving full HTML formatting and attachments. The 'comment' field adds text above the forwarded content. toRecipients is required. Do NOT reconstruct the email manually - this endpoint handles everything server-side.

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  130
• move-mail-message

  Move a message to another folder within the specified user's mailbox. This creates a new copy of the message in the destination folder and removes the original message. 💡 TIP: destinationId accepts folder ID or well-known name (inbox, drafts, sentitems, deleteditems, junkemail, archive).

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  131
• reply-mail-message

  Reply to the sender of a message using either JSON or MIME format. When using JSON format: * Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error. * If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format: - Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body. - Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply to an existing message and send it later. 💡 TIP: Reply to an email preserving full HTML formatting. The 'comment' field is your reply text. Do NOT reconstruct the email manually.

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  132
• reply-all-mail-message

  Reply to all recipients of a message using either JSON or MIME format. When using JSON format: - Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error. - If the original message specifies a recipient in the replyTo property, per Internet Message Format (RFC 2822), send the reply to the recipients in replyTo and not the recipient in the from property. When using MIME format: - Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body. - Add any attachments and S/MIME properties to the MIME content. This method saves the message in the Sent Items folder. Alternatively, create a draft to reply-all to a message and send it later. 💡 TIP: Reply-all preserving full HTML formatting. The 'comment' field is your reply text.

  Parameters: body, messageId, includeHeaders, excludeResponse, confirm
  133
• send-draft-message

  Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation. 💡 TIP: No request body needed — just call with the message ID. Draft must exist in Drafts folder.

  Parameters: messageId, includeHeaders, excludeResponse, confirm
  134
• list-onenote-notebooks

  Retrieve a list of notebook objects.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  135
• create-onenote-notebook

  Create a new OneNote notebook. 💡 TIP: Creates a new OneNote notebook. Body: { displayName: 'Notebook Name' }. The name must be unique across the user's notebooks.

  Parameters: body, includeHeaders, excludeResponse, confirm
  136
• list-onenote-notebook-sections

  Retrieve a list of onenoteSection objects from the specified notebook.

  Parameters: top, skip, search, filter, count, orderby, select, expand, notebookId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  137
• create-onenote-section

  Create a new onenoteSection in the specified notebook. 💡 TIP: Creates a new section in a notebook. Body: { displayName: 'Section Name' }.

  Parameters: body, notebookId, includeHeaders, excludeResponse, confirm
  138
• list-onenote-pages

  Retrieve a list of page objects. 💡 TIP: Lists all OneNote pages across every notebook and section the user has access to — transverse alternative to walking notebooks → sections → pages. Default returns top 20 ordered by lastModifiedTime desc. Supports $filter (e.g. lastModifiedTime gt 2026-01-01, or contains(tolower(title), 'topic') for title search), $top (max 100), $select, and $expand=parentNotebook,parentSection. Use this instead of bouncing through list-onenote-notebooks / list-all-onenote-sections / list-onenote-section-pages when you have a topic in mind.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  139
• create-onenote-page

  Create a new OneNote page in the default section of the default notebook. To create a page in a different section in the default notebook, you can use the sectionName query parameter. Example: ../onenote/pages?sectionName=My%20section The POST /onenote/pages operation is used only to create pages in the current user's default notebook. If you're targeting other notebooks, you can create pages in a specified section. 💡 TIP: Body must be a full HTML document (with <html><head><title>...</title></head><body>...</body></html>). Partial HTML or plain text fails silently or creates malformed pages.

  Parameters: body, includeHeaders, excludeResponse, confirm
  140
• delete-onenote-page

  Delete a OneNote page. 💡 TIP: Deletes a OneNote page permanently. This cannot be undone.

  Parameters: If-Match, onenotePageId, includeHeaders, excludeResponse, confirm
  141
• get-onenote-page-content

  The page's HTML content.

  Parameters: onenotePageId, fetchAllPages, includeHeaders, excludeResponse
  142
• list-onenote-section-groups

  Retrieve a list of sectionGroup objects. 💡 TIP: Lists all OneNote section groups (subfolders inside notebooks that contain their own sections and nested section groups) for the user. A section group is a folder-like container — many notebooks use them to organize sections by theme. Default sort is name asc. Supports $expand=sections,sectionGroups,parentNotebook,parentSectionGroup to traverse the full hierarchy. Pair with list-onenote-notebooks for a complete picture of the user's notebook structure.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  143
• list-all-onenote-sections

  Retrieve a list of onenoteSection objects. 💡 TIP: Lists all sections across all notebooks. Use list-onenote-notebook-sections to list sections within a specific notebook instead.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  144
• list-onenote-section-pages

  Retrieve a list of page objects from the specified section.

  Parameters: top, skip, search, filter, count, orderby, select, expand, onenoteSectionId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  145
• create-onenote-section-page

  Create a new page in the specified section. 💡 TIP: Body must be a full HTML document (with <html><head><title>...</title></head><body>...</body></html>). Partial HTML fails silently.

  Parameters: body, onenoteSectionId, includeHeaders, excludeResponse, confirm
  146
• list-outlook-categories

  Get all the categories that have been defined for a user. 💡 TIP: Lists the user's Outlook categories (colored labels) used to tag messages, events, contacts, and tasks. Each category has displayName and color (preset0 through preset24, or 'none'). Use this to show available tags before applying via update-mail-message or update-calendar-event with body { categories: ['Category Name'] }.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  147
• create-outlook-category

  Create an outlookCategory object in the user's master list of categories. 💡 TIP: Creates a new Outlook category. Body: { displayName (unique), color (one of: none, preset0 … preset24 — maps to red, orange, yellow, green, teal, olive, blue, purple, cranberry, steel, dark-steel, gray, dark-gray, black, dark-red, dark-orange, dark-yellow, dark-green, dark-teal, dark-olive, dark-blue, dark-purple, dark-cranberry) }. Category names are case-sensitive when applied to messages/events.

  Parameters: body, includeHeaders, excludeResponse, confirm
  148
• list-supported-languages

  Get the list of locales and languages that are supported for the user, as configured on the user's mailbox server. When setting up an Outlook client, the user selects the preferred language from this supported list. You can subsequently get the preferred language by getting the user's mailbox settings. 💡 TIP: Lists locales and languages the user's mailbox server supports for the Outlook UI and message rendering. Returns localeInfo objects with locale (e.g. 'en-US') and displayName ('English (United States)'). Use this to validate the locale value before calling update-mailbox-settings to change the user's preferred language.

  Parameters: top, skip, search, filter, count, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  149
• list-supported-time-zones

  Get the list of time zones that are supported for the user, as configured on the user's mailbox server. You can explicitly specify to have time zones returned in the Windows time zone format or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. The Windows format is the default. When setting up an Outlook client, the user selects the preferred time zone from this supported list. You can subsequently get the preferred time zone by getting the user's mailbox settings. 💡 TIP: Lists time zones the user's mailbox server supports. TimeZoneStandard path parameter must be one of: Windows (default — Windows time zone names like 'Pacific Standard Time'), or Iana (IANA / Olson names like 'America/Los_Angeles'). Note the PascalCase — the values are case-sensitive enums, not lowercase strings. Returns timeZoneInformation objects with alias and displayName. Use the result to validate or look up the value before calling update-mailbox-settings to change th

  Parameters: top, skip, search, filter, count, TimeZoneStandard, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  150
• upload-my-profile-photo

  Update the photo for the specified contact, group, team, or user in a tenant. The size of the photo you can update to is limited to 4 MB. You can use either PATCH or PUT for this operation. 💡 TIP: Uploads a new profile photo for the signed-in user. Body is a base64-encoded string of the image bytes (the server decodes before PUT). Photo must be JPEG, max 4 MB; the base64 travels as a tool argument and a truncated one is written without error, so resize before encoding instead of emitting a large string. Microsoft 365 generates HD downsized variants automatically (48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, 648x648). For work or school accounts, ProfilePhoto.ReadWrite.All is the more granular alternative permission. Use download-bytes with target=/me/photo/$value to retrieve the current photo.

  Parameters: body, includeHeaders, excludeResponse, confirm
  151
• list-planner-tasks

  Retrieve a list of plannertask objects assigned to a User. 💡 TIP: Priority is 0-10 (lower = higher priority); Planner's own UI presets are 1=Urgent, 3=Important, 5=Medium, 9=Low.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  152
• send-mail

  Send the message specified in the request body using either JSON or MIME format. When using JSON format, you can include a file attachment in the same sendMail action call. When using MIME format: This method saves the message in the Sent Items folder. Alternatively, create a draft message to send later. To learn more about the steps involved in the backend before a mail is delivered to recipients, see here. 💡 TIP: CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients.

  Parameters: body, includeHeaders, excludeResponse, confirm
  153
• list-todo-task-lists

  Get a list of the todoTaskList objects and their properties. 💡 TIP: Lists all To Do task lists. Returns todoTaskList-id needed for all task operations. The default list is typically called 'Tasks'. NOTE: $select is NOT supported by this endpoint — do not pass select parameter, Graph returns 400.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  154
• create-todo-task-list

  Create a new lists object. 💡 TIP: Creates a new Microsoft To Do task list (the named buckets shown in the To Do app sidebar). Body: { displayName: 'My new list' }. Returns the created todoTaskList with its id, displayName, isOwner, isShared, and wellknownListName ('none' for user-created lists). The built-in lists ('Tasks', 'Flagged emails') already exist and cannot be re-created. Pair with create-todo-task to populate it.

  Parameters: body, includeHeaders, excludeResponse, confirm
  155
• update-todo-task-list

  Update the properties of a todoTaskList object. 💡 TIP: Renames a Microsoft To Do task list. Body: { displayName: 'New name' }. Only displayName is writable. Built-in lists (Flagged emails, the default Tasks list) cannot be renamed — the API returns an error. Get list ids via list-todo-task-lists.

  Parameters: body, todoTaskListId, includeHeaders, excludeResponse, confirm
  156
• delete-todo-task-list

  Deletes a todoTaskList object. 💡 TIP: Deletes a Microsoft To Do task list. Built-in lists (Flagged emails, the default Tasks list) cannot be deleted — the API returns an error for those. Get list ids via list-todo-task-lists.

  Parameters: If-Match, todoTaskListId, includeHeaders, excludeResponse, confirm
  157
• list-todo-tasks

  Get the todoTask resources from the tasks navigation property of a specified todoTaskList. 💡 TIP: Lists tasks in a To Do list. Requires todoTaskList-id — use list-todo-task-lists to find it. NOTE: $select is NOT supported — do not pass select, Graph returns 400. Use $filter=status eq 'notStarted' or $filter=status eq 'completed' to filter by status. Use $top to limit results. Status values: 'notStarted', 'inProgress', 'completed', 'waitingOnOthers', 'deferred'.

  Parameters: top, skip, search, filter, count, orderby, select, expand, todoTaskListId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  158
• create-todo-task

  Create a new task object in a specified todoTaskList. 💡 TIP: Creates a new task in a Microsoft To Do list. Body: { title: "..." }; optional dueDateTime, reminderDateTime, importance, body (notes), recurrence, categories, and checklistItems: [{ displayName: "...", isChecked: false }] to create the task's steps inline (isChecked is optional). Requires todoTaskListId from list-todo-task-lists. To change steps after the task exists, use the *-todo-checklist-item tools.

  Parameters: body, todoTaskListId, includeHeaders, excludeResponse, confirm
  159
• get-todo-task

  Read the properties and relationships of a todoTask object. 💡 TIP: Returns a single To Do task. NOTE: $select is NOT supported — do not pass select parameter, Graph returns RequestBroker--ParseUri (400). Use $expand=linkedResources to include linked email/resource. Returns body content (HTML format), checklist items, and linked resources.

  Parameters: select, expand, todoTaskListId, todoTaskId, fetchAllPages, includeHeaders, excludeResponse
  160
• update-todo-task

  Update the properties of a todoTask object. 💡 TIP: Updates a Microsoft To Do task. Use this to mark a to-do item complete or done (body: { status: "completed" }), reopen it (status: "notStarted"), rename it (title), or change its due date (dueDateTime), reminder (reminderDateTime), importance, or notes (body). Requires todoTaskListId from list-todo-task-lists and todoTaskId from list-todo-tasks. Steps (checklistItems) can't be changed here: Graph rejects checklistItems in a PATCH on the task with 400. Use create-todo-checklist-item, update-todo-checklist-item, or delete-todo-checklist-item instead.

  Parameters: body, todoTaskListId, todoTaskId, includeHeaders, excludeResponse, confirm
  161
• delete-todo-task

  Delete a todoTask object.

  Parameters: If-Match, todoTaskListId, todoTaskId, includeHeaders, excludeResponse, confirm
  162
• list-todo-checklist-items

  Get the checklistItem resources associated to a todoTask from the checklistItems navigation property. 💡 TIP: Lists the steps (checklist items) of a To Do task. Each item has id, displayName, isChecked, checkedDateTime, and createdDateTime. Graph supports no OData query parameters on this endpoint, so do not pass select, filter, orderby, or top. Requires todoTaskListId from list-todo-task-lists and todoTaskId from list-todo-tasks.

  Parameters: top, skip, search, filter, count, orderby, select, expand, todoTaskListId, todoTaskId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  163
• create-todo-checklist-item

  Create a new checklistItem object. 💡 TIP: Adds a step (checklist item) to an existing To Do task. Body: { displayName: "..." }; optional isChecked (defaults to false). Returns the new item with its id. To add steps while creating a task, pass checklistItems in the create-todo-task body instead.

  Parameters: body, todoTaskListId, todoTaskId, includeHeaders, excludeResponse, confirm
  164
• update-todo-checklist-item

  Update the properties of a checklistItem object. 💡 TIP: Updates a step (checklist item) of a To Do task. Use this to check a step off (body: { isChecked: true }), uncheck it (isChecked: false), or rename it (displayName). Requires checklistItemId from list-todo-checklist-items.

  Parameters: body, todoTaskListId, todoTaskId, checklistItemId, includeHeaders, excludeResponse, confirm
  165
• delete-todo-checklist-item

  Delete a checklistItem object. 💡 TIP: Deletes a step (checklist item) from a To Do task. This cannot be undone. Requires checklistItemId from list-todo-checklist-items.

  Parameters: If-Match, todoTaskListId, todoTaskId, checklistItemId, includeHeaders, excludeResponse, confirm
  166
• list-todo-linked-resources

  Get information of one or more items in a partner application, based on which a specified task was created. The information is represented in a linkedResource object for each item. It includes an external ID for the item in the partner application, and if applicable, a deep link to that item in the application. 💡 TIP: Lists resources linked to a To Do task (emails, URLs, etc.). Each linked resource has displayName, webUrl, applicationName, and externalId.

  Parameters: top, skip, search, filter, count, orderby, select, expand, todoTaskListId, todoTaskId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  167
• create-todo-linked-resource

  Create a linkedResource object to associate a specified task with an item in a partner application. For example, you can associate a task with an email item in Outlook that spurred the task, and you can create a linkedResource object to track its association. You can also create a linkedResource object while creating a task. 💡 TIP: Links a resource to a To Do task. Body: { webUrl: 'https://...', applicationName: 'Mail', displayName: 'Related email', externalId: 'optional-id' }. Use to link tasks to emails, files, or web pages for context.

  Parameters: body, todoTaskListId, todoTaskId, includeHeaders, excludeResponse, confirm
  168
• delete-todo-linked-resource

  Delete a linkedResource object. 💡 TIP: Removes a linked resource from a To Do task.

  Parameters: If-Match, todoTaskListId, todoTaskId, linkedResourceId, includeHeaders, excludeResponse, confirm
  169
• create-planner-bucket

  Create a new plannerBucket object.

  Parameters: body, includeHeaders, excludeResponse, confirm
  170
• get-planner-bucket

  Retrieve the properties and relationships of a plannerBucket object. 💡 TIP: Response includes @odata.etag — required as If-Match for update-planner-bucket and delete-planner-bucket. Use includeHeaders=true.

  Parameters: select, expand, plannerBucketId, fetchAllPages, includeHeaders, excludeResponse
  171
• update-planner-bucket

  Update the properties of plannerbucket object. 💡 TIP: CRITICAL: Requires If-Match header with ETag from get-planner-bucket (use includeHeaders=true).

  Parameters: body, If-Match, plannerBucketId, includeHeaders, excludeResponse, confirm
  172
• delete-planner-bucket

  Delete plannerBucket. 💡 TIP: CRITICAL: Requires If-Match header with ETag from get-planner-bucket (use includeHeaders=true).

  Parameters: If-Match, plannerBucketId, includeHeaders, excludeResponse, confirm
  173
• get-planner-plan

  Retrieve the properties and relationships of a plannerplan object.

  Parameters: select, expand, plannerPlanId, fetchAllPages, includeHeaders, excludeResponse
  174
• list-plan-buckets

  Retrieve a list of plannerBucket objects contained by a plannerPlan object.

  Parameters: top, skip, search, filter, count, orderby, select, expand, plannerPlanId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  175
• list-plan-tasks

  Retrieve a list of plannerTask objects associated with a plannerPlan object. 💡 TIP: Priority is 0-10 (lower = higher priority); Planner's own UI presets are 1=Urgent, 3=Important, 5=Medium, 9=Low.

  Parameters: top, skip, search, filter, count, orderby, select, expand, plannerPlanId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  176
• create-planner-task

  Create a new plannerTask.

  Parameters: body, includeHeaders, excludeResponse, confirm
  177
• get-planner-task

  Retrieve the properties and relationships of plannerTask object. 💡 TIP: Response includes @odata.etag — save it, required as If-Match header for update-planner-task. Use includeHeaders=true to capture it.

  Parameters: select, expand, plannerTaskId, fetchAllPages, includeHeaders, excludeResponse
  178
• update-planner-task

  Update the properties of plannerTask object. 💡 TIP: CRITICAL: Requires If-Match header with the task's @odata.etag value, otherwise returns 412 Precondition Failed. Get the ETag from get-planner-task with includeHeaders=true. Priority is 0-10 (lower = higher priority); Planner's own UI presets are 1=Urgent, 3=Important, 5=Medium, 9=Low.

  Parameters: body, If-Match, plannerTaskId, includeHeaders, excludeResponse, confirm
  179
• get-planner-task-details

  Retrieve the properties and relationships of a plannerTaskDetails object. 💡 TIP: Response includes @odata.etag — required for update-planner-task-details. Use includeHeaders=true.

  Parameters: select, expand, plannerTaskId, fetchAllPages, includeHeaders, excludeResponse
  180
• update-planner-task-details

  Update the properties of plannerTaskDetails object. 💡 TIP: CRITICAL: Requires If-Match header with ETag from get-planner-task-details (use includeHeaders=true). Checklist items use GUID keys: {"checklist": {"<guid>": {"title": "...", "isChecked": false}}}.

  Parameters: body, If-Match, plannerTaskId, includeHeaders, excludeResponse, confirm
  181
• list-subscriptions

  Retrieve the properties and relationships of webhook subscriptions, based on the app ID, the user, and the user's role with a tenant. The content of the response depends on the context in which the app is calling; for details, see the scenarios in the Permissions section. 💡 TIP: Lists webhook subscriptions owned by the current app/user. Returns id, resource, changeType, notificationUrl, expirationDateTime, clientState. Use $filter=resource eq '/me/messages' to find subscriptions for a specific resource. No dedicated 'Subscription.*' scope exists — the caller must already have a read permission for the subscribed resource (e.g. Mail.Read for /me/messages), which is supplied by the tool that reads that resource.

  Parameters: top, skip, search, filter, count, orderby, select, expand, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  182
• create-subscription

  Subscribes a listener application to receive change notifications when the requested type of changes occur to the specified resource in Microsoft Graph. To identify the resources for which you can create subscriptions and the limitations on subscriptions, see Set up notifications for changes in resource data: Supported resources. Some resources support rich notifications, that is, notifications that include resource data. For more information about these resources, see Set up change notifications that include resource data: Supported resources. 💡 TIP: Creates a webhook subscription for change notifications. Required body: { changeType (comma-separated: 'created,updated,deleted'), notificationUrl (HTTPS, must validate with token echo), resource (e.g. '/me/mailFolders/inbox/messages', '/users/{id}/events', '/teams/{id}/channels/{id}/messages'), expirationDateTime (ISO 8601, max varies by resource type — 1 hour for calls, 24h for messages, 3 days for mail), clientState (opaque string re

  Parameters: body, includeHeaders, excludeResponse, confirm
  183
• get-subscription

  Retrieve the properties and relationships of a subscription. See the table in the Permissions section for the list of resources that support subscribing to change notifications. 💡 TIP: Gets a specific webhook subscription by id. Use list-subscriptions to find the id. Returns full subscription details including resource, changeType, notificationUrl, expirationDateTime, applicationId.

  Parameters: select, subscriptionId, fetchAllPages, includeHeaders, excludeResponse
  184
• update-subscription

  Renew a subscription by extending its expiry time. The table in the Permissions section lists the resources that support subscribing to change notifications. Subscriptions expire after a length of time that varies by resource type. In order to avoid missing change notifications, an app should renew its subscriptions well in advance of their expiry date. See subscription for maximum length of a subscription for each resource type. 💡 TIP: Renews a webhook subscription by extending its expiration. Body: { expirationDateTime (ISO 8601, new expiry) }. Call before the current expirationDateTime to avoid missing notifications. Max extension varies by resource type — check Microsoft Graph docs for subscription limits.

  Parameters: body, subscriptionId, includeHeaders, excludeResponse, confirm
  185
• delete-subscription

  Delete a subscription. For the list of resources that support subscribing to change notifications, see the table in the Permissions section. 💡 TIP: Deletes a webhook subscription. No further change notifications will be sent. Use this to clean up stale subscriptions or stop receiving notifications. Use list-subscriptions to find the id.

  Parameters: If-Match, subscriptionId, includeHeaders, excludeResponse, confirm
  186
• reauthorize-subscription

  Reauthorize a subscription when you receive a reauthorizationRequired challenge. 💡 TIP: Reauthorizes a subscription after receiving a 'reauthorizationRequired' lifecycle notification from Microsoft Graph. No body required. Must be called within the reauthorizationRequiredDateTime window (typically 48h) to avoid subscription expiry.

  Parameters: subscriptionId, includeHeaders, excludeResponse, confirm
  187
• get-my-profile

  [beta] Retrieve the properties and relationships of a profile object for a given user. The profile resource exposes various rich properties that are descriptive of the user as relationships, for example, anniversaries and education activities. To get one of these navigation properties, use the corresponding GET method on that property. See the methods exposed by profile. 💡 TIP: Retrieves the signed-in user's rich profile - a richer object than get-current-user, exposing relationships like skills, projects, languages, education and work positions. Use $expand to pull related collections (e.g. $expand=skills,projects).

  Parameters: select, expand, fetchAllPages, includeHeaders, excludeResponse
  188
• list-planner-task-messages

  [beta] Retrieve a list of plannerTaskChatMessage objects associated with a plannerTask. 💡 TIP: Lists messages in a Planner task's chat — the modern Planner 'task chat', distinct from the legacy conversationThreadId comments (which live in the M365 group conversation thread). Each message has id, content (HTML), createdBy, createdDateTime, mentions, reactions. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet).

  Parameters: top, skip, search, filter, count, orderby, select, expand, plannerTaskId, fetchAllPages, skiptoken, includeHeaders, excludeResponse
  189
• create-planner-task-message

  [beta] Create a new plannerTaskChatMessage on a plannerTask. 💡 TIP: Posts a message to a Planner task's chat (the modern 'task chat', not the legacy conversationThreadId comment). Microsoft is retiring the classic task comments experience and hiding it from the task (Planner 2026 update), so task chat is the current supported way to post per-task updates teammates will see, with @mentions. Body: { content: 'plain text or sanitized HTML', mentions?: [{ mentioned: 'user-id', position: 0, mentionType: 'user' }] } (mentions optional). No ETag/If-Match required. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet).

  Parameters: body, plannerTaskId, includeHeaders, excludeResponse, confirm
  190
• delete-planner-task-message

  [beta] Delete a plannerTaskChatMessage object. 💡 TIP: Deletes a message from a Planner task's chat. No request body; If-Match is optional if you want conditional deletion; returns 204. BETA Graph API: subject to change; delegated work/school accounts only — no application permissions, no personal Microsoft accounts, global cloud only (not GCC/DoD/21Vianet).

  Parameters: If-Match, plannerTaskId, plannerTaskChatMessageId, includeHeaders, excludeResponse, confirm
  191
• get-upload-url

  Mint a short-lived, single-use URL that this server serves for uploading a file as an attachment to a draft message or an event, so the bytes go straight from the caller to Microsoft Graph instead of passing as base64 through the agent context. target is the attachments collection of the item: /me/messages/{message-id}/attachments (a draft; create it first) or /me/events/{event-id}/attachments. PUT the raw file bytes to the returned uploadUrl with a Content-Length (e.g. curl -T file "<uploadUrl>"); the response confirms the attachment. Files under 3 MB are attached directly, larger ones (up to 150 MB) through a Graph upload session. Requires --enable-attachment-urls. Returns { uploadUrl, method, expiresAt, singleUse, maxBytes }.

  Parameters: target, name, contentType
  192
• parse-teams-url

  Converts any Teams meeting URL format (short /meet/, full /meetup-join/, or recap ?threadId=) into a standard joinWebUrl. Use this before list-online-meetings when the user provides a recap or short URL.

  Parameters: url
  193
• read-mail-text

  Triage view of up to 20 mail messages at once, as text with the bulk junk removed: invisible padding, image placeholders and quoted reply history (forwards keep theirs). Links are kept: Safe Links, Proofpoint and Google redirects are unwrapped to the real address and tracking parameters (utm_* and similar) dropped; only an address still over 300 characters (a tracking redirect) is shortened to ⟦link: domain⟧. Everything else (signatures, footers, whitespace) is left as the message has it; line endings become \n and ⟦ ⟧ in the body itself appear as [ ]. Use get-mail-message for the raw body or the quoted thread. Give messageIds (up to 20), or folderId with optional top and filter or search for the newest messages in a folder. Each message is cut to maxChars characters (default 3,000; marked truncated: true): pass a larger maxChars, up to 300,000, for the whole of a long message; a body over 300,000 characters is cleaned only that far. If the whole result would exceed the server limit (M

  Parameters: messageIds, folderId, top, filter, search, maxChars
  194
• download-bytes

  Download binary content from Microsoft Graph and return it as base64. Single tool for any binary read: drive file content, mail attachment, profile photo, Teams hosted content, meeting recording. Returns { contentType, encoding: "base64", contentLength, contentBytes }. For large drive/SharePoint file content, prefer get-download-url, which returns a pre-authenticated URL to stream bytes out-of-band instead of base64 through the agent context. With the server's blob output on, the bytes come back as a file resource instead (capped by the server's download limit); pass fileName to name it.

  Parameters: target, fileName
  195
• download-bytes-to-file

  Write authenticated Microsoft Graph byte content to a local file on the server, returning { path, contentType, bytesWritten } instead of base64. The only out-of-band way to save mail attachments and meeting recordings, whose bytes are exposed solely through authenticated endpoints. Also handles profile photos and Teams hosted content. Writes to an absolute outputPath and never overwrites an existing file. stdio mode, or HTTP with --http-local-file-tools. For OneDrive or SharePoint file content, get-download-url is preferred — it returns a pre-authenticated URL for fully out-of-band download without the server fetching the bytes.

  Parameters: target, outputPath
  196
• get-download-url

  Resolve a short-lived, pre-authenticated download URL for Microsoft Graph binary content that exposes one (drive/SharePoint file content). The returned URL streams the bytes with NO Authorization header, so the client can fetch it straight to disk (e.g. curl) without round-tripping base64 through the agent context. Prefer this over download-bytes for any file above a few KB or any bulk download. Returns { downloadUrl, name?, size?, contentType? }. Mail file attachments (/messages/{id}/attachments/{id}/$value), meeting recordings and other $value byte endpoints have no pre-authenticated URL from Graph itself, but call this tool for them anyway: a server running with --enable-attachment-urls mints its own single-use URL for them, and one without it answers with the reason and points at download-bytes.

  Parameters: target
  197

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

• Runtime verification covered one read-only tool call (list-accounts); other listed tools were not individually exercised.

• MCP.Directory public profile

  Name, description, publisher identifier, categories, transport, tool inventory, and install configuration.

• Linked publisher repository

  Repository URL linked from the public profile; npm package repository metadata matched this GitHub repository.

• npm registry metadata

  Published package version 0.170.0 checked before launch. Registry repository: git+https://github.com/Softeria/ms-365-mcp-server.git.

• maintainer repository documentation

  Softeria repository confirms this is a Graph API MCP for Microsoft 365/Office; stored 197 tools are profile/version-dependent and not recounted here.

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.