Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Microsoft 365 connector

OAuth 2.0ProductivityCommunicationCollaborationFiles & DocumentsCalendarAnalytics

Connect to Microsoft 365. Unified access to Outlook, Excel, Word, OneNote, OneDrive, SharePoint, and Teams through Microsoft Graph API.

Microsoft 365 connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Set up the connector

    Section titled “Set up the connector”

    Register your Microsoft 365 credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

    Dashboard setup steps

    Register your Scalekit environment with the Microsoft 365 connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:

    1. Create the Microsoft 365 connection in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Search for Microsoft 365 and click Create.

      • In the Configure Microsoft 365 Connection dialog, copy the Redirect URI. You will need this when registering your app in Azure.

    2. Register an application in Azure

      • Sign into portal.azure.com and go to Microsoft Entra ID → App registrations.

      • Click New registration. Enter a name for your app (for example, “Scalekit Microsoft 365 Connector”).

      • Under Supported account types, select Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts.

      • Under Redirect URI, select Web and paste the redirect URI you copied from the Scalekit dashboard. Click Register.

    3. Get your client credentials

      • From the app’s Overview page, copy the Application (client) ID.

      • Go to Certificates & secrets in the left sidebar, then click + New client secret.

      • Enter a description (for example, “Secret for Scalekit Agent Actions”), set an expiry period, and click Add. Copy the secret Value immediately — it is only shown once.

    4. Add credentials in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections and open the Microsoft 365 connection you created.

      • Enter your credentials:

        • Client ID — the Application (client) ID from the Azure app overview
        • Client Secret — the secret value from Certificates & secrets
        • Scopes — select the permissions your app needs (for example, Calendars.Read, Calendars.ReadWrite, Mail.Read, Mail.ReadWrite, Mail.Send, Contacts.Read, Contacts.ReadWrite, User.Read, offline_access). See Microsoft Graph permissions reference for the full list.

      • Click Save.

  4. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'microsoft365'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Microsoft 365:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'microsoft365_outlook_mailbox_settings_get',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Link onedrive resolve shared — Resolve a OneDrive or SharePoint sharing URL (e.g
  • List sharepoint, onedrive — List all SharePoint sites that the signed-in user is following
  • Delete onedrive, teams — Delete a file or folder from a specific drive by drive ID and item ID
  • Create onedrive, word, teams — Create a sharing link for a file or folder in a specific drive by drive ID
  • Drive onedrive copy item in — Copy a file or folder in a specific drive to a new location asynchronously
  • Get onedrive, teams — Retrieve metadata for a specific file or folder in a drive by drive ID and item ID
  • Shared/delegated calendar write — Create or update events on another user’s calendar (microsoft365_outlook_create_shared_calendar_event, microsoft365_outlook_update_shared_calendar_event)
  • Shared mailbox read — Get a single message from a shared mailbox by ID (microsoft365_outlook_get_shared_mailbox_message)
  • Colleague contacts — List or get contacts from another user’s contacts folder (microsoft365_outlook_list_shared_contacts, microsoft365_outlook_get_shared_contact)
  • Colleague tasks — List another user’s To Do task lists and tasks (microsoft365_outlook_list_shared_todo_lists, microsoft365_outlook_list_shared_todo_tasks)

Common workflows

Section titled “Common workflows”
Proxy API call 
const result = await actions.request({
  connectionName: 'microsoft365',
  identifier: 'user_123',
  path: '/v1.0/me/messages',
  method: 'GET',
});
console.log(result);
Execute a tool 
const result = await actions.executeTool({
  connector: 'microsoft365',
  identifier: 'user_123',
  toolName: 'microsoft365_create_calendar_event',
  toolInput: {},
});
console.log(result);

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

microsoft365_excel_add_table_column#Add a new column to an existing Excel table in OneDrive. Optionally specify the column name, its zero-based insertion index (null = append at end), and initial cell values as a 2D array (first row is the header). Returns the created column object.6 params

Add a new column to an existing Excel table in OneDrive. Optionally specify the column name, its zero-based insertion index (null = append at end), and initial cell values as a 2D array (first row is the header). Returns the created column object.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredName or ID of the table to add the column to. Example: 'Table1' or the GUID assigned by Excel.
indexintegeroptionalZero-based index position at which to insert the column. Null or omitted means append the column at the right end of the table. Example: 0 inserts as the first column.
namestringoptionalDisplay name for the new column header. If omitted, Excel auto-generates a name (e.g., 'Column1'). Example: 'Revenue'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
valuesarrayoptional2D array of initial cell values for the column, including the header row in the first element. Example: [["Header"],["row1val"],["row2val"]]. Each inner array is one row. If omitted, the column is created empty.
microsoft365_excel_add_table_row#Add a new row to an Excel table in a workbook stored in OneDrive. Provide a 2D array of values (one inner array per row to insert). Optionally specify an index to insert the row at a specific position; omit index to append to the end of the table.5 params

Add a new row to an Excel table in a workbook stored in OneDrive. Provide a 2D array of values (one inner array per row to insert). Optionally specify an index to insert the row at a specific position; omit index to append to the end of the table.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredTable name or numeric ID to add a row to. Example: 'Table1' or '1'.
valuesarrayrequired2D array of values to insert as a new row. Each inner array represents one row; each element is a cell value (string, number, boolean, or null). The number of elements in each inner array must match the table's column count. Example: [["Alice", 95, true]] inserts one row with three cells.
indexintegeroptionalZero-based index at which to insert the row. If null or omitted, the row is appended to the end of the table. Example: 0 inserts at the top of the table.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_clear_range#Clear the contents, formats, or both from a cell range in an Excel worksheet stored in OneDrive. Use apply_to to control what is cleared: 'All' clears both content and formatting, 'Contents' clears only values and formulas, 'Formats' clears only cell formatting.5 params

Clear the contents, formats, or both from a cell range in an Excel worksheet stored in OneDrive. Use apply_to to control what is cleared: 'All' clears both content and formatting, 'Contents' clears only values and formulas, 'Formats' clears only cell formatting.

NameTypeRequiredDescription
addressstringrequiredCell range address in Excel notation to clear. Examples: 'A1:C10' to clear a multi-cell range, 'B2' to clear a single cell.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID containing the range to clear. Example: 'Sheet1'.
apply_tostringoptionalWhat to clear from the range. Valid values: 'All' (clears both content and formatting, default), 'Contents' (clears only values and formulas), 'Formats' (clears only cell formatting).
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_close_session#Close an active workbook session for an Excel file in OneDrive. Releases server-side resources associated with the session. Pass the session ID returned by the createSession call as session_id.2 params

Close an active workbook session for an Excel file in OneDrive. Releases server-side resources associated with the session. Pass the session ID returned by the createSession call as session_id.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file whose session should be closed. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
session_idstringrequiredWorkbook session ID returned by the createSession call. Sent as the workbook-session-id request header to identify which session to close. Example: 'cluster=SN2&session=...'.
microsoft365_excel_create_chart#Create a new chart in an Excel worksheet stored in OneDrive. Specify the chart type (e.g., ColumnClustered, Line, Pie), the source data range address (e.g., 'A1:B10'), and optionally how series are arranged (Auto, Columns, Rows). Returns the created chart object including its ID.6 params

Create a new chart in an Excel worksheet stored in OneDrive. Specify the chart type (e.g., ColumnClustered, Line, Pie), the source data range address (e.g., 'A1:B10'), and optionally how series are arranged (Auto, Columns, Rows). Returns the created chart object including its ID.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
source_datastringrequiredCell range address providing the chart source data in Excel notation. Example: 'A1:B10' uses columns A and B, rows 1–10 as the chart data.
worksheet_idstringrequiredWorksheet name or GUID in which to create the chart. Example: 'Sheet1'.
chart_typestringoptionalType of chart to create. Valid values: ColumnClustered, ColumnStacked, ColumnStacked100, BarClustered, BarStacked, BarStacked100, Line, LineStacked, LineMarkers, Pie, Doughnut, Scatter, Area, Radar, XYScatter. Default is 'ColumnClustered'.
series_bystringoptionalHow data series are determined from the source range. Valid values: 'Auto' (Excel decides), 'Columns' (each column is a series), 'Rows' (each row is a series). Default is 'Auto'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_create_session#Create a workbook session for an Excel file in OneDrive. Returns a session ID that can be passed as the workbook-session-id header in subsequent Excel API calls to maintain state and improve performance. Requires the OneDrive item ID of the .xlsx file.2 params

Create a workbook session for an Excel file in OneDrive. Returns a session ID that can be passed as the workbook-session-id header in subsequent Excel API calls to maintain state and improve performance. Requires the OneDrive item ID of the .xlsx file.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file to open a session for. Obtain this from the OneDrive file listing or drive item API. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
persist_changesbooleanoptionalWhether to persist changes made during the session to the workbook. Set to true (default) to save changes; set to false for a read-only transient session that does not commit edits.
microsoft365_excel_create_table#Create a new Excel table from a cell range in a worksheet stored in OneDrive. Specify the address of the range (e.g., 'A1:D10') and whether the first row contains headers. Returns the created table object including its assigned ID and name.5 params

Create a new Excel table from a cell range in a worksheet stored in OneDrive. Specify the address of the range (e.g., 'A1:D10') and whether the first row contains headers. Returns the created table object including its assigned ID and name.

NameTypeRequiredDescription
addressstringrequiredCell range address for the new table in Excel notation. Example: 'A1:D10' creates a table spanning columns A–D and rows 1–10.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID in which to create the table. Example: 'Sheet1'.
has_headersbooleanoptionalWhether the first row of the range contains column headers. When true (default), the first row becomes the header row of the table. When false, Excel auto-generates header names.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_create_worksheet#Add a new worksheet to an Excel workbook stored in OneDrive. Specify the sheet name. Returns the newly created worksheet object including its ID, name, position, and visibility.3 params

Add a new worksheet to an Excel workbook stored in OneDrive. Specify the sheet name. Returns the newly created worksheet object including its ID, name, position, and visibility.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file to add the worksheet to. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
namestringrequiredName for the new worksheet tab. Must be unique within the workbook and cannot exceed 31 characters. Example: 'Q1 Sales'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_delete_chart#Delete a chart from an Excel worksheet stored in OneDrive. This permanently removes the chart from the worksheet. Requires the OneDrive item ID, worksheet name or GUID, and chart name or GUID.4 params

Delete a chart from an Excel worksheet stored in OneDrive. This permanently removes the chart from the worksheet. Requires the OneDrive item ID, worksheet name or GUID, and chart name or GUID.

NameTypeRequiredDescription
chart_idstringrequiredName or ID of the chart to delete. Example: 'Chart 1' or the GUID assigned by Excel.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID containing the chart to delete. Example: 'Sheet1'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_delete_table#Permanently delete a table from an Excel workbook stored in OneDrive. The underlying cell data is preserved but the table formatting and structure are removed. This action cannot be undone.3 params

Permanently delete a table from an Excel workbook stored in OneDrive. The underlying cell data is preserved but the table formatting and structure are removed. This action cannot be undone.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredTable name or numeric ID to delete. Example: 'Table1' or '1'. This permanently removes the table structure (cell data is kept).
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_delete_table_column#Delete a column from an Excel table by its zero-based index. This permanently removes the column and all its data from the table. Requires the OneDrive item ID, table name or ID, and the column index to delete.4 params

Delete a column from an Excel table by its zero-based index. This permanently removes the column and all its data from the table. Requires the OneDrive item ID, table name or ID, and the column index to delete.

NameTypeRequiredDescription
column_indexintegerrequiredZero-based index of the column to delete within the table. Example: 0 deletes the first column, 2 deletes the third column.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredName or ID of the table containing the column to delete. Example: 'Table1' or the GUID assigned by Excel.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_delete_table_row#Permanently delete a row from an Excel table in a workbook stored in OneDrive by its zero-based row index. All rows below the deleted row shift up by one. This action cannot be undone.4 params

Permanently delete a row from an Excel table in a workbook stored in OneDrive by its zero-based row index. All rows below the deleted row shift up by one. This action cannot be undone.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
row_indexintegerrequiredZero-based index of the row to delete within the table. The header row is not counted; index 0 refers to the first data row. Example: 0 deletes the first data row.
table_idstringrequiredTable name or numeric ID from which to delete the row. Example: 'Table1' or '1'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_delete_worksheet#Permanently delete a worksheet from an Excel workbook stored in OneDrive. This action cannot be undone. The workbook must have at least one remaining visible worksheet after deletion.3 params

Permanently delete a worksheet from an Excel workbook stored in OneDrive. This action cannot be undone. The workbook must have at least one remaining visible worksheet after deletion.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID to delete. Example: 'Sheet1' or '{00000000-0001-0000-0000-000000000000}'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_export_to_pdf#Export an Excel workbook stored in OneDrive to PDF format. Uses the Microsoft Graph OneDrive content endpoint with format=pdf query parameter. Returns the PDF binary content. The response may be a direct 200 with the PDF body or a 302 redirect to a download URL depending on file size.1 param

Export an Excel workbook stored in OneDrive to PDF format. Uses the Microsoft Graph OneDrive content endpoint with format=pdf query parameter. Returns the PDF binary content. The response may be a direct 200 with the PDF body or a 302 redirect to a download URL depending on file size.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file to export. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
microsoft365_excel_filter_table#Apply a filter to a column in an Excel table stored in OneDrive. Specify the filter criteria type (e.g., Values, Dynamic, Top, Custom) and the values or criteria to filter by. For 'Values' filtering, provide an array of exact string values to show. The filter is applied in place; no data is returned.6 params

Apply a filter to a column in an Excel table stored in OneDrive. Specify the filter criteria type (e.g., Values, Dynamic, Top, Custom) and the values or criteria to filter by. For 'Values' filtering, provide an array of exact string values to show. The filter is applied in place; no data is returned.

NameTypeRequiredDescription
column_idstringrequiredName or ID of the column within the table on which to apply the filter. Example: 'Status' or the column's integer ID.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredName or ID of the table to filter. Example: 'Table1' or the GUID assigned by Excel.
valuesarrayrequiredArray of string values to filter by when filter_on is 'Values'. Only rows whose cell in this column matches one of these values will be shown. Example: ["Active", "Pending"].
filter_onstringoptionalFilter type that determines how the criteria are applied. Valid values: 'Values' (match exact values), 'Custom' (custom expression), 'CellColor' (cell background color), 'FontColor' (cell font color), 'Dynamic' (dynamic filter such as Above Average), 'Top10' (top or bottom N items), 'Icon' (cell icon). Default is 'Values'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_get_range#Retrieve the values, formulas, format, and address of a cell range in an Excel worksheet stored in OneDrive. Specify the range using standard Excel notation (e.g., 'A1:C10' or 'B2'). Optionally accepts a workbook session ID.4 params

Retrieve the values, formulas, format, and address of a cell range in an Excel worksheet stored in OneDrive. Specify the range using standard Excel notation (e.g., 'A1:C10' or 'B2'). Optionally accepts a workbook session ID.

NameTypeRequiredDescription
addressstringrequiredCell range address in Excel notation to retrieve. Examples: 'A1' for a single cell, 'A1:C10' for a multi-cell range, 'Sheet1!A1:B5' to target a specific sheet within the address.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID containing the range. Example: 'Sheet1' or '{00000000-0001-0000-0000-000000000000}'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_get_table#Retrieve details of a specific table in an Excel workbook stored in OneDrive, including its name, style, column count, and header/total row settings. Accepts either a numeric table ID or the table name.3 params

Retrieve details of a specific table in an Excel workbook stored in OneDrive, including its name, style, column count, and header/total row settings. Accepts either a numeric table ID or the table name.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredTable name or numeric ID to retrieve. Example: 'Table1' or '1'. Both the table name and the workbook-assigned numeric ID are accepted.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_get_worksheet#Retrieve the properties of a specific worksheet in an Excel workbook stored in OneDrive. Use the worksheet name or its GUID as the worksheet_id. Optionally accepts a workbook session ID.3 params

Retrieve the properties of a specific worksheet in an Excel workbook stored in OneDrive. Use the worksheet name or its GUID as the worksheet_id. Optionally accepts a workbook session ID.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredThe worksheet name or GUID to retrieve. Use the sheet tab name (e.g., 'Sheet1') or the worksheet's unique GUID. Example: 'Sheet1' or '{00000000-0001-0000-0000-000000000000}'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_list_charts#List all charts in an Excel worksheet stored in OneDrive. Returns chart names, IDs, type, dimensions, and position. Supports OData $top for pagination.4 params

List all charts in an Excel worksheet stored in OneDrive. Returns chart names, IDs, type, dimensions, and position. Supports OData $top for pagination.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID containing the charts to list. Example: 'Sheet1'.
$topintegeroptionalMaximum number of charts to return (1–1000). Defaults to server-defined page size.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_list_comments#List all comments in an Excel workbook stored in OneDrive. Returns comment IDs, author information, content, cell location, and creation date. Supports OData $top for pagination.3 params

List all comments in an Excel workbook stored in OneDrive. Returns comment IDs, author information, content, cell location, and creation date. Supports OData $top for pagination.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
$topintegeroptionalMaximum number of comments to return (1–1000). Defaults to server-defined page size.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_list_named_items#List all named items (named ranges and constants) in an Excel workbook stored in OneDrive. Returns the name, type, value, and scope for each named item. Supports OData $top for pagination and $select for field projection.4 params

List all named items (named ranges and constants) in an Excel workbook stored in OneDrive. Returns the name, type, value, and scope for each named item. Supports OData $top for pagination and $select for field projection.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
$selectstringoptionalComma-separated list of properties to return for each named item. Example: 'name,type,value' to return only those fields.
$topintegeroptionalMaximum number of named items to return (1–1000). Defaults to server-defined page size.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_list_table_columns#List all columns in an Excel table in a workbook stored in OneDrive. Returns column objects including their name, index, and values. Supports OData pagination with $top and field selection with $select.5 params

List all columns in an Excel table in a workbook stored in OneDrive. Returns column objects including their name, index, and values. Supports OData pagination with $top and field selection with $select.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredTable name or numeric ID whose columns to list. Example: 'Table1' or '1'.
$selectstringoptionalComma-separated list of properties to return for each column. Example: 'id,name' to return only the column ID and name.
$topintegeroptionalMaximum number of columns to return. Useful for tables with many columns. Example: 10.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_list_table_rows#List rows in an Excel table stored in OneDrive. Returns an array of row objects, each containing a values array with the cell data. Supports OData pagination with $top and $skip.5 params

List rows in an Excel table stored in OneDrive. Returns an array of row objects, each containing a values array with the cell data. Supports OData pagination with $top and $skip.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredTable name or numeric ID whose rows to list. Example: 'Table1' or '1'.
$skipintegeroptionalNumber of rows to skip for pagination. Use in combination with $top to page through large tables. Example: 20 to skip the first 20 rows.
$topintegeroptionalMaximum number of rows to return. Defaults to server page size. Example: 50 to return up to 50 rows.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_list_tables#List all tables in an Excel workbook stored in OneDrive. Returns table names, IDs, style, and header/total row settings. Supports OData query options for pagination and field selection.4 params

List all tables in an Excel workbook stored in OneDrive. Returns table names, IDs, style, and header/total row settings. Supports OData query options for pagination and field selection.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
$selectstringoptionalComma-separated list of properties to return. Example: 'id,name,style' to return only those fields for each table.
$topintegeroptionalMaximum number of tables to return (1–1000). Defaults to server-defined page size.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_list_worksheets#List all worksheets in an Excel workbook stored in OneDrive. Supports OData query parameters for field selection and pagination. Optionally accepts a workbook session ID for session-based access.4 params

List all worksheets in an Excel workbook stored in OneDrive. Supports OData query parameters for field selection and pagination. Optionally accepts a workbook session ID for session-based access.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
$selectstringoptionalComma-separated list of properties to return for each worksheet. Example: 'id,name,position,visibility'.
$topintegeroptionalMaximum number of worksheets to return. Example: 10.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header for session-based access. Example: 'cluster=SN2&session=...'.
microsoft365_excel_merge_range#Merge a cell range in an Excel worksheet stored in OneDrive. Specify the range address (e.g., 'A1:C3') and optionally set 'across' to true to merge each row separately rather than merging the entire block into one cell.5 params

Merge a cell range in an Excel worksheet stored in OneDrive. Specify the range address (e.g., 'A1:C3') and optionally set 'across' to true to merge each row separately rather than merging the entire block into one cell.

NameTypeRequiredDescription
addressstringrequiredCell range address in Excel notation to merge. Examples: 'A1:C3' for a 3-column by 3-row block, 'B2:D4' for a rectangular range.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID containing the range to merge. Example: 'Sheet1'.
acrossbooleanoptionalWhen true, merges cells in each row of the range separately (row-by-row merge) instead of merging the entire block into a single cell. Defaults to false.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_protect_worksheet#Apply protection to a worksheet in an Excel workbook stored in OneDrive. You can optionally set a password and configure which actions are allowed while the sheet is protected (e.g., allow formatting cells but prevent deleting rows).15 params

Apply protection to a worksheet in an Excel workbook stored in OneDrive. You can optionally set a password and configure which actions are allowed while the sheet is protected (e.g., allow formatting cells but prevent deleting rows).

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID to protect. Example: 'Sheet1' or '{00000000-0001-0000-0000-000000000000}'.
allow_auto_filterbooleanoptionalWhether to allow AutoFilter operations while the worksheet is protected. Default is false.
allow_delete_columnsbooleanoptionalWhether to allow deleting columns while the worksheet is protected. Default is false.
allow_delete_rowsbooleanoptionalWhether to allow deleting rows while the worksheet is protected. Default is false.
allow_format_cellsbooleanoptionalWhether to allow formatting cells while the worksheet is protected. Default is false.
allow_format_columnsbooleanoptionalWhether to allow formatting columns while the worksheet is protected. Default is false.
allow_format_rowsbooleanoptionalWhether to allow formatting rows while the worksheet is protected. Default is false.
allow_insert_columnsbooleanoptionalWhether to allow inserting columns while the worksheet is protected. Default is false.
allow_insert_hyperlinksbooleanoptionalWhether to allow inserting hyperlinks while the worksheet is protected. Default is false.
allow_insert_rowsbooleanoptionalWhether to allow inserting rows while the worksheet is protected. Default is false.
allow_pivot_tablesbooleanoptionalWhether to allow PivotTable operations while the worksheet is protected. Default is false.
allow_sortbooleanoptionalWhether to allow sorting while the worksheet is protected. Default is false.
passwordstringoptionalOptional password to protect the worksheet. If set, users must enter this password to unprotect the sheet. Example: 'MySecretPass123'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_sort_range#Apply a sort to a cell range in an Excel worksheet stored in OneDrive. Specify one or more sort fields defining which column index to sort by and whether to sort ascending or descending. Optionally control case sensitivity and whether the range has a header row.7 params

Apply a sort to a cell range in an Excel worksheet stored in OneDrive. Specify one or more sort fields defining which column index to sort by and whether to sort ascending or descending. Optionally control case sensitivity and whether the range has a header row.

NameTypeRequiredDescription
addressstringrequiredCell range address in Excel notation to sort. Example: 'A1:D20' to sort a 4-column, 20-row range.
fieldsarrayrequiredArray of sort field objects defining the sort criteria. Each object must have a 'key' (zero-based column index within the range) and optionally 'ascending' (bool, default true) and 'sortOn' (e.g., 'Value', 'CellColor', 'FontColor', 'Icon'). Example: [{"key": 0, "ascending": true, "sortOn": "Value"}].
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID containing the range to sort. Example: 'Sheet1'.
has_headersbooleanoptionalWhether the range has a header row that should not be sorted. Default is true — the first row is treated as a header and excluded from sorting.
match_casebooleanoptionalWhether the sort is case-sensitive. Default is false (case-insensitive).
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_sort_table#Apply a sort to an Excel table stored in OneDrive. Provide one or more sort field objects specifying the zero-based column key within the table, sort direction (ascending/descending), and sort basis (Value, CellColor, FontColor, Icon). Optionally control case sensitivity. The sort is applied in place; no data is returned.5 params

Apply a sort to an Excel table stored in OneDrive. Provide one or more sort field objects specifying the zero-based column key within the table, sort direction (ascending/descending), and sort basis (Value, CellColor, FontColor, Icon). Optionally control case sensitivity. The sort is applied in place; no data is returned.

NameTypeRequiredDescription
fieldsarrayrequiredArray of sort field objects defining the sort criteria. Each object must include 'key' (zero-based column index within the table). Optionally include 'ascending' (bool, default true) and 'sortOn' (e.g., 'Value', 'CellColor', 'FontColor', 'Icon'). Example: [{"key": 0, "ascending": true, "sortOn": "Value"}].
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredName or ID of the table to sort. Example: 'Table1' or the GUID assigned by Excel.
match_casebooleanoptionalWhether the sort is case-sensitive. Default is false (case-insensitive). Example: set to true to distinguish 'Apple' from 'apple'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_unmerge_range#Unmerge a previously merged cell range in an Excel worksheet stored in OneDrive. Specify the range address to split any merged cells back into individual cells.4 params

Unmerge a previously merged cell range in an Excel worksheet stored in OneDrive. Specify the range address to split any merged cells back into individual cells.

NameTypeRequiredDescription
addressstringrequiredCell range address in Excel notation to unmerge. Example: 'A1:C3' to unmerge a block that was previously merged.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID containing the range to unmerge. Example: 'Sheet1'.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_update_chart#Update properties of an existing chart in an Excel worksheet stored in OneDrive. You can update the chart title text, dimensions (height, width in points), and position (left, top offsets in points). Only fields provided will be updated. Returns the updated chart object.9 params

Update properties of an existing chart in an Excel worksheet stored in OneDrive. You can update the chart title text, dimensions (height, width in points), and position (left, top offsets in points). Only fields provided will be updated. Returns the updated chart object.

NameTypeRequiredDescription
chart_idstringrequiredName or ID of the chart to update. Example: 'Chart 1' or the GUID assigned by Excel.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID containing the chart. Example: 'Sheet1'.
heightintegeroptionalHeight of the chart in points. Example: 300 sets the chart height to 300 points.
leftintegeroptionalLeft offset of the chart from the worksheet origin in points. Example: 0 positions the chart at the left edge.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
titlestringoptionalNew text for the chart title. Example: 'Monthly Revenue'. This wraps to the Graph API shape {"title":{"text":"..."}}.
topintegeroptionalTop offset of the chart from the worksheet origin in points. Example: 0 positions the chart at the top edge.
widthintegeroptionalWidth of the chart in points. Example: 400 sets the chart width to 400 points.
microsoft365_excel_update_range#Write values, formulas, or number formats to a cell range in an Excel worksheet stored in OneDrive. Provide a 2D array of values matching the dimensions of the target range. Optionally set formulas and number formats for cells.7 params

Write values, formulas, or number formats to a cell range in an Excel worksheet stored in OneDrive. Provide a 2D array of values matching the dimensions of the target range. Optionally set formulas and number formats for cells.

NameTypeRequiredDescription
addressstringrequiredCell range address in Excel notation to update. Must match the dimensions of the values array. Examples: 'A1:C2' for a 2-row by 3-column range, 'B5' for a single cell.
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
valuesarrayrequired2D array of cell values to write. Each inner array represents a row; each element is a cell value (string, number, boolean, or null). Example: [["Name", "Score"], ["Alice", 95], ["Bob", 87]].
worksheet_idstringrequiredWorksheet name or GUID containing the range to update. Example: 'Sheet1'.
formulasarrayoptional2D array of formula strings to write. Each inner array represents a row; each element is a cell formula string (e.g., '=SUM(A1:A5)') or null to leave blank. Must match the dimensions of the address range.
number_formatarrayoptional2D array of number format strings to apply. Each element is an Excel number format code (e.g., 'mm/dd/yyyy', '0.00', '@' for text). Must match the dimensions of the address range.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
microsoft365_excel_update_table#Update the properties of an existing Excel table in a workbook stored in OneDrive. Supports renaming the table, toggling header and total rows, and changing the table style.7 params

Update the properties of an existing Excel table in a workbook stored in OneDrive. Supports renaming the table, toggling header and total rows, and changing the table style.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
table_idstringrequiredTable name or numeric ID to update. Example: 'Table1' or '1'.
namestringoptionalNew name for the table. Must be unique within the workbook. Example: 'SalesData'. Only alphanumeric characters and underscores; must not start with a number.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
show_headersbooleanoptionalWhether to show the header row of the table. Set to true to display column headers, false to hide them.
show_totalsbooleanoptionalWhether to show the totals row at the bottom of the table. Set to true to display the totals row, false to hide it.
stylestringoptionalTable style name to apply. Valid values follow the Excel table style naming convention, e.g., 'TableStyleLight1', 'TableStyleMedium2', 'TableStyleDark3'. See Excel table styles for available options.
microsoft365_excel_update_worksheet#Update properties of an existing worksheet in an Excel workbook stored in OneDrive. You can rename the sheet, change its tab position, or change its visibility. At least one of name, position, or visibility must be provided.6 params

Update properties of an existing worksheet in an Excel workbook stored in OneDrive. You can rename the sheet, change its tab position, or change its visibility. At least one of name, position, or visibility must be provided.

NameTypeRequiredDescription
item_idstringrequiredOneDrive item ID of the Excel (.xlsx) file. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
worksheet_idstringrequiredWorksheet name or GUID to update. Example: 'Sheet1' or '{00000000-0001-0000-0000-000000000000}'.
namestringoptionalNew name for the worksheet tab. Must be unique within the workbook and no longer than 31 characters. Example: 'Q2 Sales'.
positionintegeroptionalZero-based index position of the worksheet among other sheets. Example: 0 makes it the first sheet.
session_idstringoptionalOptional workbook session ID from createSession. When provided, sent as the workbook-session-id header. Example: 'cluster=SN2&session=...'.
visibilitystringoptionalVisibility of the worksheet. Valid values: 'Visible' (shown), 'Hidden' (hidden but can be unhidden by user), 'VeryHidden' (hidden and cannot be unhidden from the UI).
microsoft365_onedrive_checkin_file#Check in a checked-out OneDrive file to make the version available to others. Optionally provide a comment describing the changes and specify the check-in type. Requires the file to be checked out first.3 params

Check in a checked-out OneDrive file to make the version available to others. Optionally provide a comment describing the changes and specify the check-in type. Requires the file to be checked out first.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file to check in. The file must currently be checked out. Obtain item IDs from list or get drive item operations.
check_in_asstringoptionalThe type of check-in to perform. 'published' makes the version visible to all users. 'unspecified' (default) lets the server decide based on document library configuration.
commentstringoptionalAn optional comment to associate with the checked-in version, describing the changes made. Maximum length varies by library configuration.
microsoft365_onedrive_checkout_file#Check out a OneDrive file to prevent others from editing it while you make changes. Once checked out, only you can modify the file until it is checked back in or the checkout is discarded.1 param

Check out a OneDrive file to prevent others from editing it while you make changes. Once checked out, only you can modify the file until it is checked back in or the checkout is discarded.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file to check out. The file must be in a document library that supports check out. Obtain item IDs from list or get drive item operations.
microsoft365_onedrive_copy_drive_item#Copy a OneDrive file or folder to a new location asynchronously. The operation returns HTTP 202 Accepted with a monitor URL; the actual copy completes in the background. Provide the destination folder ID and an optional new name.3 params

Copy a OneDrive file or folder to a new location asynchronously. The operation returns HTTP 202 Accepted with a monitor URL; the actual copy completes in the background. Provide the destination folder ID and an optional new name.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder to copy. Obtain item IDs from list or get drive item operations.
new_parent_idstringrequiredThe item ID of the destination folder for the copy. Use "root" to copy the item to the top level of OneDrive.
new_namestringoptionalOptional name for the copied item in the destination. If omitted, the copy retains the original name.
microsoft365_onedrive_copy_item_in_drive#Copy a file or folder in a specific drive to a new location asynchronously. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Returns HTTP 202 with a monitor URL; the copy completes in the background. To copy an item in the signed-in user's personal OneDrive, use microsoft365_onedrive_copy_drive_item instead.4 params

Copy a file or folder in a specific drive to a new location asynchronously. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Returns HTTP 202 with a monitor URL; the copy completes in the background. To copy an item in the signed-in user's personal OneDrive, use microsoft365_onedrive_copy_drive_item instead.

NameTypeRequiredDescription
drive_idstringrequiredThe unique ID of the drive containing the item to copy. Obtain drive IDs from microsoft365_onedrive_list_drives or microsoft365_sharepoint_list_drives.
item_idstringrequiredThe unique ID of the file or folder to copy. Obtain item IDs from list or get item operations.
new_parent_idstringrequiredThe item ID of the destination folder for the copy. Use "root" to copy to the top level of the drive.
new_namestringoptionalOptional name for the copied item in the destination. If omitted, the copy retains the original name.
microsoft365_onedrive_create_folder#Create a new folder in OneDrive under the specified parent folder. Use "root" as the parent_id to create a top-level folder. Supports conflict behavior control when a folder with the same name already exists.3 params

Create a new folder in OneDrive under the specified parent folder. Use "root" as the parent_id to create a top-level folder. Supports conflict behavior control when a folder with the same name already exists.

NameTypeRequiredDescription
namestringrequiredThe name of the folder to create. Must be a valid folder name without path separators.
parent_idstringrequiredThe ID of the parent folder under which to create the new folder. Use "root" to create a folder at the top level of OneDrive. Obtain folder IDs from list or get drive item operations.
conflict_behaviorstringoptionalBehavior when a folder with the same name already exists. "fail" returns an error, "replace" overwrites the existing item, "rename" saves the new folder with a different name. Default: rename.
microsoft365_onedrive_delete_drive_item#Permanently delete a file or folder from OneDrive by its item ID. This action cannot be undone — the item is moved to the recycle bin and eventually purged. Use with caution.1 param

Permanently delete a file or folder from OneDrive by its item ID. This action cannot be undone — the item is moved to the recycle bin and eventually purged. Use with caution.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder to delete. Obtain item IDs from list or get drive item operations. Deleting a folder also removes all its contents.
microsoft365_onedrive_delete_item_in_drive#Delete a file or folder from a specific drive by drive ID and item ID. The item is moved to the recycle bin. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Deleting a folder also removes all its contents. To delete an item from the signed-in user's personal OneDrive, use microsoft365_onedrive_delete_drive_item instead.2 params

Delete a file or folder from a specific drive by drive ID and item ID. The item is moved to the recycle bin. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Deleting a folder also removes all its contents. To delete an item from the signed-in user's personal OneDrive, use microsoft365_onedrive_delete_drive_item instead.

NameTypeRequiredDescription
drive_idstringrequiredThe unique ID of the drive containing the item to delete. Obtain drive IDs from microsoft365_onedrive_list_drives or microsoft365_sharepoint_list_drives.
item_idstringrequiredThe unique ID of the file or folder to delete. Obtain item IDs from list or get item operations. Deleting a folder also removes all its contents.
microsoft365_onedrive_delete_permission#Remove a specific permission (sharing link or user grant) from a OneDrive file or folder. Once deleted, users who had access only through this permission will lose access. This action cannot be undone.2 params

Remove a specific permission (sharing link or user grant) from a OneDrive file or folder. Once deleted, users who had access only through this permission will lose access. This action cannot be undone.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder from which to remove the permission. Obtain item IDs from list or get drive item operations.
permission_idstringrequiredThe unique ID of the permission to delete. Obtain permission IDs from list permissions operations.
microsoft365_onedrive_discard_checkout#Discard a pending checkout for a OneDrive file, releasing the lock without saving any changes. The file reverts to the state it was in before the checkout. Use this when you want to cancel edits and allow others to edit the file again.1 param

Discard a pending checkout for a OneDrive file, releasing the lock without saving any changes. The file reverts to the state it was in before the checkout. Use this when you want to cancel edits and allow others to edit the file again.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file whose checkout to discard. The file must currently be checked out by you. Obtain item IDs from list or get drive item operations.
microsoft365_onedrive_download_file#Download the binary content of a OneDrive file by its item ID. The response is the raw file bytes (not JSON). For text files this will be readable text; for binary files (images, Office documents) it will be binary data. Use the item ID from get or list operations.1 param

Download the binary content of a OneDrive file by its item ID. The response is the raw file bytes (not JSON). For text files this will be readable text; for binary files (images, Office documents) it will be binary data. Use the item ID from get or list operations.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file to download. Obtain item IDs from list drive items or search drive items operations.
microsoft365_onedrive_follow_drive_item#Follow a OneDrive file or folder so it appears in your list of followed items. Following an item allows you to track changes and receive notifications. Returns the updated drive item.1 param

Follow a OneDrive file or folder so it appears in your list of followed items. Following an item allows you to track changes and receive notifications. Returns the updated drive item.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder to follow. Obtain item IDs from list or get drive item operations.
microsoft365_onedrive_get_drive#Retrieve the properties of the signed-in user's default OneDrive drive, including storage quota, owner information, and drive type (personal, business, or SharePoint document library).0 params

Retrieve the properties of the signed-in user's default OneDrive drive, including storage quota, owner information, and drive type (personal, business, or SharePoint document library).

microsoft365_onedrive_get_drive_item#Retrieve the metadata for a specific OneDrive file or folder by its item ID. Returns properties including name, size, creation date, last modified date, MIME type, and download URL.1 param

Retrieve the metadata for a specific OneDrive file or folder by its item ID. Returns properties including name, size, creation date, last modified date, MIME type, and download URL.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder to retrieve. Obtain item IDs from list or search operations.
microsoft365_onedrive_get_item_in_drive#Retrieve metadata for a specific file or folder in a drive by drive ID and item ID. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Returns name, size, creation date, last modified date, MIME type, and download URL. To get an item from the signed-in user's personal OneDrive, use microsoft365_onedrive_get_drive_item instead.2 params

Retrieve metadata for a specific file or folder in a drive by drive ID and item ID. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Returns name, size, creation date, last modified date, MIME type, and download URL. To get an item from the signed-in user's personal OneDrive, use microsoft365_onedrive_get_drive_item instead.

NameTypeRequiredDescription
drive_idstringrequiredThe unique ID of the drive containing the item. Obtain drive IDs from microsoft365_onedrive_list_drives or microsoft365_sharepoint_list_drives.
item_idstringrequiredThe unique ID of the file or folder to retrieve. Obtain item IDs from list or search operations.
microsoft365_onedrive_get_thumbnails#Retrieve thumbnail images for a specific OneDrive file or folder. Returns a collection of thumbnail sets including small, medium, and large thumbnail URLs. Useful for displaying file previews.1 param

Retrieve thumbnail images for a specific OneDrive file or folder. Returns a collection of thumbnail sets including small, medium, and large thumbnail URLs. Useful for displaying file previews.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder whose thumbnails to retrieve. Obtain item IDs from list or get drive item operations.
microsoft365_onedrive_get_version_content#Download the binary content of a specific version of a OneDrive file. Returns the raw file bytes for the requested version. The response is a redirect (302) or direct download (200) depending on the client.2 params

Download the binary content of a specific version of a OneDrive file. Returns the raw file bytes for the requested version. The response is a redirect (302) or direct download (200) depending on the client.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file whose version content to download. Obtain item IDs from list or get drive item operations.
version_idstringrequiredThe unique ID of the version to download. Obtain version IDs from the list versions operation. Example: '1.0' or a GUID string.
microsoft365_onedrive_invite_users#Send sharing invitations for a OneDrive file or folder to one or more recipients by email address. Assigns the specified roles (read or write) and optionally sends an email notification with a message.6 params

Send sharing invitations for a OneDrive file or folder to one or more recipients by email address. Assigns the specified roles (read or write) and optionally sends an email notification with a message.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder to share. Obtain item IDs from list or get drive item operations.
recipient_emailsarrayrequiredArray of email addresses of users to invite. Each email will receive an invitation to access the shared item. Example: ["alice@example.com", "bob@example.com"].
rolesarrayrequiredArray of permission roles to grant to the invited users. Use "read" for view-only access and "write" for edit access. Example: ["read"].
messagestringoptionalOptional message to include in the invitation email sent to the recipients.
require_sign_inbooleanoptionalWhether the recipient must sign in to access the shared item. Set to false to allow access without signing in. Default: true.
send_invitationbooleanoptionalWhether to send an email invitation to the recipients. Set to false to grant access silently without sending an email. Default: true.
microsoft365_onedrive_list_activities#Retrieve the activity feed for a specific OneDrive file or folder. Returns a list of recent actions performed on the item, including who made changes, when, and what type of action was taken (create, edit, delete, share, etc.).3 params

Retrieve the activity feed for a specific OneDrive file or folder. Returns a list of recent actions performed on the item, including who made changes, when, and what type of action was taken (create, edit, delete, share, etc.).

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder whose activity feed to retrieve. Obtain item IDs from list or get drive item operations.
$filterstringoptionalOData filter expression to narrow activity results. Example: "times/recordedTime ge 2024-01-01T00:00:00Z" to filter by date.
$topintegeroptionalMaximum number of activity records to return per page. Accepts an integer between 1 and 1000. Default: 25.
microsoft365_onedrive_list_drive_items#List the children (files and folders) of a OneDrive folder by item ID. Use "root" as the item_id to list top-level drive contents. Supports OData filtering, sorting, pagination, and field selection.6 params

List the children (files and folders) of a OneDrive folder by item ID. Use "root" as the item_id to list top-level drive contents. Supports OData filtering, sorting, pagination, and field selection.

NameTypeRequiredDescription
item_idstringrequiredThe ID of the folder whose children to list. Use "root" to list top-level OneDrive contents. Obtain item IDs from other list or search operations.
$filterstringoptionalOData filter expression to narrow results. Example: "file ne null" returns only files; "folder ne null" returns only folders.
$orderbystringoptionalProperty to sort results by. Example: "name asc" or "lastModifiedDateTime desc".
$selectstringoptionalComma-separated list of properties to return. Example: "id,name,size,lastModifiedDateTime" reduces response payload.
$skipintegeroptionalNumber of items to skip for pagination. Use with $top to page through results.
$topintegeroptionalMaximum number of items to return per page (default: 25). Accepts values 1–999.
microsoft365_onedrive_list_drives#List all drives accessible to the signed-in user, including personal OneDrive, SharePoint document libraries, and shared drives. Supports OData $top for pagination and $select for field selection.2 params

List all drives accessible to the signed-in user, including personal OneDrive, SharePoint document libraries, and shared drives. Supports OData $top for pagination and $select for field selection.

NameTypeRequiredDescription
$selectstringoptionalComma-separated list of drive properties to return. Example: "id,name,driveType,quota" reduces response payload to only those fields.
$topintegeroptionalMaximum number of drives to return per page. Accepts values 1–999. Defaults to server-side limit if omitted.
microsoft365_onedrive_list_item_versions_in_drive#Retrieve the version history for a file in a specific drive by drive ID and item ID. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Returns version ID, last modified time, size, and the identity of the user who made each change. To list versions in the signed-in user's personal OneDrive, use microsoft365_onedrive_list_versions instead.3 params

Retrieve the version history for a file in a specific drive by drive ID and item ID. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Returns version ID, last modified time, size, and the identity of the user who made each change. To list versions in the signed-in user's personal OneDrive, use microsoft365_onedrive_list_versions instead.

NameTypeRequiredDescription
drive_idstringrequiredThe unique ID of the drive containing the file. Obtain drive IDs from microsoft365_onedrive_list_drives or microsoft365_sharepoint_list_drives.
item_idstringrequiredThe unique ID of the file whose version history to list. Obtain item IDs from list or get item operations.
topintegeroptionalMaximum number of version entries to return per page. Accepts values 1–1000. Default: 25.
microsoft365_onedrive_list_items_in_drive#List the children (files and folders) of a folder in a specific drive by drive ID. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Use "root" as item_id to list top-level contents of the drive. To list items in the signed-in user's personal OneDrive, use microsoft365_onedrive_list_drive_items instead.7 params

List the children (files and folders) of a folder in a specific drive by drive ID. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. Use "root" as item_id to list top-level contents of the drive. To list items in the signed-in user's personal OneDrive, use microsoft365_onedrive_list_drive_items instead.

NameTypeRequiredDescription
drive_idstringrequiredThe unique ID of the drive containing the folder. Obtain drive IDs from microsoft365_onedrive_list_drives or microsoft365_sharepoint_list_drives.
item_idstringrequiredThe ID of the folder whose children to list. Use "root" to list top-level contents of the drive.
$filterstringoptionalOData filter expression to narrow results. Example: "file ne null" returns only files; "folder ne null" returns only folders.
$orderbystringoptionalProperty to sort results by. Example: "name asc" or "lastModifiedDateTime desc".
$selectstringoptionalComma-separated list of properties to return. Example: "id,name,size,lastModifiedDateTime" reduces response payload.
$skipintegeroptionalNumber of items to skip for pagination. Use with $top to page through results.
$topintegeroptionalMaximum number of items to return per page (default: 25). Accepts values 1–999.
microsoft365_onedrive_list_permissions#Retrieve the list of permissions (sharing and access grants) for a specific OneDrive file or folder. Returns all permission objects including sharing links, individual user grants, and inherited permissions.2 params

Retrieve the list of permissions (sharing and access grants) for a specific OneDrive file or folder. Returns all permission objects including sharing links, individual user grants, and inherited permissions.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder whose permissions to list. Obtain item IDs from list or get drive item operations.
topintegeroptionalMaximum number of permission entries to return per page. Accepts an integer between 1 and 100. Default: 25.
microsoft365_onedrive_list_recent_items#List files recently viewed or modified by the signed-in user in OneDrive. Returns the most recently accessed items across all drives the user has access to.1 param

List files recently viewed or modified by the signed-in user in OneDrive. Returns the most recently accessed items across all drives the user has access to.

NameTypeRequiredDescription
$topintegeroptionalMaximum number of recent items to return. Accepts values 1–999.
microsoft365_onedrive_list_shared_items#List files and folders that have been shared with the signed-in user from other people's OneDrive accounts or SharePoint sites.1 param

List files and folders that have been shared with the signed-in user from other people's OneDrive accounts or SharePoint sites.

NameTypeRequiredDescription
$topintegeroptionalMaximum number of shared items to return. Accepts values 1–999.
microsoft365_onedrive_list_versions#Retrieve the version history for a specific OneDrive file by its item ID. Returns a list of version objects including version ID, last modified time, size, and the identity of the user who made each change.2 params

Retrieve the version history for a specific OneDrive file by its item ID. Returns a list of version objects including version ID, last modified time, size, and the identity of the user who made each change.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file whose version history to list. Obtain item IDs from list or get drive item operations.
topintegeroptionalMaximum number of version entries to return per page. Accepts an integer between 1 and 1000. Default: 25.
microsoft365_onedrive_move_drive_item#Move a OneDrive file or folder to a different parent folder by updating its parentReference. Optionally rename the item during the move. Provide the destination folder's item ID as new_parent_id.3 params

Move a OneDrive file or folder to a different parent folder by updating its parentReference. Optionally rename the item during the move. Provide the destination folder's item ID as new_parent_id.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder to move. Obtain item IDs from list or get drive item operations.
new_parent_idstringrequiredThe item ID of the destination folder. Use "root" to move the item to the top level of OneDrive. Obtain folder IDs from list or get drive item operations.
new_namestringoptionalOptional new name to assign to the item during the move. If omitted, the item keeps its current name.
microsoft365_onedrive_restore_drive_item#Restore a deleted OneDrive file or folder from the recycle bin back to its original location or an optionally specified destination. Provide new_parent_id and new_name to restore to a different location or with a different name.3 params

Restore a deleted OneDrive file or folder from the recycle bin back to its original location or an optionally specified destination. Provide new_parent_id and new_name to restore to a different location or with a different name.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the deleted OneDrive item to restore. Obtain deleted item IDs from recycle bin list operations.
new_namestringoptionalOptional new name to assign to the item when restoring. If omitted, the item is restored with its original name.
new_parent_idstringoptionalOptional item ID of the folder to restore the item into. If omitted, the item is restored to its original parent location.
microsoft365_onedrive_search_drive_items#Search the signed-in user's OneDrive for files and folders matching a query string. Searches across file names, content, and metadata. Supports OData $top for result count and $select for field selection.3 params

Search the signed-in user's OneDrive for files and folders matching a query string. Searches across file names, content, and metadata. Supports OData $top for result count and $select for field selection.

NameTypeRequiredDescription
querystringrequiredSearch query string to find files or folders by name or content. Example: "budget 2024" searches for items containing that text.
$selectstringoptionalComma-separated list of properties to return. Example: "id,name,size,webUrl" reduces response payload.
$topintegeroptionalMaximum number of results to return. Accepts values 1–999.
microsoft365_onedrive_search_items_in_drive#Search for files and folders within a specific drive by drive ID. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. To search the signed-in user's personal OneDrive, use microsoft365_onedrive_search_drive_items instead.4 params

Search for files and folders within a specific drive by drive ID. Works across any drive accessible to the signed-in user, including SharePoint document libraries and Teams drives. To search the signed-in user's personal OneDrive, use microsoft365_onedrive_search_drive_items instead.

NameTypeRequiredDescription
drive_idstringrequiredThe unique ID of the drive to search within. Obtain drive IDs from microsoft365_onedrive_list_drives or microsoft365_sharepoint_list_drives.
querystringrequiredSearch query string to find files or folders by name or content. Example: "budget 2024" searches for items containing that text.
$selectstringoptionalComma-separated list of properties to return. Example: "id,name,size,webUrl" reduces response payload.
$topintegeroptionalMaximum number of results to return. Accepts values 1–999.
microsoft365_onedrive_unfollow_drive_item#Stop following a OneDrive file or folder. The item will no longer appear in your list of followed items and you will stop receiving change notifications for it.1 param

Stop following a OneDrive file or folder. The item will no longer appear in your list of followed items and you will stop receiving change notifications for it.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder to unfollow. The item must currently be in your followed items list. Obtain item IDs from list or get drive item operations.
microsoft365_onedrive_update_drive_item#Update the metadata of a OneDrive file or folder by its item ID. Supports renaming (via name) and updating the description. At least one of name or description should be provided.3 params

Update the metadata of a OneDrive file or folder by its item ID. Supports renaming (via name) and updating the description. At least one of name or description should be provided.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder to update. Obtain item IDs from list or get drive item operations.
descriptionstringoptionalNew description for the file or folder. Provide a short text description to attach to the item. Optional — can be updated independently from name.
namestringoptionalNew name for the file or folder. Renaming a file preserves its extension unless explicitly changed. Optional — provide only when renaming.
microsoft365_onedrive_update_permission#Update the roles assigned to an existing permission on a OneDrive file or folder. Use this to change a user's access level from read to write or vice versa. Requires the item ID and the specific permission ID to update.3 params

Update the roles assigned to an existing permission on a OneDrive file or folder. Use this to change a user's access level from read to write or vice versa. Requires the item ID and the specific permission ID to update.

NameTypeRequiredDescription
item_idstringrequiredThe unique ID of the OneDrive file or folder whose permission to update. Obtain item IDs from list or get drive item operations.
permission_idstringrequiredThe unique ID of the permission to update. Obtain permission IDs from the list permissions operation on the same item.
rolesarrayrequiredNew array of permission roles to assign. Use "read" for view-only access and "write" for edit access. Example: ["write"].
microsoft365_onedrive_upload_large_file#Create a resumable upload session for uploading large files (greater than 4 MB) to OneDrive. Returns an upload URL that the caller uses to upload file bytes in separate PATCH requests. The file is placed under the specified parent folder with the given filename.3 params

Create a resumable upload session for uploading large files (greater than 4 MB) to OneDrive. Returns an upload URL that the caller uses to upload file bytes in separate PATCH requests. The file is placed under the specified parent folder with the given filename.

NameTypeRequiredDescription
filenamestringrequiredThe name of the file to create or replace in OneDrive, including extension. Example: "report.xlsx".
parent_idstringrequiredThe ID of the parent folder where the file will be uploaded. Use "root" to upload to the top-level OneDrive folder. Obtain folder IDs from list or get drive item operations.
conflict_behaviorstringoptionalBehavior when a file with the same name already exists. "fail" aborts the upload, "replace" overwrites the existing file, "rename" saves with a new name. Default: replace.
microsoft365_outlook_accept_event#Accept a calendar event invitation.5 params

Accept a calendar event invitation.

NameTypeRequiredDescription
event_idstringrequiredEvent ID.
commentstringoptionalResponse comment.
schema_versionstringoptionalSchema version
send_responsebooleanoptionalSend response.
tool_versionstringoptionalTool version
microsoft365_outlook_batch_move_messages#Move up to 20 Outlook messages to a destination folder in a single Microsoft Graph batch request. Builds a $batch envelope where each subrequest POSTs to /me/messages/{id}/move. Returns a 200 response with per-subrequest status codes inside the responses array.2 params

Move up to 20 Outlook messages to a destination folder in a single Microsoft Graph batch request. Builds a $batch envelope where each subrequest POSTs to /me/messages/{id}/move. Returns a 200 response with per-subrequest status codes inside the responses array.

NameTypeRequiredDescription
destination_folder_idstringrequiredThe ID or well-known name of the destination folder (e.g., 'inbox', 'deleteditems', 'drafts', or a specific folder ID like 'AAMkAGI2...').
message_idsarrayrequiredArray of message IDs to move (max 20). Each ID is an Outlook message ID string.
microsoft365_outlook_batch_update_messages#Update properties on up to 20 Outlook messages in a single Microsoft Graph batch request. Builds a $batch envelope where each subrequest PATCHes /me/messages/{id} with the provided updates object. Common use: mark messages as read by passing {"isRead": true}. Returns a 200 response with per-subrequest status codes inside the responses array.2 params

Update properties on up to 20 Outlook messages in a single Microsoft Graph batch request. Builds a $batch envelope where each subrequest PATCHes /me/messages/{id} with the provided updates object. Common use: mark messages as read by passing {"isRead": true}. Returns a 200 response with per-subrequest status codes inside the responses array.

NameTypeRequiredDescription
message_idsarrayrequiredArray of message IDs to update (max 20). Each ID is an Outlook message ID string.
updatesobjectrequiredFree-form object of message properties to update on all specified messages. Example: {"isRead": true} to mark as read, or {"isRead": false, "flag": {"flagStatus": "flagged"}} for multiple changes.
microsoft365_outlook_create_calendar_event#Create a new calendar event in the user's Outlook calendar. Supports attendees, recurrence, reminders, online meetings, multiple locations, and event properties.28 params

Create a new calendar event in the user's Outlook calendar. Supports attendees, recurrence, reminders, online meetings, multiple locations, and event properties.

NameTypeRequiredDescription
end_datetimestringrequiredNo description.
end_timezonestringrequiredNo description.
start_datetimestringrequiredNo description.
start_timezonestringrequiredNo description.
subjectstringrequiredNo description.
attendees_optionalstringoptionalArray of email addresses for optional attendees
attendees_requiredstringoptionalArray of email addresses for required attendees
attendees_resourcestringoptionalArray of email addresses for resources (meeting rooms, equipment)
body_contentstringoptionalNo description.
body_contentTypestringoptionalNo description.
hideAttendeesbooleanoptionalWhen true, each attendee only sees themselves
importancestringoptionalEvent importance level
isAllDaybooleanoptionalMark as all-day event
isOnlineMeetingbooleanoptionalCreate an online meeting (Teams/Skype)
isReminderOnbooleanoptionalEnable or disable reminder
locationstringoptionalNo description.
locationsstringoptionalJSON array of location objects with displayName, address, coordinates
onlineMeetingProviderstringoptionalOnline meeting provider
recurrence_days_of_weekstringoptionalDays of week for weekly recurrence (comma-separated)
recurrence_end_datestringoptionalEnd date for recurrence (YYYY-MM-DD), required if range_type is endDate
recurrence_intervalintegeroptionalHow often the event recurs (e.g., every 2 weeks = 2)
recurrence_occurrencesintegeroptionalNumber of occurrences, required if range_type is numbered
recurrence_range_typestringoptionalHow the recurrence ends
recurrence_start_datestringoptionalStart date for recurrence (YYYY-MM-DD)
recurrence_typestringoptionalRecurrence pattern type
reminderMinutesBeforeStartintegeroptionalMinutes before event start to show reminder
sensitivitystringoptionalEvent sensitivity/privacy level
showAsstringoptionalFree/busy status
microsoft365_outlook_create_calendar_group#Create a new calendar group in the signed-in user's mailbox. Calendar groups organize multiple calendars together in Outlook.1 param

Create a new calendar group in the signed-in user's mailbox. Calendar groups organize multiple calendars together in Outlook.

NameTypeRequiredDescription
namestringrequiredThe name of the new calendar group (e.g., 'Work Calendars'). Must be unique among calendar groups for the user.
microsoft365_outlook_create_calendar_permission#Grant a user access to a specific Outlook calendar by creating a calendar permission entry. Specify the user's email address and the role level (e.g., freeBusyRead, read, write, delegate).4 params

Grant a user access to a specific Outlook calendar by creating a calendar permission entry. Specify the user's email address and the role level (e.g., freeBusyRead, read, write, delegate).

NameTypeRequiredDescription
calendar_idstringrequiredThe unique identifier of the calendar to share. Use a specific calendar ID from the list calendars endpoint.
email_addressstringrequiredThe email address of the user to grant calendar access to. Example: colleague@example.com
rolestringrequiredThe permission role to grant. Valid values: freeBusyRead (see free/busy only), limitedRead (see title and location), read (see all event details), write (create/edit/delete events), delegateWithoutPrivateEventAccess (delegate, no private events), delegateWithPrivateEventAccess (delegate including private events), custom (custom role).
namestringoptionalDisplay name of the user to grant access to. Optional; the Graph API will resolve it from the email if omitted.
microsoft365_outlook_create_category#Create a new Outlook master category for the signed-in user. Categories have a display name and a color preset (none or preset0–preset24). Once created, categories can be applied to messages, events, and contacts.2 params

Create a new Outlook master category for the signed-in user. Categories have a display name and a color preset (none or preset0–preset24). Once created, categories can be applied to messages, events, and contacts.

NameTypeRequiredDescription
display_namestringrequiredThe display name of the new category. Must be unique among the user's categories.
colorstringoptionalThe color assigned to the category. Use 'none' for no color, or 'preset0' through 'preset24' for a specific color slot. Defaults to preset0.
microsoft365_outlook_create_contact#Create a new contact in the user's mailbox with name, email addresses, and phone numbers.7 params

Create a new contact in the user's mailbox with name, email addresses, and phone numbers.

NameTypeRequiredDescription
givenNamestringrequiredFirst name of the contact
surnamestringrequiredLast name of the contact
businessPhonesarrayoptionalArray of business phone numbers
companyNamestringoptionalCompany name
emailAddressesarrayoptionalArray of email address objects with 'address' and optional 'name' fields
jobTitlestringoptionalJob title
mobilePhonestringoptionalMobile phone number
microsoft365_outlook_create_contact_folder#Create a new contact folder in the signed-in user's mailbox. Optionally nest it under an existing parent folder by providing a parent folder ID.2 params

Create a new contact folder in the signed-in user's mailbox. Optionally nest it under an existing parent folder by providing a parent folder ID.

NameTypeRequiredDescription
display_namestringrequiredThe display name for the new contact folder (e.g., 'Work Contacts').
parent_folder_idstringoptionalOptional ID of the parent contact folder under which to create this folder. If omitted, the folder is created at the top level.
microsoft365_outlook_create_draft_message#Create a new email draft in the mailbox.9 params

Create a new email draft in the mailbox.

NameTypeRequiredDescription
bcc_recipientsstringoptionalBCC recipients.
bodystringoptionalEmail body content.
body_typestringoptionalBody content type.
cc_recipientsstringoptionalCC recipients.
importancestringoptionalImportance.
schema_versionstringoptionalSchema version
subjectstringoptionalEmail subject.
to_recipientsstringoptionalTo recipients.
tool_versionstringoptionalTool version
microsoft365_outlook_create_focused_inbox_override#Create a Focused Inbox override that classifies all messages from a specific sender into either the Focused or Other inbox. This overrides the automatic machine learning classification for that sender.3 params

Create a Focused Inbox override that classifies all messages from a specific sender into either the Focused or Other inbox. This overrides the automatic machine learning classification for that sender.

NameTypeRequiredDescription
classify_asstringrequiredHow to classify messages from this sender: 'focused' to route to Focused inbox, 'other' to route to Other inbox.
sender_emailstringrequiredThe email address of the sender to create an override for (e.g., 'newsletter@example.com').
sender_namestringoptionalOptional display name for the sender (e.g., 'Weekly Newsletter'). Used for display purposes only.
microsoft365_outlook_create_forward_draft#Create a forward draft for a specific message.5 params

Create a forward draft for a specific message.

NameTypeRequiredDescription
message_idstringrequiredMessage ID.
commentstringoptionalForward comment.
schema_versionstringoptionalSchema version
to_recipientsstringoptionalTo recipients.
tool_versionstringoptionalTool version
microsoft365_outlook_create_mail_folder#Create a new mail folder in the mailbox.4 params

Create a new mail folder in the mailbox.

NameTypeRequiredDescription
display_namestringrequiredFolder name.
is_hiddenbooleanoptionalHidden folder.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_create_message_rule#Create a new inbox message rule.8 params

Create a new inbox message rule.

NameTypeRequiredDescription
display_namestringrequiredRule name.
actionsobjectoptionalRule actions.
conditionsobjectoptionalRule conditions.
exceptionsobjectoptionalException conditions for the rule.
is_enabledbooleanoptionalEnable rule.
schema_versionstringoptionalSchema version
sequenceintegeroptionalRule sequence.
tool_versionstringoptionalTool version
microsoft365_outlook_create_reply_all_draft#Create a reply-all draft for a specific message.4 params

Create a reply-all draft for a specific message.

NameTypeRequiredDescription
message_idstringrequiredMessage ID.
commentstringoptionalReply comment.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_create_reply_draft#Create a reply draft for a specific message.4 params

Create a reply draft for a specific message.

NameTypeRequiredDescription
message_idstringrequiredMessage ID.
commentstringoptionalReply comment.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_create_upload_session#Create an upload session for attaching a large file to an Outlook message using Microsoft Graph. Returns an uploadUrl and expiration time. Use the uploadUrl to upload file content in chunks via PUT requests. Required for attachments larger than 3 MB.3 params

Create an upload session for attaching a large file to an Outlook message using Microsoft Graph. Returns an uploadUrl and expiration time. Use the uploadUrl to upload file content in chunks via PUT requests. Required for attachments larger than 3 MB.

NameTypeRequiredDescription
attachment_namestringrequiredThe filename of the attachment (e.g., 'report.pdf'). Must include the file extension.
attachment_sizeintegerrequiredThe total size of the attachment in bytes. Must be the exact file size before uploading.
message_idstringrequiredThe ID of the draft Outlook message to attach the file to.
microsoft365_outlook_decline_event#Decline a calendar event invitation.6 params

Decline a calendar event invitation.

NameTypeRequiredDescription
event_idstringrequiredEvent ID.
commentstringoptionalResponse comment.
proposed_new_timeobjectoptionalProposed new meeting time.
schema_versionstringoptionalSchema version
send_responsebooleanoptionalSend response.
tool_versionstringoptionalTool version
microsoft365_outlook_delete_calendar_event#Delete a calendar event by ID.1 param

Delete a calendar event by ID.

NameTypeRequiredDescription
event_idstringrequiredNo description.
microsoft365_outlook_delete_calendar_group#Permanently delete a calendar group from the signed-in user's mailbox. Note: you cannot delete the default calendar group. All calendars within the group will also be deleted.1 param

Permanently delete a calendar group from the signed-in user's mailbox. Note: you cannot delete the default calendar group. All calendars within the group will also be deleted.

NameTypeRequiredDescription
group_idstringrequiredThe unique ID of the calendar group to delete (e.g., 'AAMkAGI2...'). Obtain from List Calendar Groups. Cannot be the default calendar group.
microsoft365_outlook_delete_calendar_permission#Revoke a user's access to a specific Outlook calendar by deleting the calendar permission entry. This action is permanent and immediately removes the user's access.2 params

Revoke a user's access to a specific Outlook calendar by deleting the calendar permission entry. This action is permanent and immediately removes the user's access.

NameTypeRequiredDescription
calendar_idstringrequiredThe unique identifier of the calendar from which to remove the permission.
permission_idstringrequiredThe unique identifier of the calendar permission entry to delete. Retrieve from the list calendar permissions endpoint.
microsoft365_outlook_delete_category#Delete an Outlook master category for the signed-in user. This permanently removes the category definition. Any messages or items tagged with this category will retain the tag label but the category color will no longer appear.1 param

Delete an Outlook master category for the signed-in user. This permanently removes the category definition. Any messages or items tagged with this category will retain the tag label but the category color will no longer appear.

NameTypeRequiredDescription
category_idstringrequiredThe unique ID of the Outlook category to delete. Retrieve it from the list_categories tool.
microsoft365_outlook_delete_contact#Permanently delete a contact.3 params

Permanently delete a contact.

NameTypeRequiredDescription
contact_idstringrequiredContact ID.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_delete_contact_folder#Permanently delete a contact folder and all its contents from the signed-in user's mailbox. This action cannot be undone.1 param

Permanently delete a contact folder and all its contents from the signed-in user's mailbox. This action cannot be undone.

NameTypeRequiredDescription
folder_idstringrequiredThe unique ID of the contact folder to delete (e.g., 'AAMkAGI2...'). Obtain from List Contact Folders. Warning: deletes all contacts within the folder.
microsoft365_outlook_delete_focused_inbox_override#Delete a Focused Inbox override rule for the signed-in user. Once deleted, messages from that sender will revert to automatic machine learning classification.1 param

Delete a Focused Inbox override rule for the signed-in user. Once deleted, messages from that sender will revert to automatic machine learning classification.

NameTypeRequiredDescription
override_idstringrequiredThe unique ID of the Focused Inbox override rule to delete (e.g., 'AAMkAGI2...'). Obtain this from the List Focused Inbox Overrides tool.
microsoft365_outlook_delete_mail_folder#Permanently delete a mail folder and its contents.3 params

Permanently delete a mail folder and its contents.

NameTypeRequiredDescription
folder_idstringrequiredFolder ID.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_delete_message#Permanently delete an email message.3 params

Permanently delete an email message.

NameTypeRequiredDescription
message_idstringrequiredMessage ID.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_delete_message_rule#Delete an inbox message rule.3 params

Delete an inbox message rule.

NameTypeRequiredDescription
rule_idstringrequiredRule ID.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_find_meeting_times#Find available meeting time slots for a set of attendees using Microsoft Graph's findMeetingTimes API. Returns a list of suggested meeting times when all required attendees are available within the given time window.7 params

Find available meeting time slots for a set of attendees using Microsoft Graph's findMeetingTimes API. Returns a list of suggested meeting times when all required attendees are available within the given time window.

NameTypeRequiredDescription
attendee_emailsarrayrequiredArray of attendee email addresses to check availability for. Example: ["alice@example.com", "bob@example.com"]
end_date_timestringrequiredEnd of the time window to search for meeting times, in ISO 8601 format (e.g., 2025-01-15T18:00:00). The API will not suggest slots after this time.
meeting_durationstringrequiredDuration of the desired meeting in ISO 8601 duration format (e.g., PT30M for 30 minutes, PT1H for 1 hour, PT1H30M for 1.5 hours).
start_date_timestringrequiredStart of the time window to search for meeting times, in ISO 8601 format (e.g., 2025-01-15T08:00:00). The API will look for available slots at or after this time.
is_organizer_optionalbooleanoptionalWhether the meeting organizer's presence is optional. When true, the organizer's calendar is not checked for availability. Defaults to false.
max_candidatesintegeroptionalMaximum number of meeting time suggestions to return. Defaults to 20. Acceptable range: 1-40.
time_zonestringoptionalIANA time zone identifier for interpreting start_date_time and end_date_time (e.g., "UTC", "America/New_York", "Europe/London"). Defaults to UTC.
microsoft365_outlook_forward_event#Forward a calendar event to other people.5 params

Forward a calendar event to other people.

NameTypeRequiredDescription
commentstringrequiredForward comment.
event_idstringrequiredEvent ID.
to_recipientsstringrequiredTo recipients.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_get_attachment#Download a specific attachment from an Outlook email message by attachment ID. Returns the full attachment including base64-encoded file content in the contentBytes field. Use List Attachments to get the attachment ID first.2 params

Download a specific attachment from an Outlook email message by attachment ID. Returns the full attachment including base64-encoded file content in the contentBytes field. Use List Attachments to get the attachment ID first.

NameTypeRequiredDescription
attachment_idstringrequiredThe ID of the attachment to download.
message_idstringrequiredThe ID of the message containing the attachment.
microsoft365_outlook_get_calendar_event#Retrieve an existing calendar event by ID from the user's Outlook calendar.1 param

Retrieve an existing calendar event by ID from the user's Outlook calendar.

NameTypeRequiredDescription
event_idstringrequiredNo description.
microsoft365_outlook_get_calendar_view#Retrieve a collection of calendar events within a specific time range from the user's primary Outlook calendar. Returns all occurrences, exceptions, and single instances of events whose start/end times fall within the specified window.6 params

Retrieve a collection of calendar events within a specific time range from the user's primary Outlook calendar. Returns all occurrences, exceptions, and single instances of events whose start/end times fall within the specified window.

NameTypeRequiredDescription
endDateTimestringrequiredEnd of the time range in ISO 8601 format (e.g., 2025-01-31T23:59:59). The calendar view returns events that end or overlap with this time.
startDateTimestringrequiredStart of the time range in ISO 8601 format (e.g., 2025-01-01T00:00:00). The calendar view returns events that start or overlap with this time.
$filterstringoptionalOData filter expression to further narrow results (e.g., "subject eq 'Team Sync'").
$orderbystringoptionalOData orderby expression to sort results (e.g., "start/dateTime asc").
$selectstringoptionalComma-separated list of properties to include in the response (e.g., "subject,start,end,location"). Reduces payload size.
$topintegeroptionalMaximum number of events to return (1-1000). Defaults to 10 if omitted.
microsoft365_outlook_get_contact#Retrieve a specific contact by ID.5 params

Retrieve a specific contact by ID.

NameTypeRequiredDescription
contact_idstringrequiredContact ID.
expandstringoptionalExpand relationships.
schema_versionstringoptionalSchema version
selectstringoptionalSelect properties.
tool_versionstringoptionalTool version
microsoft365_outlook_get_contact_photo#Retrieve the profile photo of a specific contact in the signed-in user's mailbox. Returns binary image data (JPEG). A 404 response indicates no photo is set for this contact.1 param

Retrieve the profile photo of a specific contact in the signed-in user's mailbox. Returns binary image data (JPEG). A 404 response indicates no photo is set for this contact.

NameTypeRequiredDescription
contact_idstringrequiredThe unique ID of the contact whose photo to retrieve (e.g., 'AAMkAGI2...'). Obtain from List Contacts or Get Contact.
microsoft365_outlook_get_free_busy_schedule#Retrieve the free/busy availability schedule for one or more users, rooms, or resources within a specific time window. Returns availability view, schedule items, and working hours for each requested address.5 params

Retrieve the free/busy availability schedule for one or more users, rooms, or resources within a specific time window. Returns availability view, schedule items, and working hours for each requested address.

NameTypeRequiredDescription
end_date_timestringrequiredEnd of the time window to retrieve schedule availability, in ISO 8601 format (e.g., 2025-01-15T18:00:00).
schedulesarrayrequiredArray of SMTP email addresses of users, distribution lists, or resources to get free/busy information for. Example: ["alice@example.com", "room@example.com"]
start_date_timestringrequiredStart of the time window to retrieve schedule availability, in ISO 8601 format (e.g., 2025-01-15T08:00:00).
availability_view_intervalintegeroptionalDuration in minutes of each time slot in the availability view string. Valid values: 5, 6, 10, 15, 20, 30, 60 (default), 120, 240, 480, or 1440.
time_zonestringoptionalIANA time zone identifier for interpreting start and end times (e.g., "UTC", "America/New_York", "Europe/London"). Defaults to UTC.
microsoft365_outlook_get_mail_tips#Get mail tips for a list of recipients before sending an email.4 params

Get mail tips for a list of recipients before sending an email.

NameTypeRequiredDescription
email_addressesarrayrequiredRecipient email addresses.
mail_tips_optionsstringrequiredMail tip types.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_get_message#Retrieve a specific email message by ID from the user's Outlook mailbox, including full body content, sender, recipients, attachments info, and metadata.1 param

Retrieve a specific email message by ID from the user's Outlook mailbox, including full body content, sender, recipients, attachments info, and metadata.

NameTypeRequiredDescription
message_idstringrequiredThe ID of the message to retrieve.
microsoft365_outlook_get_user_presence#Get the presence status of a specific user.3 params

Get the presence status of a specific user.

NameTypeRequiredDescription
user_idstringrequiredUser ID or email.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_list_attachments#List all attachments on a specific Outlook email message. Returns attachment metadata including ID, name, size, and content type. Use the attachment ID with Get Attachment to download the file content.1 param

List all attachments on a specific Outlook email message. Returns attachment metadata including ID, name, size, and content type. Use the attachment ID with Get Attachment to download the file content.

NameTypeRequiredDescription
message_idstringrequiredThe ID of the message to list attachments for.
microsoft365_outlook_list_calendar_events#List calendar events from the user's Outlook calendar with filtering, sorting, pagination, and field selection.5 params

List calendar events from the user's Outlook calendar with filtering, sorting, pagination, and field selection.

NameTypeRequiredDescription
filterstringoptionalOData filter expression to filter events (e.g., startsWith(subject,'All'))
orderbystringoptionalOData orderby expression to sort events (e.g., start/dateTime desc)
selectstringoptionalComma-separated list of properties to include in the response
skipnumberoptionalNumber of events to skip for pagination
topnumberoptionalMaximum number of events to return
microsoft365_outlook_list_calendar_groups#List all calendar groups in the signed-in user's mailbox. Calendar groups are containers that organize multiple calendars together in Outlook.2 params

List all calendar groups in the signed-in user's mailbox. Calendar groups are containers that organize multiple calendars together in Outlook.

NameTypeRequiredDescription
$selectstringoptionalComma-separated list of properties to return (e.g., 'name,classId'). Reduces response size.
$topintegeroptionalMaximum number of calendar groups to return (1–200, default: 10).
microsoft365_outlook_list_calendar_permissions#List all sharing permissions for a specific Outlook calendar. Returns the set of users and their assigned roles (e.g., freeBusyRead, read, write, delegate) for the given calendar.2 params

List all sharing permissions for a specific Outlook calendar. Returns the set of users and their assigned roles (e.g., freeBusyRead, read, write, delegate) for the given calendar.

NameTypeRequiredDescription
calendar_idstringrequiredThe unique identifier of the calendar whose permissions to list. Use 'primary' for the default calendar or a specific calendar ID from the list calendars endpoint.
$topintegeroptionalMaximum number of permission entries to return (1-1000). Defaults to all entries if omitted.
microsoft365_outlook_list_calendars#Retrieve all calendars in the user mailbox.4 params

Retrieve all calendars in the user mailbox.

NameTypeRequiredDescription
schema_versionstringoptionalSchema version
skipintegeroptionalSkip count.
tool_versionstringoptionalTool version
topintegeroptionalPage size.
microsoft365_outlook_list_categories#List all Outlook master categories defined for the signed-in user. Categories can be applied to messages, events, and contacts for color-coded organization.2 params

List all Outlook master categories defined for the signed-in user. Categories can be applied to messages, events, and contacts for color-coded organization.

NameTypeRequiredDescription
$selectstringoptionalComma-separated list of category properties to return (e.g., 'displayName,color').
$topintegeroptionalMaximum number of categories to return (1–200).
microsoft365_outlook_list_contact_folders#List all contact folders in the signed-in user's mailbox. Supports OData query parameters for filtering, field selection, and pagination.3 params

List all contact folders in the signed-in user's mailbox. Supports OData query parameters for filtering, field selection, and pagination.

NameTypeRequiredDescription
$filterstringoptionalOData filter expression to narrow results (e.g., "displayName eq 'Favorites'").
$selectstringoptionalComma-separated list of properties to return (e.g., 'displayName,parentFolderId'). Reduces response size.
$topintegeroptionalMaximum number of contact folders to return (1–200, default: 10).
microsoft365_outlook_list_contacts#List all contacts in the user's mailbox with support for filtering, pagination, and field selection.5 params

List all contacts in the user's mailbox with support for filtering, pagination, and field selection.

NameTypeRequiredDescription
$filterstringoptionalFilter expression to narrow results (e.g., "emailAddresses/any(a:a/address eq 'user@example.com')")
$orderbystringoptionalProperty to sort by (e.g., "displayName")
$selectstringoptionalComma-separated list of properties to return (e.g., "displayName,emailAddresses,phoneNumbers")
$skipintegeroptionalNumber of contacts to skip for pagination
$topintegeroptionalNumber of contacts to return (default: 10)
microsoft365_outlook_list_event_instances#List all instances (occurrences) of a recurring calendar event within a specified date-time range. Requires the master recurring event ID and a start/end window in ISO 8601 format.5 params

List all instances (occurrences) of a recurring calendar event within a specified date-time range. Requires the master recurring event ID and a start/end window in ISO 8601 format.

NameTypeRequiredDescription
end_date_timestringrequiredEnd of the time window to query for instances, in ISO 8601 format (e.g., '2024-12-31T23:59:59Z'). Required by Microsoft Graph.
event_idstringrequiredThe unique ID of the master recurring event whose instances to list (e.g., 'AAMkAGI2...'). This must be the series master event ID, not an individual occurrence.
start_date_timestringrequiredStart of the time window to query for instances, in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required by Microsoft Graph.
$selectstringoptionalComma-separated list of event properties to return (e.g., 'subject,start,end'). Reduces response size.
$topintegeroptionalMaximum number of event instances to return (1–200, default: 10).
microsoft365_outlook_list_focused_inbox_overrides#List all Focused Inbox overrides for the signed-in user. Overrides define how messages from specific senders are classified — either into the Focused inbox or the Other inbox — overriding the automatic machine learning classification.2 params

List all Focused Inbox overrides for the signed-in user. Overrides define how messages from specific senders are classified — either into the Focused inbox or the Other inbox — overriding the automatic machine learning classification.

NameTypeRequiredDescription
$selectstringoptionalComma-separated list of properties to return (e.g., 'classifyAs,senderEmailAddress').
$topintegeroptionalMaximum number of overrides to return per page.
microsoft365_outlook_list_folder_delta#Get incremental changes (delta sync) for mail folders in the user's mailbox using Microsoft Graph delta query. Returns new, updated, and deleted folders since the last sync. The response includes @odata.nextLink for pagination or @odata.deltaLink for the next delta call.3 params

Get incremental changes (delta sync) for mail folders in the user's mailbox using Microsoft Graph delta query. Returns new, updated, and deleted folders since the last sync. The response includes @odata.nextLink for pagination or @odata.deltaLink for the next delta call.

NameTypeRequiredDescription
$deltatokenstringoptionalDelta token from a previous @odata.deltaLink response to retrieve only folder changes since the last sync. Omit on first call to get a full initial sync.
$selectstringoptionalComma-separated list of folder properties to return (e.g., 'displayName,parentFolderId,totalItemCount,unreadItemCount').
$topintegeroptionalMaximum number of folders to return per page (1–250).
microsoft365_outlook_list_mail_folders#List all mail folders in the user mailbox.5 params

List all mail folders in the user mailbox.

NameTypeRequiredDescription
include_hiddenbooleanoptionalInclude hidden folders.
schema_versionstringoptionalSchema version
skipintegeroptionalSkip count.
tool_versionstringoptionalTool version
topintegeroptionalPage size.
microsoft365_outlook_list_message_delta#Get incremental changes (delta sync) for messages in a specific mail folder using Microsoft Graph delta query. Returns new, updated, and deleted messages since the last sync. The response includes @odata.nextLink for pagination or @odata.deltaLink for the next delta call. Pass $deltatoken from a previous deltaLink to get only changes since then.5 params

Get incremental changes (delta sync) for messages in a specific mail folder using Microsoft Graph delta query. Returns new, updated, and deleted messages since the last sync. The response includes @odata.nextLink for pagination or @odata.deltaLink for the next delta call. Pass $deltatoken from a previous deltaLink to get only changes since then.

NameTypeRequiredDescription
folder_idstringrequiredThe mail folder ID or well-known name to sync (e.g., 'inbox', 'sentitems', 'drafts', or a specific folder ID).
$deltatokenstringoptionalDelta token from a previous @odata.deltaLink response to retrieve only changes since the last sync. Omit on first call to get a full initial sync.
$selectstringoptionalComma-separated list of properties to return (e.g., 'subject,from,receivedDateTime,isRead'). Reduces response size.
$skiptokenstringoptionalSkip token from a previous @odata.nextLink response to continue paginating through a large delta result set.
$topintegeroptionalMaximum number of messages to return per page (1–1000).
microsoft365_outlook_list_message_rules#List all inbox message rules for the user.2 params

List all inbox message rules for the user.

NameTypeRequiredDescription
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_list_messages#List all messages in the user's mailbox with support for filtering, pagination, and field selection. Returns 10 messages by default.5 params

List all messages in the user's mailbox with support for filtering, pagination, and field selection. Returns 10 messages by default.

NameTypeRequiredDescription
$filterstringoptionalFilter expression to narrow results (e.g., "from/emailAddress/address eq 'user@example.com'")
$orderbystringoptionalProperty to sort by (e.g., "receivedDateTime desc")
$selectstringoptionalComma-separated list of properties to return (e.g., "subject,from,receivedDateTime")
$skipintegeroptionalNumber of messages to skip for pagination
$topintegeroptionalNumber of messages to return (1-1000, default: 10)
microsoft365_outlook_list_shared_calendar_events#Retrieve calendar events from another user shared calendar.6 params

Retrieve calendar events from another user shared calendar.

NameTypeRequiredDescription
end_date_timestringrequiredEnd date/time.
start_date_timestringrequiredStart date/time.
user_idstringrequiredUser ID or email.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
topintegeroptionalPage size.
microsoft365_outlook_list_shared_mailbox_messages#List messages in a specific folder of a shared mailbox. Supports filtering, ordering, pagination, and field selection. Requires Mail.Read or Mail.ReadWrite permissions on the shared mailbox.7 params

List messages in a specific folder of a shared mailbox. Supports filtering, ordering, pagination, and field selection. Requires Mail.Read or Mail.ReadWrite permissions on the shared mailbox.

NameTypeRequiredDescription
folder_idstringrequiredThe ID or well-known name of the mail folder to list messages from. Well-known names include: inbox, sentitems, drafts, deleteditems, junkemail, outbox, archive.
shared_mailbox_idstringrequiredThe email address or user ID of the shared mailbox to read messages from (e.g., support@company.com or a user object ID).
$filterstringoptionalOData filter expression to narrow results (e.g., "isRead eq false" or "from/emailAddress/address eq 'sender@example.com'").
$orderbystringoptionalOData orderby expression to sort messages (e.g., "receivedDateTime desc").
$selectstringoptionalComma-separated list of message properties to return (e.g., "subject,from,receivedDateTime,isRead"). Reduces response payload size.
$skipintegeroptionalNumber of messages to skip for pagination (0-based offset). Use with $top for paging through results.
$topintegeroptionalMaximum number of messages to return (1-1000). Defaults to 10 if omitted.
microsoft365_outlook_mailbox_settings_get#Retrieve the mailbox settings for the signed-in user. Returns automatic replies (out-of-office) configuration, language, timezone, working hours, date/time format, and delegate meeting message delivery preferences.0 params

Retrieve the mailbox settings for the signed-in user. Returns automatic replies (out-of-office) configuration, language, timezone, working hours, date/time format, and delegate meeting message delivery preferences.

microsoft365_outlook_mailbox_settings_update#Update mailbox settings for the signed-in user. Supports configuring automatic replies (out-of-office), language, timezone, working hours, date/time format, and delegate meeting message delivery preferences. Only fields provided will be updated.7 params

Update mailbox settings for the signed-in user. Supports configuring automatic replies (out-of-office), language, timezone, working hours, date/time format, and delegate meeting message delivery preferences. Only fields provided will be updated.

NameTypeRequiredDescription
automaticRepliesSettingobjectoptionalConfiguration for automatic replies (out-of-office). Set status, internal/external reply messages, and optional scheduled time window.
dateFormatstringoptionalPreferred date format string for the mailbox (e.g., 'MM/dd/yyyy', 'dd/MM/yyyy', 'yyyy-MM-dd').
delegateMeetingMessageDeliveryOptionsstringoptionalControls how meeting messages are delivered when a delegate is configured.
languageobjectoptionalLanguage and locale for the mailbox. Object with locale (e.g., 'en-US') and displayName.
timeFormatstringoptionalPreferred time format string for the mailbox (e.g., 'hh:mm tt' for 12-hour, 'HH:mm' for 24-hour).
timeZonestringoptionalPreferred time zone for the mailbox (e.g., 'UTC', 'Pacific Standard Time', 'Eastern Standard Time').
workingHoursobjectoptionalWorking hours configuration including days of week, start/end times, and time zone.
microsoft365_outlook_move_message#Move a message to a different mail folder.4 params

Move a message to a different mail folder.

NameTypeRequiredDescription
destination_idstringrequiredDestination folder ID.
message_idstringrequiredMessage ID.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_move_shared_mailbox_message#Move a message in a shared mailbox to a different mail folder. Requires the caller to have read/write access to the shared mailbox.3 params

Move a message in a shared mailbox to a different mail folder. Requires the caller to have read/write access to the shared mailbox.

NameTypeRequiredDescription
destination_folder_idstringrequiredThe ID or well-known name of the destination mail folder to move the message into (e.g., inbox, drafts, sentitems, deleteditems, junkemail, or a folder ID).
message_idstringrequiredThe unique identifier of the message to move within the shared mailbox.
shared_mailbox_idstringrequiredThe email address or user object ID of the shared mailbox containing the message (e.g., support@company.com or a GUID). The caller must have read/write permissions on this mailbox.
microsoft365_outlook_reply_from_shared_mailbox#Reply to an existing email message on behalf of a shared mailbox. The reply is automatically sent to the original sender and saved in the shared mailbox's Sent Items folder. Requires send-as or send-on-behalf permissions on the shared mailbox.3 params

Reply to an existing email message on behalf of a shared mailbox. The reply is automatically sent to the original sender and saved in the shared mailbox's Sent Items folder. Requires send-as or send-on-behalf permissions on the shared mailbox.

NameTypeRequiredDescription
commentstringrequiredThe reply message text content. This will be included as the comment/body of the reply email sent from the shared mailbox.
message_idstringrequiredThe unique identifier of the message in the shared mailbox to reply to. Retrieve from list or search shared mailbox messages.
shared_mailbox_idstringrequiredThe email address or user ID of the shared mailbox to reply from (e.g., support@company.com or a user object ID). The caller must have send-as or send-on-behalf permissions.
microsoft365_outlook_reply_to_message#Reply to an existing email message. The reply is automatically sent to the original sender and saved in the Sent Items folder.2 params

Reply to an existing email message. The reply is automatically sent to the original sender and saved in the Sent Items folder.

NameTypeRequiredDescription
commentstringrequiredReply message content
messageIdstringrequiredThe unique identifier of the message to reply to
microsoft365_outlook_search_messages#Search messages by keywords across subject, body, sender, and other fields. Returns matching messages with support for pagination.4 params

Search messages by keywords across subject, body, sender, and other fields. Returns matching messages with support for pagination.

NameTypeRequiredDescription
querystringrequiredSearch query string (searches across subject, body, from, to)
$selectstringoptionalComma-separated list of properties to return (e.g., "subject,from,receivedDateTime")
$skipintegeroptionalNumber of messages to skip for pagination
$topintegeroptionalNumber of messages to return (1-1000, default: 10)
microsoft365_outlook_search_people#Search for people relevant to the signed-in user by name or email.8 params

Search for people relevant to the signed-in user by name or email.

NameTypeRequiredDescription
filterstringoptionalOData filter.
order_bystringoptionalOrder by field.
schema_versionstringoptionalSchema version
searchstringoptionalSearch query.
selectstringoptionalSelect properties.
skipintegeroptionalSkip count.
tool_versionstringoptionalTool version
topintegeroptionalPage size.
microsoft365_outlook_search_shared_mailbox_messages#Search messages across all folders in a shared mailbox by keyword. Searches across subject, body, sender, and recipients. Requires Mail.Read or Mail.ReadWrite permissions on the shared mailbox.4 params

Search messages across all folders in a shared mailbox by keyword. Searches across subject, body, sender, and recipients. Requires Mail.Read or Mail.ReadWrite permissions on the shared mailbox.

NameTypeRequiredDescription
querystringrequiredSearch query string. Searches across subject, body, sender, and recipient fields. Example: "invoice Q1" will find messages mentioning invoice in Q1 context.
shared_mailbox_idstringrequiredThe email address or user ID of the shared mailbox to search (e.g., support@company.com or a user object ID).
$selectstringoptionalComma-separated list of message properties to return (e.g., "subject,from,receivedDateTime"). Reduces response payload size.
$topintegeroptionalMaximum number of messages to return (1-1000). Defaults to 10 if omitted.
microsoft365_outlook_send_message#Send an email message using Microsoft Graph API. The message is saved in the Sent Items folder by default.7 params

Send an email message using Microsoft Graph API. The message is saved in the Sent Items folder by default.

NameTypeRequiredDescription
bodystringrequiredBody content of the email
subjectstringrequiredSubject line of the email
toRecipientsarrayrequiredArray of email addresses to send to
bccRecipientsarrayoptionalArray of email addresses to BCC
bodyTypestringoptionalContent type of the body (Text or HTML)
ccRecipientsarrayoptionalArray of email addresses to CC
saveToSentItemsbooleanoptionalSave the message in Sent Items folder (default: true)
microsoft365_outlook_send_message_from_shared_mailbox#Send an email message on behalf of a shared mailbox using Microsoft Graph API. The message is saved in the shared mailbox's Sent Items folder by default. Requires the caller to have send-as or send-on-behalf-of permissions on the shared mailbox.8 params

Send an email message on behalf of a shared mailbox using Microsoft Graph API. The message is saved in the shared mailbox's Sent Items folder by default. Requires the caller to have send-as or send-on-behalf-of permissions on the shared mailbox.

NameTypeRequiredDescription
bodystringrequiredBody content of the email. Provide plain text or HTML depending on the bodyType field.
shared_mailbox_idstringrequiredThe email address or user ID of the shared mailbox to send from (e.g., support@company.com or a user object ID). The caller must have send-as or send-on-behalf permissions.
subjectstringrequiredSubject line of the email to send from the shared mailbox.
toRecipientsarrayrequiredArray of email addresses to send the email to from the shared mailbox. Example: ["customer@example.com"]
bccRecipientsarrayoptionalArray of email addresses to BCC on the outgoing message from the shared mailbox.
bodyTypestringoptionalContent type of the email body. Use 'Text' for plain text or 'HTML' for rich HTML content. Defaults to 'Text' if omitted.
ccRecipientsarrayoptionalArray of email addresses to CC on the outgoing message from the shared mailbox.
saveToSentItemsbooleanoptionalWhether to save the sent message in the shared mailbox's Sent Items folder. Defaults to true.
microsoft365_outlook_tentatively_accept_event#Tentatively accept a calendar event invitation.6 params

Tentatively accept a calendar event invitation.

NameTypeRequiredDescription
event_idstringrequiredEvent ID.
commentstringoptionalResponse comment.
proposed_new_timeobjectoptionalProposed new meeting time.
schema_versionstringoptionalSchema version
send_responsebooleanoptionalSend response.
tool_versionstringoptionalTool version
microsoft365_outlook_todo_checklist_items_create#Add a checklist item (subtask) to a specific task in a Microsoft To Do task list.4 params

Add a checklist item (subtask) to a specific task in a Microsoft To Do task list.

NameTypeRequiredDescription
display_namestringrequiredThe display name of the checklist item.
list_idstringrequiredThe ID of the task list.
task_idstringrequiredThe ID of the task to add the checklist item to.
is_checkedbooleanoptionalWhether the checklist item is already checked/completed.
microsoft365_outlook_todo_checklist_items_delete#Permanently delete a checklist item (subtask) from a task in a Microsoft To Do task list.3 params

Permanently delete a checklist item (subtask) from a task in a Microsoft To Do task list.

NameTypeRequiredDescription
checklist_item_idstringrequiredThe ID of the checklist item to delete.
list_idstringrequiredThe ID of the task list.
task_idstringrequiredThe ID of the task.
microsoft365_outlook_todo_checklist_items_get#Get a specific checklist item (subtask) from a task in a Microsoft To Do task list.3 params

Get a specific checklist item (subtask) from a task in a Microsoft To Do task list.

NameTypeRequiredDescription
checklist_item_idstringrequiredThe ID of the checklist item.
list_idstringrequiredThe ID of the task list.
task_idstringrequiredThe ID of the task.
microsoft365_outlook_todo_checklist_items_list#List all checklist items (subtasks) for a specific task in a Microsoft To Do task list.2 params

List all checklist items (subtasks) for a specific task in a Microsoft To Do task list.

NameTypeRequiredDescription
list_idstringrequiredThe ID of the task list.
task_idstringrequiredThe ID of the task.
microsoft365_outlook_todo_checklist_items_update#Update a checklist item (subtask) in a Microsoft To Do task. Only provided fields are changed.5 params

Update a checklist item (subtask) in a Microsoft To Do task. Only provided fields are changed.

NameTypeRequiredDescription
checklist_item_idstringrequiredThe ID of the checklist item to update.
list_idstringrequiredThe ID of the task list.
task_idstringrequiredThe ID of the task.
display_namestringoptionalNew display name for the checklist item.
is_checkedbooleanoptionalWhether the checklist item is checked/completed.
microsoft365_outlook_todo_lists_create#Create a new Microsoft To Do task list.1 param

Create a new Microsoft To Do task list.

NameTypeRequiredDescription
display_namestringrequiredThe name of the task list.
microsoft365_outlook_todo_lists_delete#Permanently delete a Microsoft To Do task list and all its tasks.1 param

Permanently delete a Microsoft To Do task list and all its tasks.

NameTypeRequiredDescription
list_idstringrequiredThe ID of the task list to delete.
microsoft365_outlook_todo_lists_get#Get a specific Microsoft To Do task list by ID.1 param

Get a specific Microsoft To Do task list by ID.

NameTypeRequiredDescription
list_idstringrequiredThe ID of the task list.
microsoft365_outlook_todo_lists_list#List all Microsoft To Do task lists for the current user.0 params

List all Microsoft To Do task lists for the current user.

microsoft365_outlook_todo_lists_update#Rename a Microsoft To Do task list.2 params

Rename a Microsoft To Do task list.

NameTypeRequiredDescription
display_namestringrequiredThe new name for the task list.
list_idstringrequiredThe ID of the task list to update.
microsoft365_outlook_todo_tasks_create#Create a new task in a Microsoft To Do task list with optional body, due date, importance, and reminder.10 params

Create a new task in a Microsoft To Do task list with optional body, due date, importance, and reminder.

NameTypeRequiredDescription
list_idstringrequiredThe ID of the task list to add the task to.
titlestringrequiredThe title of the task.
bodystringoptionalThe body/notes of the task (plain text).
categoriesarrayoptionalArray of category names to assign to the task.
due_datestringoptionalDue date in YYYY-MM-DD format (e.g. "2026-04-15").
due_time_zonestringoptionalTime zone for the due date (e.g. "UTC", "America/New_York"). Defaults to UTC.
importancestringoptionalThe importance of the task: low, normal, or high.
reminder_date_timestringoptionalReminder date and time in ISO 8601 format (e.g. "2026-04-15T09:00:00").
reminder_time_zonestringoptionalTime zone for the reminder (e.g. "UTC"). Defaults to UTC.
statusstringoptionalThe status of the task: notStarted, inProgress, completed, waitingOnOthers, or deferred.
microsoft365_outlook_todo_tasks_delete#Permanently delete a task from a Microsoft To Do task list.2 params

Permanently delete a task from a Microsoft To Do task list.

NameTypeRequiredDescription
list_idstringrequiredThe ID of the task list.
task_idstringrequiredThe ID of the task to delete.
microsoft365_outlook_todo_tasks_get#Get a specific task from a Microsoft To Do task list.2 params

Get a specific task from a Microsoft To Do task list.

NameTypeRequiredDescription
list_idstringrequiredThe ID of the task list.
task_idstringrequiredThe ID of the task.
microsoft365_outlook_todo_tasks_list#List all tasks in a Microsoft To Do task list with optional filtering and pagination.5 params

List all tasks in a Microsoft To Do task list with optional filtering and pagination.

NameTypeRequiredDescription
list_idstringrequiredThe ID of the task list.
$filterstringoptionalOData filter expression (e.g. "status eq 'notStarted'").
$orderbystringoptionalProperty to sort by (e.g. "createdDateTime desc").
$skipintegeroptionalNumber of tasks to skip for pagination.
$topintegeroptionalNumber of tasks to return (default: 10).
microsoft365_outlook_todo_tasks_update#Update a task in a Microsoft To Do task list. Only provided fields are changed.9 params

Update a task in a Microsoft To Do task list. Only provided fields are changed.

NameTypeRequiredDescription
list_idstringrequiredThe ID of the task list.
task_idstringrequiredThe ID of the task to update.
bodystringoptionalNew body/notes for the task (plain text).
categoriesarrayoptionalArray of category names to assign to the task.
due_datestringoptionalDue date in YYYY-MM-DD format.
due_time_zonestringoptionalTime zone for the due date. Defaults to UTC.
importancestringoptionalThe importance: low, normal, or high.
statusstringoptionalThe status: notStarted, inProgress, completed, waitingOnOthers, or deferred.
titlestringoptionalNew title for the task.
microsoft365_outlook_update_calendar_event#Update an existing Outlook calendar event. Only provided fields will be updated. Supports time, attendees, location, reminders, online meetings, recurrence, and event properties.30 params

Update an existing Outlook calendar event. Only provided fields will be updated. Supports time, attendees, location, reminders, online meetings, recurrence, and event properties.

NameTypeRequiredDescription
event_idstringrequiredThe ID of the calendar event to update
attendees_optionalstringoptionalComma-separated optional attendee emails
attendees_requiredstringoptionalComma-separated required attendee emails
attendees_resourcestringoptionalComma-separated resource emails (meeting rooms, equipment)
body_contentstringoptionalEvent description/body
body_contentTypestringoptionalContent type of body
categoriesstringoptionalComma-separated categories
end_datetimestringoptionalEvent end time in RFC3339 format
end_timezonestringoptionalTimezone for end time
hideAttendeesbooleanoptionalWhen true, each attendee only sees themselves
importancestringoptionalEvent importance level
isAllDaybooleanoptionalMark as all-day event
isOnlineMeetingbooleanoptionalCreate an online meeting (Teams/Skype)
isReminderOnbooleanoptionalEnable or disable reminder
locationstringoptionalPhysical or virtual location
locationsstringoptionalJSON array of location objects with displayName, address, coordinates
onlineMeetingProviderstringoptionalOnline meeting provider
recurrence_days_of_weekstringoptionalDays of week for weekly recurrence (comma-separated)
recurrence_end_datestringoptionalEnd date for recurrence (YYYY-MM-DD)
recurrence_intervalintegeroptionalHow often the event recurs (e.g., every 2 weeks = 2)
recurrence_occurrencesintegeroptionalNumber of occurrences
recurrence_range_typestringoptionalHow the recurrence ends
recurrence_start_datestringoptionalStart date for recurrence (YYYY-MM-DD)
recurrence_typestringoptionalRecurrence pattern type
reminderMinutesBeforeStartintegeroptionalMinutes before event start to show reminder
sensitivitystringoptionalEvent sensitivity/privacy level
showAsstringoptionalFree/busy status
start_datetimestringoptionalEvent start time in RFC3339 format
start_timezonestringoptionalTimezone for start time
subjectstringoptionalEvent title/summary
microsoft365_outlook_update_calendar_group#Update the name of an existing calendar group in the signed-in user's mailbox.2 params

Update the name of an existing calendar group in the signed-in user's mailbox.

NameTypeRequiredDescription
group_idstringrequiredThe unique ID of the calendar group to update (e.g., 'AAMkAGI2...'). Obtain from List Calendar Groups.
namestringrequiredThe new name for the calendar group (e.g., 'Personal Calendars').
microsoft365_outlook_update_calendar_permission#Update the role of an existing calendar permission entry. Use this to change a user's access level (e.g., upgrade from read to write, or downgrade from delegate to read) on a specific calendar.3 params

Update the role of an existing calendar permission entry. Use this to change a user's access level (e.g., upgrade from read to write, or downgrade from delegate to read) on a specific calendar.

NameTypeRequiredDescription
calendar_idstringrequiredThe unique identifier of the calendar that contains the permission to update.
permission_idstringrequiredThe unique identifier of the calendar permission entry to update. Retrieve from the list calendar permissions endpoint.
rolestringrequiredThe new permission role to assign. Valid values: freeBusyRead (see free/busy only), limitedRead (see title and location), read (see all event details), write (create/edit/delete events), delegateWithoutPrivateEventAccess (delegate, no private events), delegateWithPrivateEventAccess (delegate including private events), custom (custom role).
microsoft365_outlook_update_category#Update the display name or color of an existing Outlook master category. Provide the category ID and at least one of display_name or color to update.3 params

Update the display name or color of an existing Outlook master category. Provide the category ID and at least one of display_name or color to update.

NameTypeRequiredDescription
category_idstringrequiredThe unique ID of the Outlook category to update. Retrieve it from the list_categories tool.
colorstringoptionalNew color for the category. Use 'none' for no color, or 'preset0' through 'preset24' for a specific color slot.
display_namestringoptionalNew display name for the category. Must be unique among the user's categories if provided.
microsoft365_outlook_update_contact#Update properties of an existing contact.9 params

Update properties of an existing contact.

NameTypeRequiredDescription
contact_idstringrequiredContact ID.
company_namestringoptionalCompany name.
email_addressesstringoptionalEmail addresses.
given_namestringoptionalFirst name.
job_titlestringoptionalJob title.
mobile_phonestringoptionalMobile phone.
schema_versionstringoptionalSchema version
surnamestringoptionalLast name.
tool_versionstringoptionalTool version
microsoft365_outlook_update_contact_folder#Update the display name of an existing contact folder in the signed-in user's mailbox.2 params

Update the display name of an existing contact folder in the signed-in user's mailbox.

NameTypeRequiredDescription
display_namestringrequiredThe new display name for the contact folder (e.g., 'Updated Contacts').
folder_idstringrequiredThe unique ID of the contact folder to update (e.g., 'AAMkAGI2...'). Obtain from List Contact Folders.
microsoft365_outlook_update_focused_inbox_override#Update an existing Focused Inbox override to change how messages from a specific sender are classified. Use this to switch a sender between Focused and Other inbox routing.2 params

Update an existing Focused Inbox override to change how messages from a specific sender are classified. Use this to switch a sender between Focused and Other inbox routing.

NameTypeRequiredDescription
classify_asstringrequiredUpdated classification for the sender: 'focused' to route to Focused inbox, 'other' to route to Other inbox.
override_idstringrequiredThe unique ID of the Focused Inbox override to update. Retrieve it from the list_focused_inbox_overrides tool.
microsoft365_outlook_update_mail_folder#Rename or update a mail folder.4 params

Rename or update a mail folder.

NameTypeRequiredDescription
display_namestringrequiredNew folder name.
folder_idstringrequiredFolder ID.
schema_versionstringoptionalSchema version
tool_versionstringoptionalTool version
microsoft365_outlook_update_message#Update properties of an email message (e.g. mark as read, set importance).12 params

Update properties of an email message (e.g. mark as read, set importance).

NameTypeRequiredDescription
message_idstringrequiredMessage ID.
bodystringoptionalMessage body content.
body_content_typestringoptionalBody content type.
categoriesarrayoptionalCategories.
importancestringoptionalImportance.
inference_classificationstringoptionalInference classification.
is_delivery_receipt_requestedbooleanoptionalDelivery receipt requested.
is_readbooleanoptionalMark as read.
is_read_receipt_requestedbooleanoptionalRead receipt requested.
schema_versionstringoptionalSchema version
subjectstringoptionalUpdated subject.
tool_versionstringoptionalTool version
microsoft365_outlook_update_message_rule#Update an existing inbox message rule.10 params

Update an existing inbox message rule.

NameTypeRequiredDescription
rule_idstringrequiredRule ID.
actionsobjectoptionalRule actions.
conditionsobjectoptionalRule conditions.
display_namestringoptionalRule name.
exceptionsobjectoptionalException conditions for the rule.
is_enabledbooleanoptionalEnable rule.
is_read_onlybooleanoptionalMark rule as read-only.
schema_versionstringoptionalSchema version
sequenceintegeroptionalRule sequence.
tool_versionstringoptionalTool version
microsoft365_powerpoint_create_presentation#Create a new PowerPoint presentation (.pptx) in OneDrive by initiating a resumable upload session. Returns an uploadUrl that the caller must use to upload the .pptx file bytes via one or more PUT requests. The presentation is placed under the specified parent folder with the given filename. Requires Files.ReadWrite or Files.ReadWrite.All scope.3 params

Create a new PowerPoint presentation (.pptx) in OneDrive by initiating a resumable upload session. Returns an uploadUrl that the caller must use to upload the .pptx file bytes via one or more PUT requests. The presentation is placed under the specified parent folder with the given filename. Requires Files.ReadWrite or Files.ReadWrite.All scope.

NameTypeRequiredDescription
filenamestringrequiredThe base name of the PowerPoint presentation to create, without the .pptx extension. The extension is appended automatically. Example: "Q4 Review" creates "Q4 Review.pptx".
parent_idstringrequiredThe OneDrive item ID of the parent folder where the presentation will be created. Use "root" to create the file at the top level of OneDrive. Obtain folder IDs from list or get drive item operations.
conflict_behaviorstringoptionalBehavior when a file with the same name already exists in the target folder. "fail" aborts and returns an error, "replace" overwrites the existing file, "rename" saves the new presentation with a different auto-generated name. Default: replace.
microsoft365_powerpoint_read_presentation#Export a PowerPoint presentation (.pptx) from OneDrive as a PDF by requesting the file content with the format=pdf conversion parameter. Returns the PDF binary of the presentation. Note: Microsoft Graph converts the presentation server-side to PDF; it does not return Markdown or plain text. Client-side parsing is required to extract text or slide content from the returned PDF. Requires Files.Read or Files.ReadWrite scope.1 param

Export a PowerPoint presentation (.pptx) from OneDrive as a PDF by requesting the file content with the format=pdf conversion parameter. Returns the PDF binary of the presentation. Note: Microsoft Graph converts the presentation server-side to PDF; it does not return Markdown or plain text. Client-side parsing is required to extract text or slide content from the returned PDF. Requires Files.Read or Files.ReadWrite scope.

NameTypeRequiredDescription
item_idstringrequiredThe unique OneDrive item ID of the PowerPoint presentation (.pptx) to export as PDF. Obtain item IDs from list drive items, search drive items, or get drive item operations. Example: "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K".
microsoft365_sharepoint_add_group_member#Add an Azure AD user to a Microsoft 365 group (including SharePoint site groups) by providing the group ID and the user's object ID. This uses the Graph API directoryObjects reference endpoint to create the membership link.2 params

Add an Azure AD user to a Microsoft 365 group (including SharePoint site groups) by providing the group ID and the user's object ID. This uses the Graph API directoryObjects reference endpoint to create the membership link.

NameTypeRequiredDescription
group_idstringrequiredThe Azure AD object ID of the group to add the member to. Example: '7d8a5b3c-1234-5678-abcd-ef0123456789'.
user_idstringrequiredThe Azure AD object ID of the user to add to the group. Use the find_user_by_email tool to resolve an email to an object ID. Example: 'aaaabbbb-1234-5678-abcd-ef0123456789'.
microsoft365_sharepoint_add_role_assignment#Grant a user or group a role (read, write, or owner) on a SharePoint site by adding a permission entry. Provide either user_id or group_id (not both). The roles array should contain one or more of: 'read', 'write', 'owner'.4 params

Grant a user or group a role (read, write, or owner) on a SharePoint site by adding a permission entry. Provide either user_id or group_id (not both). The roles array should contain one or more of: 'read', 'write', 'owner'.

NameTypeRequiredDescription
rolesarrayrequiredArray of roles to grant. Valid values are 'read', 'write', and 'owner'. Example: ["write"] grants write (contribute) permission.
site_idstringrequiredID of the SharePoint site on which to add the permission. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
group_idstringoptionalAzure AD group object ID to grant the role to. Provide either user_id or group_id — not both. Example: '7d8a5b3c-1234-5678-abcd-ef0123456789'.
user_idstringoptionalAzure AD user object ID to grant the role to. Provide either user_id or group_id — not both. Example: 'aaaabbbb-1234-5678-abcd-ef0123456789'.
microsoft365_sharepoint_checkin_file#Check in a checked-out file in a SharePoint document library to make the version available to others. Optionally provide a comment describing the changes and specify the check-in type. Requires the file to be checked out first.4 params

Check in a checked-out file in a SharePoint document library to make the version available to others. Optionally provide a comment describing the changes and specify the check-in type. Requires the file to be checked out first.

NameTypeRequiredDescription
item_idstringrequiredThe unique drive item ID of the file to check in. The file must currently be checked out. Obtain item IDs from list drive items or get drive item operations.
site_idstringrequiredID of the SharePoint site that contains the file. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
check_in_asstringoptionalThe type of check-in to perform. 'published' makes the version visible to all users. 'unspecified' (default) lets the server decide based on document library configuration.
commentstringoptionalAn optional comment to associate with the checked-in version, describing the changes made.
microsoft365_sharepoint_checkout_file#Check out a file in a SharePoint document library to prevent others from editing it while you make changes. The file must be checked back in using the check-in operation when editing is complete.2 params

Check out a file in a SharePoint document library to prevent others from editing it while you make changes. The file must be checked back in using the check-in operation when editing is complete.

NameTypeRequiredDescription
item_idstringrequiredThe unique drive item ID of the file to check out. Obtain item IDs from list drive items or get drive item operations.
site_idstringrequiredID of the SharePoint site that contains the file. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_create_list#Create a new list in a SharePoint site. Specify a display name and optionally a template type (e.g., genericList, documentLibrary, events) and description. Returns the newly created list.4 params

Create a new list in a SharePoint site. Specify a display name and optionally a template type (e.g., genericList, documentLibrary, events) and description. Returns the newly created list.

NameTypeRequiredDescription
display_namestringrequiredDisplay name for the new list. Example: 'Project Tasks'.
site_idstringrequiredID of the SharePoint site in which to create the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
descriptionstringoptionalOptional description for the new list. Example: 'Tracks project tasks and assignments.'
templatestringoptionalSharePoint list template to use. Valid values: genericList (default), documentLibrary, survey, links, announcements, contacts, events, tasks.
microsoft365_sharepoint_create_list_field#Add a new column (field) to a SharePoint list. Specify the internal column name, column type (text, number, boolean, dateTime, choice, hyperlinkOrPicture, personOrGroup), and optionally a display name and description. The tool emits the appropriate Microsoft Graph column definition block for the chosen type.6 params

Add a new column (field) to a SharePoint list. Specify the internal column name, column type (text, number, boolean, dateTime, choice, hyperlinkOrPicture, personOrGroup), and optionally a display name and description. The tool emits the appropriate Microsoft Graph column definition block for the chosen type.

NameTypeRequiredDescription
list_idstringrequiredID of the SharePoint list to which the column will be added. Use the list GUID or display name.
namestringrequiredInternal name for the new column. Used as the key in item fields objects. Must be unique within the list and contain no spaces (use camelCase or underscores). Example: 'taskStatus'.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
column_typestringoptionalType of column to create. Determines which Microsoft Graph column configuration block is used. Valid values: text (single or multi-line text), number (numeric values), boolean (yes/no checkbox), dateTime (date and/or time), choice (dropdown or radio from a fixed list), hyperlinkOrPicture (URL or image), personOrGroup (people picker). Default: text.
descriptionstringoptionalOptional description for the new column. Appears as a tooltip or hint in the SharePoint list UI.
display_namestringoptionalHuman-readable display name for the column as shown in the SharePoint list UI. If omitted, the internal name is used.
microsoft365_sharepoint_create_list_item#Create a new item in a SharePoint list. Provide a 'fields' object whose keys are the internal column names and whose values are the field data. The required 'Title' field sets the item's primary display name.3 params

Create a new item in a SharePoint list. Provide a 'fields' object whose keys are the internal column names and whose values are the field data. The required 'Title' field sets the item's primary display name.

NameTypeRequiredDescription
fieldsobjectrequiredObject containing the field values for the new item. Keys are internal column names (e.g., 'Title', 'Status', 'DueDate'). Example: {"Title": "New Task", "Status": "In Progress"}.
list_idstringrequiredID of the SharePoint list in which to create the item. Use the list GUID or display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_create_subsite#Create a new subsite under an existing SharePoint site using the Microsoft Graph beta API. Requires the parent site ID and display name. Optionally specify a description and web template (e.g., 'STS#0' for a team site).4 params

Create a new subsite under an existing SharePoint site using the Microsoft Graph beta API. Requires the parent site ID and display name. Optionally specify a description and web template (e.g., 'STS#0' for a team site).

NameTypeRequiredDescription
display_namestringrequiredDisplay name of the new subsite. Example: 'Marketing Q3 Campaign'.
parent_site_idstringrequiredID of the parent SharePoint site under which the subsite will be created. Use a site GUID or 'root' for the tenant root site.
descriptionstringoptionalOptional description for the new subsite. Example: 'Site for the Q3 marketing campaign team.'
web_templatestringoptionalSharePoint web template to use when creating the subsite. Common values: 'STS#0' (Team Site), 'BLOG#0' (Blog Site), 'BDR#0' (Document Center). Defaults to the API default if not specified.
microsoft365_sharepoint_delete_list#Permanently delete a SharePoint list from a site. This action is irreversible and removes the list along with all its items and metadata.2 params

Permanently delete a SharePoint list from a site. This action is irreversible and removes the list along with all its items and metadata.

NameTypeRequiredDescription
list_idstringrequiredID of the SharePoint list to delete. Use the list GUID or the list's display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_delete_list_field#Permanently delete a column (field) from a SharePoint list. This action is irreversible and removes the column definition and all data stored in that column for every list item.3 params

Permanently delete a column (field) from a SharePoint list. This action is irreversible and removes the column definition and all data stored in that column for every list item.

NameTypeRequiredDescription
column_idstringrequiredID of the column to delete. Use the column GUID returned by the list fields endpoint.
list_idstringrequiredID of the SharePoint list that contains the column. Use the list GUID or display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_delete_list_item#Permanently delete an item from a SharePoint list. This action is irreversible and removes the item and all its field data.3 params

Permanently delete an item from a SharePoint list. This action is irreversible and removes the item and all its field data.

NameTypeRequiredDescription
item_idstringrequiredID of the list item to delete. This is the numeric or string identifier of the item within the list.
list_idstringrequiredID of the SharePoint list that contains the item. Use the list GUID or display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_delete_role_assignment#Remove a specific permission entry from a SharePoint site by deleting its permission ID. This permanently removes the granted access for the user or group associated with that permission.2 params

Remove a specific permission entry from a SharePoint site by deleting its permission ID. This permanently removes the granted access for the user or group associated with that permission.

NameTypeRequiredDescription
permission_idstringrequiredThe ID of the permission entry to delete. Obtain this from the list permissions endpoint. Example: 'aGVyZUlzVGhlV2F5VGhlUG93ZXJJcw'.
site_idstringrequiredID of the SharePoint site from which to remove the permission. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_delete_webhook#Delete a Microsoft Graph change notification subscription (webhook) by its subscription ID. After deletion, no further notifications will be sent to the registered notification URL for this subscription.1 param

Delete a Microsoft Graph change notification subscription (webhook) by its subscription ID. After deletion, no further notifications will be sent to the registered notification URL for this subscription.

NameTypeRequiredDescription
subscription_idstringrequiredThe ID of the subscription to delete. Obtain this from the create subscription response or by listing subscriptions. Example: 'abc123de-4567-89ab-cdef-0123456789ab'.
microsoft365_sharepoint_download_file#Download the binary content of a file from a SharePoint document library by its item ID. The response is the raw file bytes (not JSON). For text files this will be readable text; for binary files (images, Office documents) it will be binary data. Use the item ID from list or get drive item operations.2 params

Download the binary content of a file from a SharePoint document library by its item ID. The response is the raw file bytes (not JSON). For text files this will be readable text; for binary files (images, Office documents) it will be binary data. Use the item ID from list or get drive item operations.

NameTypeRequiredDescription
item_idstringrequiredThe unique drive item ID of the file to download from the SharePoint site's document library. Obtain item IDs from list drive items or search drive items operations.
site_idstringrequiredID of the SharePoint site that contains the file. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_find_user_by_email#Look up an Azure Active Directory user by their email address (UPN). Returns the user's object ID, display name, and other profile properties. This is useful for resolving a user email to an object ID before adding them to a SharePoint site or group.1 param

Look up an Azure Active Directory user by their email address (UPN). Returns the user's object ID, display name, and other profile properties. This is useful for resolving a user email to an object ID before adding them to a SharePoint site or group.

NameTypeRequiredDescription
emailstringrequiredThe email address (user principal name) of the Azure AD user to look up. Example: 'john.doe@contoso.com'.
microsoft365_sharepoint_follow_document#Follow a SharePoint document or OneDrive file so it appears in the signed-in user's followed documents list. Provide the drive item ID of the document to follow.1 param

Follow a SharePoint document or OneDrive file so it appears in the signed-in user's followed documents list. Provide the drive item ID of the document to follow.

NameTypeRequiredDescription
item_idstringrequiredThe ID of the drive item (document) to follow. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
microsoft365_sharepoint_get_list#Retrieve a specific SharePoint list by its ID within a site. Optionally expand related resources such as columns and items to retrieve list metadata in a single call.3 params

Retrieve a specific SharePoint list by its ID within a site. Optionally expand related resources such as columns and items to retrieve list metadata in a single call.

NameTypeRequiredDescription
list_idstringrequiredID or name of the SharePoint list to retrieve. Can be the list GUID or the list's display name (URL-encoded).
site_idstringrequiredID of the SharePoint site containing the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
$expandstringoptionalComma-separated list of related resources to expand. Example: 'columns,items' to include column definitions and list items in the response.
microsoft365_sharepoint_get_list_item#Retrieve a single item from a SharePoint list by its item ID. Use '$expand=fields' to include the column values in the response.5 params

Retrieve a single item from a SharePoint list by its item ID. Use '$expand=fields' to include the column values in the response.

NameTypeRequiredDescription
item_idstringrequiredID of the list item to retrieve. This is the numeric or GUID identifier of the item within the list.
list_idstringrequiredID of the SharePoint list that contains the item. Use the list GUID or display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
$expandstringoptionalComma-separated list of related resources to expand. Default is 'fields' to include column values. Example: 'fields'.
$selectstringoptionalComma-separated list of properties to return. Example: 'id,createdDateTime,fields'.
microsoft365_sharepoint_get_search_suggestions#Get search query suggestions for SharePoint content using the Microsoft Search beta API. Returns autocomplete suggestions based on the provided search text to help users refine their queries.1 param

Get search query suggestions for SharePoint content using the Microsoft Search beta API. Returns autocomplete suggestions based on the provided search text to help users refine their queries.

NameTypeRequiredDescription
textstringrequiredThe partial search term for which to retrieve suggestions. Example: 'proj' returns suggestions like 'project plan', 'project budget'.
microsoft365_sharepoint_get_site#Retrieve properties of a SharePoint site by its ID. Use 'root' for the tenant root site, a GUID for a specific site, or the format '<hostname>:/sites/<path>' (e.g., 'contoso.sharepoint.com:/sites/Marketing').1 param

Retrieve properties of a SharePoint site by its ID. Use 'root' for the tenant root site, a GUID for a specific site, or the format '<hostname>:/sites/<path>' (e.g., 'contoso.sharepoint.com:/sites/Marketing').

NameTypeRequiredDescription
site_idstringrequiredID of the SharePoint site to retrieve. Use 'root' for the tenant root site, a site GUID, or the format '<hostname>:/sites/<path>' (e.g., 'contoso.sharepoint.com:/sites/Marketing').
microsoft365_sharepoint_list_content_types#List all content types defined in a SharePoint site. Supports OData filtering, field selection, and pagination via $top. Content types define the metadata schema for lists and libraries.4 params

List all content types defined in a SharePoint site. Supports OData filtering, field selection, and pagination via $top. Content types define the metadata schema for lists and libraries.

NameTypeRequiredDescription
site_idstringrequiredID of the SharePoint site whose content types to retrieve. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
$filterstringoptionalOData filter expression to narrow results. Example: "isBuiltIn eq false" to return only custom content types.
$selectstringoptionalComma-separated list of properties to return for each content type. Example: 'id,name,description,isBuiltIn'.
$topintegeroptionalMaximum number of content types to return per page. Default is determined by the API.
microsoft365_sharepoint_list_drives#List all drives (document libraries) within a specific SharePoint site. Returns drive IDs, names, and types. Use the returned drive IDs with other drive item tools to access files within that library. To list all drives accessible to the signed-in user across all sites, use microsoft365_onedrive_list_drives instead.2 params

List all drives (document libraries) within a specific SharePoint site. Returns drive IDs, names, and types. Use the returned drive IDs with other drive item tools to access files within that library. To list all drives accessible to the signed-in user across all sites, use microsoft365_onedrive_list_drives instead.

NameTypeRequiredDescription
site_idstringrequiredThe unique ID of the SharePoint site whose drives to list. Obtain site IDs from microsoft365_sharepoint_get_site or microsoft365_sharepoint_list_sites.
$selectstringoptionalComma-separated list of drive properties to return. Example: "id,name,driveType" reduces response payload.
microsoft365_sharepoint_list_file_versions#List all versions of a file in a SharePoint document library. Returns version metadata including version number, last modified time, size, and the user who made each change.3 params

List all versions of a file in a SharePoint document library. Returns version metadata including version number, last modified time, size, and the user who made each change.

NameTypeRequiredDescription
item_idstringrequiredThe unique drive item ID of the file whose version history to retrieve. Obtain item IDs from list drive items or get drive item operations.
site_idstringrequiredID of the SharePoint site that contains the file. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
$topintegeroptionalMaximum number of versions to return per page. Default is determined by the API.
microsoft365_sharepoint_list_followed_sites#List all SharePoint sites that the signed-in user is following. Returns site IDs, names, URLs, and descriptions. Use the returned site IDs with microsoft365_sharepoint_get_site or microsoft365_sharepoint_list_drives to explore the site's content.0 params

List all SharePoint sites that the signed-in user is following. Returns site IDs, names, URLs, and descriptions. Use the returned site IDs with microsoft365_sharepoint_get_site or microsoft365_sharepoint_list_drives to explore the site's content.

microsoft365_sharepoint_list_list_fields#List all column definitions (fields) for a SharePoint list. Returns metadata for each column including its name, type, and configuration. Supports OData filtering, field selection, and pagination.5 params

List all column definitions (fields) for a SharePoint list. Returns metadata for each column including its name, type, and configuration. Supports OData filtering, field selection, and pagination.

NameTypeRequiredDescription
list_idstringrequiredID of the SharePoint list whose column definitions to retrieve. Use the list GUID or display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
$filterstringoptionalOData filter expression to narrow results. Example: "hidden eq false" to return only visible columns.
$selectstringoptionalComma-separated list of properties to return for each column. Example: 'id,name,displayName,columnGroup,hidden'.
$topintegeroptionalMaximum number of columns to return per page. Default is determined by the API.
microsoft365_sharepoint_list_list_items#Retrieve items from a SharePoint list. Supports OData filtering, field selection, ordering, pagination, and expanding related resources such as fields (column values).8 params

Retrieve items from a SharePoint list. Supports OData filtering, field selection, ordering, pagination, and expanding related resources such as fields (column values).

NameTypeRequiredDescription
list_idstringrequiredID of the SharePoint list whose items to retrieve. Use the list GUID or display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
$expandstringoptionalComma-separated list of related resources to expand. Use 'fields' to include the column values for each item. Example: 'fields'.
$filterstringoptionalOData filter expression to narrow results. Example: "fields/Status eq 'Active'" to return only active items.
$orderbystringoptionalOData orderby expression to sort results. Example: 'fields/Title asc' or 'createdDateTime desc'.
$selectstringoptionalComma-separated list of properties to return for each item. Example: 'id,createdDateTime,fields'.
$skipintegeroptionalNumber of items to skip for pagination. Use with $top to page through results.
$topintegeroptionalMaximum number of items to return per page. Default is determined by the API.
microsoft365_sharepoint_list_lists#List all lists in a SharePoint site. Supports OData filtering, field selection, pagination, and expansion of related resources such as columns and items.5 params

List all lists in a SharePoint site. Supports OData filtering, field selection, pagination, and expansion of related resources such as columns and items.

NameTypeRequiredDescription
site_idstringrequiredID of the SharePoint site whose lists to retrieve. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
$expandstringoptionalComma-separated list of related resources to expand. Example: 'columns,items' to include column definitions and list items.
$filterstringoptionalOData filter expression to narrow results. Example: "list/template eq 'documentLibrary'" to return only document libraries.
$selectstringoptionalComma-separated list of properties to return for each list. Example: 'id,displayName,description,webUrl'.
$topintegeroptionalMaximum number of lists to return per page. Default is determined by the API.
microsoft365_sharepoint_list_site_members#List all permission entries (members) for a SharePoint site. Returns users and groups with their assigned roles. Supports OData pagination and expansion of related identity resources.3 params

List all permission entries (members) for a SharePoint site. Returns users and groups with their assigned roles. Supports OData pagination and expansion of related identity resources.

NameTypeRequiredDescription
site_idstringrequiredID of the SharePoint site whose members (permissions) to retrieve. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
$expandstringoptionalComma-separated list of related resources to expand. Example: 'grantedToIdentities' to include the full identity objects for each permission entry.
$topintegeroptionalMaximum number of permission entries to return per page. Default is determined by the API.
microsoft365_sharepoint_list_sites#List SharePoint sites accessible to the signed-in user. Use the search parameter to find sites by name or keyword. Defaults to returning all sites (search=*). Supports OData query options for pagination and field selection.3 params

List SharePoint sites accessible to the signed-in user. Use the search parameter to find sites by name or keyword. Defaults to returning all sites (search=*). Supports OData query options for pagination and field selection.

NameTypeRequiredDescription
$selectstringoptionalComma-separated list of properties to return for each site. Example: 'id,displayName,webUrl,description'.
$topintegeroptionalMaximum number of sites to return per page (1-999). Default is determined by the API.
searchstringoptionalSearch keyword to filter sites by name or description. Use '*' to return all accessible sites. Example: 'Marketing' or 'project'.
microsoft365_sharepoint_recycle_item#Move a file or folder in a SharePoint document library to the site recycle bin. This is a soft-delete — the item can be restored from the recycle bin. Permanent deletion requires a separate operation on the recycle bin itself.2 params

Move a file or folder in a SharePoint document library to the site recycle bin. This is a soft-delete — the item can be restored from the recycle bin. Permanent deletion requires a separate operation on the recycle bin itself.

NameTypeRequiredDescription
item_idstringrequiredThe unique drive item ID of the file or folder to move to the recycle bin. Obtain item IDs from list drive items or search drive items operations.
site_idstringrequiredID of the SharePoint site that contains the item to recycle. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_remove_group_member#Remove a user from an Azure AD group (including Microsoft 365 and SharePoint site groups) by providing the group ID and user object ID. This permanently removes the membership.2 params

Remove a user from an Azure AD group (including Microsoft 365 and SharePoint site groups) by providing the group ID and user object ID. This permanently removes the membership.

NameTypeRequiredDescription
group_idstringrequiredThe Azure AD object ID of the group to remove the member from. Example: '7d8a5b3c-1234-5678-abcd-ef0123456789'.
user_idstringrequiredThe Azure AD object ID of the user to remove from the group. Example: 'aaaabbbb-1234-5678-abcd-ef0123456789'.
microsoft365_sharepoint_restore_recycled_item#Restore a previously recycled (soft-deleted) item in a SharePoint document library. Optionally specify a new parent folder and/or new name for the restored item. If neither is provided, the item is restored to its original location.4 params

Restore a previously recycled (soft-deleted) item in a SharePoint document library. Optionally specify a new parent folder and/or new name for the restored item. If neither is provided, the item is restored to its original location.

NameTypeRequiredDescription
item_idstringrequiredThe unique drive item ID of the recycled item to restore. Obtain item IDs from list drive items or search recycled items operations.
site_idstringrequiredID of the SharePoint site that contains the recycled item. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
new_namestringoptionalOptional new filename to give the restored item. If omitted, the item retains its original name.
new_parent_idstringoptionalOptional drive item ID of the parent folder to restore the item into. If omitted, the item is restored to its original parent location.
microsoft365_sharepoint_subscribe_webhook#Create a webhook subscription to receive change notifications for a SharePoint list or site resource. When changes matching the specified change type occur, Graph will POST a notification to your notification URL. Note: the notification URL must be HTTPS and must be pre-approved/allowlisted in the backend. Subscriptions expire within 3 days and must be renewed before expiry.5 params

Create a webhook subscription to receive change notifications for a SharePoint list or site resource. When changes matching the specified change type occur, Graph will POST a notification to your notification URL. Note: the notification URL must be HTTPS and must be pre-approved/allowlisted in the backend. Subscriptions expire within 3 days and must be renewed before expiry.

NameTypeRequiredDescription
expiration_date_timestringrequiredThe ISO 8601 datetime when the subscription expires. Maximum is 3 days from now for SharePoint resources. Example: '2026-06-20T12:00:00Z'.
notification_urlstringrequiredThe HTTPS URL that will receive notifications when changes occur. Must be publicly accessible and pre-approved by the backend. Example: 'https://webhook.example.com/notifications'.
resourcestringrequiredThe Graph API resource path to monitor for changes. For SharePoint lists use: 'sites/{site_id}/lists/{list_id}'. For an entire site drive: 'sites/{site_id}/drive/root'. Example: 'sites/contoso.sharepoint.com,abc123,def456/lists/list-guid-here'.
change_typestringoptionalThe type of change to subscribe to. Valid values: 'created', 'updated', 'deleted', 'all'. Default is 'updated'.
client_statestringoptionalOptional secret string included in the notification payload so you can verify it came from Microsoft Graph. Max 128 characters. Example: 'my-secret-key-12345'.
microsoft365_sharepoint_unfollow_document#Stop following a SharePoint document or OneDrive file. The document will be removed from the signed-in user's followed documents list. Provide the drive item ID of the document to unfollow.1 param

Stop following a SharePoint document or OneDrive file. The document will be removed from the signed-in user's followed documents list. Provide the drive item ID of the document to unfollow.

NameTypeRequiredDescription
item_idstringrequiredThe ID of the drive item (document) to unfollow. Example: '01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K'.
microsoft365_sharepoint_update_list#Update the display name or description of an existing SharePoint list. Provide the site ID, list ID, and at least one of display_name or description to update.4 params

Update the display name or description of an existing SharePoint list. Provide the site ID, list ID, and at least one of display_name or description to update.

NameTypeRequiredDescription
list_idstringrequiredID or name of the SharePoint list to update. Can be the list GUID or the list's display name.
site_idstringrequiredID of the SharePoint site containing the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
descriptionstringoptionalNew description for the SharePoint list. Example: 'Updated task list for Q3 project.'
display_namestringoptionalNew display name for the SharePoint list. Example: 'Q3 Project Tasks'.
microsoft365_sharepoint_update_list_field#Update the metadata of an existing SharePoint list column (field). Supports updating the display name, description, hidden visibility, and read-only status. Only provided fields are modified.7 params

Update the metadata of an existing SharePoint list column (field). Supports updating the display name, description, hidden visibility, and read-only status. Only provided fields are modified.

NameTypeRequiredDescription
column_idstringrequiredID of the column to update. Use the column GUID returned by the list fields endpoint.
list_idstringrequiredID of the SharePoint list that contains the column. Use the list GUID or display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
descriptionstringoptionalNew description for the column. Appears as a tooltip or hint in the SharePoint list UI.
display_namestringoptionalNew display name for the column as shown in the SharePoint list UI.
hiddenbooleanoptionalWhether the column should be hidden from the default list view. Set to true to hide or false to show.
read_onlybooleanoptionalWhether the column should be read-only. Set to true to prevent users from editing the column value.
microsoft365_sharepoint_update_list_item#Update the field values of an existing SharePoint list item. PATCH the /fields subpath with a flat object of column name-value pairs. Only the fields provided are updated; omitted fields remain unchanged.4 params

Update the field values of an existing SharePoint list item. PATCH the /fields subpath with a flat object of column name-value pairs. Only the fields provided are updated; omitted fields remain unchanged.

NameTypeRequiredDescription
fieldsobjectrequiredObject containing the field values to update. Keys are internal column names. Only provided fields are changed. Example: {"Title": "Updated Title", "Status": "Done"}.
item_idstringrequiredID of the list item to update. This is the numeric or string identifier of the item within the list.
list_idstringrequiredID of the SharePoint list that contains the item. Use the list GUID or display name.
site_idstringrequiredID of the SharePoint site that contains the list. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
microsoft365_sharepoint_update_site#Update the display name or description of an existing SharePoint site. Provide the site ID and at least one of display_name or description to update.3 params

Update the display name or description of an existing SharePoint site. Provide the site ID and at least one of display_name or description to update.

NameTypeRequiredDescription
site_idstringrequiredID of the SharePoint site to update. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
descriptionstringoptionalNew description for the SharePoint site. Example: 'Official site for the Marketing department.'
display_namestringoptionalNew display name for the SharePoint site. Example: 'Marketing Hub 2024'.
microsoft365_sharepoint_upload_file#Create an upload session for uploading a file to a SharePoint document library. Returns an upload URL that the caller uses to upload the file content in subsequent PUT requests. This session-based approach supports files of any size. Required: site_id, parent_id (use 'root' for the library root folder), and filename.4 params

Create an upload session for uploading a file to a SharePoint document library. Returns an upload URL that the caller uses to upload the file content in subsequent PUT requests. This session-based approach supports files of any size. Required: site_id, parent_id (use 'root' for the library root folder), and filename.

NameTypeRequiredDescription
filenamestringrequiredName of the file to upload including its extension. Example: 'report-Q4.xlsx'. This will be the filename in SharePoint.
parent_idstringrequiredDrive item ID of the parent folder in the SharePoint document library where the file will be uploaded. Use 'root' to upload to the library root folder, or a folder item ID from a list drive items operation.
site_idstringrequiredID of the SharePoint site that contains the document library. Use a site GUID, 'root', or the format '<hostname>:/sites/<path>'.
conflict_behaviorstringoptionalBehavior when a file with the same name already exists at the destination. 'fail' returns an error, 'replace' overwrites the existing file, 'rename' creates a new file with an incremented name.
microsoft365_teams_add_team_member#Add a user to a Microsoft Teams team as a member or owner. Requires the team ID and the Azure AD user ID of the person to add. The user must exist in the same tenant. Returns the new conversationMember resource on success (HTTP 201).3 params

Add a user to a Microsoft Teams team as a member or owner. Requires the team ID and the Azure AD user ID of the person to add. The user must exist in the same tenant. Returns the new conversationMember resource on success (HTTP 201).

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team to add the member to.
user_idstringrequiredThe Azure AD object ID of the user to add to the team. This is the user's unique identifier in Microsoft Entra ID, not their email address.
rolestringoptionalThe role to assign to the added user. Valid values: 'member' (standard member) or 'owner' (team owner with admin privileges). Defaults to 'member'.
microsoft365_teams_approve_time_off_request#Approve a pending time-off request in a Microsoft Teams team schedule. Requires the team ID and request ID. Optionally include a manager note to send with the approval. Returns HTTP 204 No Content on success.3 params

Approve a pending time-off request in a Microsoft Teams team schedule. Requires the team ID and request ID. Optionally include a manager note to send with the approval. Returns HTTP 204 No Content on success.

NameTypeRequiredDescription
request_idstringrequiredThe unique identifier of the time-off request to approve. Obtain from the list time-off requests API.
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule contains the time-off request.
messagestringoptionalOptional message from the manager to include with the approval decision. Example: 'Approved, enjoy your vacation!'
microsoft365_teams_archive_channel#Archive a channel in a Microsoft Teams team, making it read-only for members. Archiving is reversible — the channel can be unarchived later. Optionally sets the associated SharePoint site to read-only.3 params

Archive a channel in a Microsoft Teams team, making it read-only for members. Archiving is reversible — the channel can be unarchived later. Optionally sets the associated SharePoint site to read-only.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel to archive.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel to archive.
set_spo_site_readonlybooleanoptionalIf true, the SharePoint Online (SPO) site associated with the channel will also be set to read-only when the channel is archived. Defaults to false.
microsoft365_teams_archive_team#Archive a Microsoft Teams team, making it read-only. The team is archived asynchronously (HTTP 202). Optionally set the SharePoint site associated with the team to read-only as well. To restore a team, use the unarchive endpoint.2 params

Archive a Microsoft Teams team, making it read-only. The team is archived asynchronously (HTTP 202). Optionally set the SharePoint site associated with the team to read-only as well. To restore a team, use the unarchive endpoint.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team to archive.
should_set_spo_site_read_only_for_membersbooleanoptionalIf true, sets the SharePoint Online site associated with the team to read-only for members. Defaults to false.
microsoft365_teams_clear_user_presence#Clear a previously set presence override for the signed-in user in Microsoft Teams for a specific application session. Provide the same session ID used when calling setPresence. After clearing, Teams reverts to the user's actual computed presence. Requires the Presence.ReadWrite scope.1 param

Clear a previously set presence override for the signed-in user in Microsoft Teams for a specific application session. Provide the same session ID used when calling setPresence. After clearing, Teams reverts to the user's actual computed presence. Requires the Presence.ReadWrite scope.

NameTypeRequiredDescription
session_idstringrequiredThe GUID of the application session whose presence override should be cleared. Must match the session ID passed to the setPresence call. Example: '22553876-f5ab-4529-bffb-cfe50aa89f87'.
microsoft365_teams_clone_team#Clone an existing Microsoft Teams team into a new team, copying selected parts such as apps, tabs, settings, channels, and/or members. The clone operation is asynchronous (HTTP 202). Required: team_id, display_name, parts_to_clone.7 params

Clone an existing Microsoft Teams team into a new team, copying selected parts such as apps, tabs, settings, channels, and/or members. The clone operation is asynchronous (HTTP 202). Required: team_id, display_name, parts_to_clone.

NameTypeRequiredDescription
display_namestringrequiredThe display name for the new cloned team.
parts_to_clonestringrequiredComma-separated list of team parts to clone. Valid parts: apps, tabs, settings, channels, members. Example: 'apps,tabs,settings,channels,members'.
team_idstringrequiredThe unique identifier of the Microsoft Teams team to clone.
classificationstringoptionalClassification label for the cloned team (organization-defined, e.g., 'Confidential', 'Internal'). Optional.
descriptionstringoptionalOptional description for the cloned team.
mail_nicknamestringoptionalThe mail alias (nickname) for the new team's Microsoft 365 Group. Must be unique in the tenant and contain only alphanumeric characters and hyphens.
visibilitystringoptionalVisibility of the cloned team. Valid values: 'public' (anyone in org can join), 'private' (owner must invite). Defaults to 'private'.
microsoft365_teams_create_channel#Create a new channel in a Microsoft Teams team. Supports standard, private, and shared channel membership types. Requires the team ID and a display name for the new channel.4 params

Create a new channel in a Microsoft Teams team. Supports standard, private, and shared channel membership types. Requires the team ID and a display name for the new channel.

NameTypeRequiredDescription
display_namestringrequiredThe display name of the new channel. Must be unique within the team and cannot contain special characters like #, &, :, <, >, *, ?.
team_idstringrequiredThe unique identifier of the Microsoft Teams team in which to create the channel.
descriptionstringoptionalOptional description for the new channel (plain text, up to 1024 characters).
membership_typestringoptionalThe membership type of the channel: 'standard' (visible to all team members), 'private' (invite-only subset of team members), or 'shared' (shared with people outside the team). Defaults to 'standard'.
microsoft365_teams_create_online_meeting#Create a new Microsoft Teams online meeting for the signed-in user. Requires a subject, start time, and end time in ISO 8601 format. Optionally invite attendees by UPN (email) and control who can present.5 params

Create a new Microsoft Teams online meeting for the signed-in user. Requires a subject, start time, and end time in ISO 8601 format. Optionally invite attendees by UPN (email) and control who can present.

NameTypeRequiredDescription
end_date_timestringrequiredThe end date and time of the meeting in ISO 8601 UTC format. Example: '2024-07-15T10:00:00Z'.
start_date_timestringrequiredThe start date and time of the meeting in ISO 8601 UTC format. Example: '2024-07-15T09:00:00Z'.
subjectstringrequiredThe subject/title of the online meeting. Displayed to all participants in the meeting invite and join page.
allowed_presentersstringoptionalWho can present in the meeting. 'everyone' allows all participants, 'organization' restricts to org members, 'roleIsPresenter' limits to assigned presenters, 'organizer' restricts to the meeting organizer only. Defaults to 'organization'.
attendee_upnsarrayoptionalArray of UPN (User Principal Name / email address) strings for meeting attendees. Example: ["alice@contoso.com", "bob@contoso.com"]. Each UPN is mapped to an attendee object in the participants block.
microsoft365_teams_create_shift#Create a new shift in a Microsoft Teams team schedule. Requires team ID, user ID, scheduling group ID, and start/end date times in ISO 8601 format. Optionally set a display name, notes, and theme color for the shift.8 params

Create a new shift in a Microsoft Teams team schedule. Requires team ID, user ID, scheduling group ID, and start/end date times in ISO 8601 format. Optionally set a display name, notes, and theme color for the shift.

NameTypeRequiredDescription
end_date_timestringrequiredThe end date and time of the shift in ISO 8601 UTC format. Example: '2024-07-15T17:00:00Z'.
scheduling_group_idstringrequiredThe unique identifier of the scheduling group (team member group) to assign the shift to. Obtain from the scheduling groups API.
start_date_timestringrequiredThe start date and time of the shift in ISO 8601 UTC format. Example: '2024-07-15T09:00:00Z'.
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule to create the shift in.
user_idstringrequiredThe unique identifier (object ID) of the user to assign the shift to. Obtain from the Microsoft Entra user object or list users API.
display_namestringoptionalOptional display name for the shift, shown on the schedule. Example: 'Morning Shift'.
notesstringoptionalOptional notes or instructions for the shift, visible to the assigned user. Example: 'Please cover the front desk.'.
themestringoptionalColor theme for the shift block on the schedule view. Valid values: white, blue, green, purple, pink, yellow, gray, darkBlue, darkGreen, darkPurple, darkPink, darkYellow. Defaults to 'blue'.
microsoft365_teams_create_shift_swap_request#Create a shift swap request in a Microsoft Teams team schedule, proposing that two employees exchange their shifts. Requires the team ID, both employees' user IDs and their respective shift IDs. Optionally include a message from the requester.6 params

Create a shift swap request in a Microsoft Teams team schedule, proposing that two employees exchange their shifts. Requires the team ID, both employees' user IDs and their respective shift IDs. Optionally include a message from the requester.

NameTypeRequiredDescription
recipient_shift_idstringrequiredThe unique identifier of the shift belonging to the recipient (the employee whose shift the sender wants to take). Obtain from the list shifts API.
recipient_user_idstringrequiredThe Azure AD object ID of the employee being asked to swap their shift.
sender_shift_idstringrequiredThe unique identifier of the shift belonging to the sender (the employee initiating the swap). Obtain from the list shifts API.
sender_user_idstringrequiredThe Azure AD object ID of the employee initiating the shift swap request.
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule the shift swap request belongs to.
sender_messagestringoptionalOptional message from the requesting employee explaining why they want to swap. Example: 'I have a doctor's appointment during my shift.'
microsoft365_teams_create_team#Create a new Microsoft Teams team from a template. The team is created asynchronously (HTTP 202); poll the returned operation URL for completion. Required: display_name. Optional: description and template (defaults to 'standard').3 params

Create a new Microsoft Teams team from a template. The team is created asynchronously (HTTP 202); poll the returned operation URL for completion. Required: display_name. Optional: description and template (defaults to 'standard').

NameTypeRequiredDescription
display_namestringrequiredThe display name of the new team. Must be unique within the tenant.
descriptionstringoptionalOptional description for the new team (plain text, up to 1024 characters).
templatestringoptionalThe Teams template to use when creating the team. Valid values: 'standard', 'educationClass', 'educationStaff', 'educationProfessionalLearningCommunity', 'healthcareWard', 'healthcareTeam'. Defaults to 'standard'.
microsoft365_teams_create_time_off_request#Submit a time-off request in a Microsoft Teams team schedule. Requires the team ID, the sender's user ID, start and end date-times in ISO 8601 UTC format, and the time-off reason ID. Optionally include a message from the sender to the manager.6 params

Submit a time-off request in a Microsoft Teams team schedule. Requires the team ID, the sender's user ID, start and end date-times in ISO 8601 UTC format, and the time-off reason ID. Optionally include a message from the sender to the manager.

NameTypeRequiredDescription
end_date_timestringrequiredThe end date and time of the time-off period in ISO 8601 UTC format. Example: '2024-08-02T17:00:00Z'.
sender_user_idstringrequiredThe Azure AD object ID of the employee submitting the time-off request. Obtain from the Microsoft Entra user object or list users API.
start_date_timestringrequiredThe start date and time of the time-off period in ISO 8601 UTC format. Example: '2024-07-29T00:00:00Z'.
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule the request belongs to.
time_off_reason_idstringrequiredThe ID of the time-off reason (e.g., vacation, sick leave) defined in the team schedule. Obtain from the team's timeOffReasons API.
sender_messagestringoptionalOptional message from the employee to the manager accompanying the time-off request. Example: 'Family vacation.'
microsoft365_teams_decline_time_off_request#Decline a pending time-off request in a Microsoft Teams team schedule. Requires the team ID and request ID. Optionally include a manager message explaining the decision. Returns HTTP 204 No Content on success.3 params

Decline a pending time-off request in a Microsoft Teams team schedule. Requires the team ID and request ID. Optionally include a manager message explaining the decision. Returns HTTP 204 No Content on success.

NameTypeRequiredDescription
request_idstringrequiredThe unique identifier of the time-off request to decline. Obtain from the list time-off requests API.
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule contains the time-off request.
messagestringoptionalOptional message from the manager to include with the decline decision. Example: 'Insufficient coverage during that period.'
microsoft365_teams_delete_channel#Permanently delete a channel from a Microsoft Teams team. The General channel of a team cannot be deleted. This action is irreversible and removes all messages and content within the channel.2 params

Permanently delete a channel from a Microsoft Teams team. The General channel of a team cannot be deleted. This action is irreversible and removes all messages and content within the channel.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel to delete. The General channel cannot be deleted.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel to delete.
microsoft365_teams_delete_channel_message#Soft-delete a Microsoft Teams channel message. The message is retracted and replaced with a tombstone indicating it was deleted.3 params

Soft-delete a Microsoft Teams channel message. The message is retracted and replaced with a tombstone indicating it was deleted.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel containing the message to delete.
message_idstringrequiredThe unique identifier of the channel message to soft-delete.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
microsoft365_teams_delete_online_meeting#Permanently delete a Microsoft Teams online meeting by meeting ID. This action cannot be undone and removes the meeting for all participants.1 param

Permanently delete a Microsoft Teams online meeting by meeting ID. This action cannot be undone and removes the meeting for all participants.

NameTypeRequiredDescription
meeting_idstringrequiredThe unique identifier of the online meeting to delete. Obtain from the create meeting response or list meetings API.
microsoft365_teams_delete_shift#Permanently delete a shift from a Microsoft Teams team schedule. Requires both the team ID and the shift ID. This action cannot be undone.2 params

Permanently delete a shift from a Microsoft Teams team schedule. Requires both the team ID and the shift ID. This action cannot be undone.

NameTypeRequiredDescription
shift_idstringrequiredThe unique identifier of the shift to delete. Obtain from the create shift response or list shifts API.
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule contains the shift to delete.
microsoft365_teams_delete_team#Permanently delete a Microsoft Teams team by deleting the underlying Microsoft 365 Group. This action is irreversible. The team and all its channels, messages, and files will be permanently removed. Returns HTTP 204 with no body on success.1 param

Permanently delete a Microsoft Teams team by deleting the underlying Microsoft 365 Group. This action is irreversible. The team and all its channels, messages, and files will be permanently removed. Returns HTTP 204 with no body on success.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team (Group ID) to permanently delete.
microsoft365_teams_get_channel#Retrieve the properties and metadata of a specific channel in a Microsoft Teams team, including its display name, description, membership type, and web URL.2 params

Retrieve the properties and metadata of a specific channel in a Microsoft Teams team, including its display name, description, membership type, and web URL.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel to retrieve.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
microsoft365_teams_get_channel_message#Retrieve a single message from a Microsoft Teams channel by its ID, including body content, sender info, attachments, reactions, and metadata.3 params

Retrieve a single message from a Microsoft Teams channel by its ID, including body content, sender info, attachments, reactions, and metadata.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel containing the message.
message_idstringrequiredThe unique identifier of the Teams channel message to retrieve.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
microsoft365_teams_get_chat_message#Retrieve a single message from a Microsoft Teams chat by its ID, including body content, sender info, attachments, reactions, and metadata.2 params

Retrieve a single message from a Microsoft Teams chat by its ID, including body content, sender info, attachments, reactions, and metadata.

NameTypeRequiredDescription
chat_idstringrequiredThe unique identifier of the Teams chat that contains the message.
message_idstringrequiredThe unique identifier of the Teams chat message to retrieve.
microsoft365_teams_get_online_meeting#Retrieve details of a specific Microsoft Teams online meeting by meeting ID. Returns meeting properties including subject, join URL, start/end times, participants, and meeting options.1 param

Retrieve details of a specific Microsoft Teams online meeting by meeting ID. Returns meeting properties including subject, join URL, start/end times, participants, and meeting options.

NameTypeRequiredDescription
meeting_idstringrequiredThe unique identifier of the online meeting to retrieve. Obtain from the create meeting response or list meetings API.
microsoft365_teams_get_team#Retrieve the properties and relationships of a Microsoft Teams team by its team ID. Returns team details including display name, description, visibility, member settings, and guest settings.1 param

Retrieve the properties and relationships of a Microsoft Teams team by its team ID. Returns team details including display name, description, visibility, member settings, and guest settings.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team to retrieve.
microsoft365_teams_list_channel_message_replies#List all replies in a Microsoft Teams channel message thread. Returns replies to the specified parent message with support for pagination.5 params

List all replies in a Microsoft Teams channel message thread. Returns replies to the specified parent message with support for pagination.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel containing the message thread.
message_idstringrequiredThe unique identifier of the parent channel message whose replies to list.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
$skipintegeroptionalNumber of replies to skip for pagination. Use with $top to page through results.
$topintegeroptionalMaximum number of replies to return per page. Use to control page size.
microsoft365_teams_list_channel_messages#List messages in a Microsoft Teams channel with support for pagination. Returns up to 20 messages by default (max 50 per page).4 params

List messages in a Microsoft Teams channel with support for pagination. Returns up to 20 messages by default (max 50 per page).

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel to list messages from.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
$skipintegeroptionalNumber of messages to skip for pagination. Use with $top to page through results.
$topintegeroptionalNumber of channel messages to return per page (1–50, default: 20). Microsoft Graph caps this at 50 for channel messages.
microsoft365_teams_list_channel_tabs#List all tabs pinned to a Microsoft Teams channel. By default expands the teamsApp relationship to include app details for each tab.3 params

List all tabs pinned to a Microsoft Teams channel. By default expands the teamsApp relationship to include app details for each tab.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel whose tabs to list.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
$expandstringoptionalOData $expand expression to include related resources. Defaults to 'teamsApp' which includes the app details for each tab. Set to null to suppress expansion.
microsoft365_teams_list_channels#List all channels in a Microsoft Teams team. Supports OData filtering (e.g., by membershipType) and field selection to reduce response size.3 params

List all channels in a Microsoft Teams team. Supports OData filtering (e.g., by membershipType) and field selection to reduce response size.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose channels to list.
$filterstringoptionalOData filter expression to narrow results. Example: "membershipType eq 'standard'" or "displayName eq 'General'".
$selectstringoptionalComma-separated list of channel properties to return. Example: 'id,displayName,membershipType,webUrl'. Reduces response payload size.
microsoft365_teams_list_chat_messages#List messages in a Microsoft Teams chat (1:1, group, or meeting chat) with support for pagination and ordering. Returns up to 50 messages per page ordered by creation time descending by default.3 params

List messages in a Microsoft Teams chat (1:1, group, or meeting chat) with support for pagination and ordering. Returns up to 50 messages per page ordered by creation time descending by default.

NameTypeRequiredDescription
chat_idstringrequiredThe unique identifier of the Teams chat to list messages from. Obtain from the list chats API or Teams URL.
$orderbystringoptionalOData orderby expression for sorting messages. Default is 'createdDateTime desc' (newest first). Example: 'createdDateTime asc' for oldest first.
$topintegeroptionalNumber of chat messages to return per page (1–50, default: 50). Microsoft Graph caps this at 50 for chat messages.
microsoft365_teams_list_shift_swap_requests#List shift swap change requests in a Microsoft Teams team schedule. Supports OData $filter (e.g., filter by state) and $top to control the number of results returned.3 params

List shift swap change requests in a Microsoft Teams team schedule. Supports OData $filter (e.g., filter by state) and $top to control the number of results returned.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule shift swap requests to list.
$filterstringoptionalOData filter expression to narrow shift swap request results. Example: "state eq 'pending'" to fetch only pending swap requests.
$topintegeroptionalMaximum number of shift swap requests to return. Use to limit the response size. Example: 25.
microsoft365_teams_list_shifts#List shifts in a Microsoft Teams team schedule. Supports OData $filter (e.g., filter by start date) and $top to control the number of results returned.3 params

List shifts in a Microsoft Teams team schedule. Supports OData $filter (e.g., filter by start date) and $top to control the number of results returned.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule shifts to list.
$filterstringoptionalOData filter expression to narrow shift results. Example: "sharedShift/startDateTime ge 2024-07-01T00:00:00Z" to fetch shifts starting on or after July 1, 2024.
$topintegeroptionalMaximum number of shifts to return. Use to limit the response size. Example: 25.
microsoft365_teams_list_team_members#List all members (including owners) of a Microsoft Teams team. Returns conversationMember resources with membership IDs, user details, and roles. Supports OData filtering and field selection.4 params

List all members (including owners) of a Microsoft Teams team. Returns conversationMember resources with membership IDs, user details, and roles. Supports OData filtering and field selection.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose members to list.
$filterstringoptionalOData filter expression to narrow results. Example: "roles/any(r:r eq 'owner')" to list only owners.
$selectstringoptionalComma-separated list of member properties to return. Example: 'id,displayName,roles,email'. Reduces response payload size.
$topintegeroptionalMaximum number of members to return per page. Use for pagination.
microsoft365_teams_list_teams#List all Microsoft Teams teams that the signed-in user has joined. Supports OData query options for filtering, field selection, and pagination.3 params

List all Microsoft Teams teams that the signed-in user has joined. Supports OData query options for filtering, field selection, and pagination.

NameTypeRequiredDescription
$filterstringoptionalOData filter expression to narrow results. Example: "displayName eq 'Engineering'".
$selectstringoptionalComma-separated list of team properties to return. Example: 'id,displayName,description,visibility'. Reduces response payload size.
$topintegeroptionalMaximum number of teams to return per page. Use for pagination.
microsoft365_teams_list_time_off_requests#List time-off requests in a Microsoft Teams team schedule. Supports OData $filter (e.g., filter by status or date range) and $top to control the number of results returned.3 params

List time-off requests in a Microsoft Teams team schedule. Supports OData $filter (e.g., filter by status or date range) and $top to control the number of results returned.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule time-off requests to list.
$filterstringoptionalOData filter expression to narrow time-off request results. Example: "state eq 'pending'" to fetch only pending requests.
$topintegeroptionalMaximum number of time-off requests to return. Use to limit the response size. Example: 25.
microsoft365_teams_pin_channel_message#Pin a message in a Microsoft Teams channel so it appears in the channel's pinned messages list. Requires the team ID, channel ID, and message ID.3 params

Pin a message in a Microsoft Teams channel so it appears in the channel's pinned messages list. Requires the team ID, channel ID, and message ID.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel that contains the message to pin.
message_idstringrequiredThe unique identifier of the Teams channel message to pin.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
microsoft365_teams_provision_channel_email#Provision an email address for a Microsoft Teams channel, enabling users to send emails directly to the channel. Returns the provisioned email address. If an email has already been provisioned, returns the existing address.2 params

Provision an email address for a Microsoft Teams channel, enabling users to send emails directly to the channel. Returns the provisioned email address. If an email has already been provisioned, returns the existing address.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel for which to provision an email address.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
microsoft365_teams_remove_channel_email#Remove the email address provisioned for a Microsoft Teams channel. After removal, emails can no longer be sent to the channel via that email address.2 params

Remove the email address provisioned for a Microsoft Teams channel. After removal, emails can no longer be sent to the channel via that email address.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel from which to remove the provisioned email address.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
microsoft365_teams_remove_team_member#Remove a member from a Microsoft Teams team. Requires the team ID and the conversationMember ID (not the Azure AD user ID). The membership_id is the ID returned by the list team members or add team member APIs. Returns HTTP 204 with no body on success.2 params

Remove a member from a Microsoft Teams team. Requires the team ID and the conversationMember ID (not the Azure AD user ID). The membership_id is the ID returned by the list team members or add team member APIs. Returns HTTP 204 with no body on success.

NameTypeRequiredDescription
membership_idstringrequiredThe conversationMember ID of the membership to remove. This is the unique ID of the member's team membership, returned by the list team members or add member APIs — it is NOT the Azure AD user ID.
team_idstringrequiredThe unique identifier of the Microsoft Teams team from which to remove the member.
microsoft365_teams_reply_to_channel_message#Post a reply to an existing Microsoft Teams channel message thread. Supports plain text or HTML content, an optional subject, and importance levels.7 params

Post a reply to an existing Microsoft Teams channel message thread. Supports plain text or HTML content, an optional subject, and importance levels.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel containing the message to reply to.
contentstringrequiredThe text or HTML content of the reply message.
message_idstringrequiredThe unique identifier of the channel message to reply to.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
content_typestringoptionalThe format of the reply content: 'text' for plain text or 'html' for HTML markup. Defaults to 'text'.
importancestringoptionalThe importance of the reply message. Valid values: 'normal', 'high', 'urgent'.
subjectstringoptionalOptional subject line for the reply (appears as a headline above the body).
microsoft365_teams_reply_to_chat_message#Send a reply to an existing message in a Microsoft Teams chat thread. Supports plain text or HTML content. This endpoint is available on the Microsoft Graph beta API.4 params

Send a reply to an existing message in a Microsoft Teams chat thread. Supports plain text or HTML content. This endpoint is available on the Microsoft Graph beta API.

NameTypeRequiredDescription
chat_idstringrequiredThe unique identifier of the Teams chat that contains the message to reply to.
contentstringrequiredThe text or HTML content of the reply message.
message_idstringrequiredThe unique identifier of the Teams chat message to reply to.
content_typestringoptionalThe format of the reply content: 'text' for plain text or 'html' for HTML markup. Defaults to 'text'.
microsoft365_teams_search_messages#Search Microsoft Teams chat messages across all chats and channels accessible to the signed-in user using the Microsoft Search API. Supports pagination via from/size parameters. Returns up to 25 results by default.3 params

Search Microsoft Teams chat messages across all chats and channels accessible to the signed-in user using the Microsoft Search API. Supports pagination via from/size parameters. Returns up to 25 results by default.

NameTypeRequiredDescription
querystringrequiredThe search query string to find matching Teams messages. Supports keyword search and KQL (Keyword Query Language). Example: 'project kickoff' or 'from:alice@example.com subject:budget'.
fromintegeroptionalZero-based index of the first result to return, used for pagination. Default is 0 (start from the first result).
sizeintegeroptionalNumber of results to return per page. Default is 25, maximum is 200.
microsoft365_teams_send_channel_message#Send a new message to a Microsoft Teams channel. Supports plain text or HTML content, an optional subject line, and importance levels (normal, high, urgent).6 params

Send a new message to a Microsoft Teams channel. Supports plain text or HTML content, an optional subject line, and importance levels (normal, high, urgent).

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel to send the message to.
contentstringrequiredThe text or HTML content of the message to send.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
content_typestringoptionalThe format of the message content: 'text' for plain text or 'html' for HTML markup. Defaults to 'text'.
importancestringoptionalThe importance of the message. Valid values: 'normal', 'high', 'urgent'. Defaults to normal if omitted.
subjectstringoptionalOptional subject line for the channel message (appears as a headline above the body).
microsoft365_teams_send_chat_message#Send a new message to a Microsoft Teams chat (1:1, group, or meeting chat). Supports plain text or HTML content. Requires Chat.ReadWrite scope.3 params

Send a new message to a Microsoft Teams chat (1:1, group, or meeting chat). Supports plain text or HTML content. Requires Chat.ReadWrite scope.

NameTypeRequiredDescription
chat_idstringrequiredThe unique identifier of the Teams chat to send the message to. Obtain from the list chats API or Teams client URL.
contentstringrequiredThe text or HTML content of the message to send to the chat.
content_typestringoptionalThe format of the message content: 'text' for plain text or 'html' for HTML markup. Defaults to 'text'.
microsoft365_teams_set_preferred_presence#Set the preferred presence status for the signed-in user in Microsoft Teams. Unlike setPresence (which is session-scoped), this persists a user-level preferred status that overrides the computed presence. Requires availability and activity values. Optionally specify an expiration duration in ISO 8601 format (e.g., PT1H). Requires the Presence.ReadWrite scope.3 params

Set the preferred presence status for the signed-in user in Microsoft Teams. Unlike setPresence (which is session-scoped), this persists a user-level preferred status that overrides the computed presence. Requires availability and activity values. Optionally specify an expiration duration in ISO 8601 format (e.g., PT1H). Requires the Presence.ReadWrite scope.

NameTypeRequiredDescription
activitystringrequiredThe preferred activity of the user. Must be consistent with the chosen availability. Valid values: Available, Busy, InACall, InAConferenceCall, InAMeeting, Presenting, Away, DoNotDisturb, UrgentInterruptionsOnly, OffWork.
availabilitystringrequiredThe preferred presence state of the user at the user level (not session-scoped). Valid values: Available, Busy, DoNotDisturb, BeRightBack, Away, Offline.
expiration_durationstringoptionalHow long the preferred presence override should remain active, expressed as an ISO 8601 duration. Example: 'PT1H' for 1 hour, 'PT4H' for 4 hours. If omitted, the preference persists until explicitly cleared via clearUserPreferredPresence.
microsoft365_teams_set_user_presence#Set the presence status of the signed-in user in Microsoft Teams for a specific application session. Requires a session ID (a stable GUID representing the calling app), an availability value (e.g., Available, Busy, DoNotDisturb), and an activity value. Optionally specify an expiration duration in ISO 8601 duration format (e.g., PT1H). Requires the Presence.ReadWrite scope.4 params

Set the presence status of the signed-in user in Microsoft Teams for a specific application session. Requires a session ID (a stable GUID representing the calling app), an availability value (e.g., Available, Busy, DoNotDisturb), and an activity value. Optionally specify an expiration duration in ISO 8601 duration format (e.g., PT1H). Requires the Presence.ReadWrite scope.

NameTypeRequiredDescription
activitystringrequiredThe current activity of the user. Must be consistent with the chosen availability. Valid values: Available, Busy, InACall, InAConferenceCall, InAMeeting, Presenting, Away, DoNotDisturb, UrgentInterruptionsOnly, OffWork.
availabilitystringrequiredThe base presence state of the user. Valid values: Available, Busy, DoNotDisturb, BeRightBack, Away, Offline.
session_idstringrequiredA stable GUID identifying the calling application session. Use a consistent GUID per application so multiple calls from the same app update the same session. Example: '22553876-f5ab-4529-bffb-cfe50aa89f87'.
expiration_durationstringoptionalHow long the presence override should remain active, expressed as an ISO 8601 duration. Example: 'PT1H' for 1 hour, 'PT30M' for 30 minutes. If omitted, the presence persists until explicitly cleared.
microsoft365_teams_unpin_channel_message#Unpin a previously pinned message in a Microsoft Teams channel. The message remains in the channel history but is removed from the pinned messages list.3 params

Unpin a previously pinned message in a Microsoft Teams channel. The message remains in the channel history but is removed from the pinned messages list.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel that contains the pinned message.
message_idstringrequiredThe unique identifier of the Teams channel message to unpin.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
microsoft365_teams_update_channel#Update the properties of an existing Microsoft Teams channel, such as its display name or description. At least one of display_name or description must be provided.4 params

Update the properties of an existing Microsoft Teams channel, such as its display name or description. At least one of display_name or description must be provided.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel to update.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel to update.
descriptionstringoptionalNew description for the channel. Optional. At least one of display_name or description must be provided.
display_namestringoptionalNew display name for the channel. Cannot contain special characters like #, &, :, <, >, *, ?. At least one of display_name or description must be provided.
microsoft365_teams_update_channel_message#Update the body content of an existing Microsoft Teams channel message. Only the message body can be edited after posting.5 params

Update the body content of an existing Microsoft Teams channel message. Only the message body can be edited after posting.

NameTypeRequiredDescription
channel_idstringrequiredThe unique identifier of the Teams channel containing the message to update.
contentstringrequiredThe new text or HTML content to replace the existing message body with.
message_idstringrequiredThe unique identifier of the channel message to update.
team_idstringrequiredThe unique identifier of the Microsoft Teams team that contains the channel.
content_typestringoptionalThe format of the updated content: 'text' for plain text or 'html' for HTML markup. Defaults to 'text'.
microsoft365_teams_update_online_meeting#Update an existing Microsoft Teams online meeting by meeting ID. Any combination of subject, start time, end time, and allowed presenters can be updated in a single call.5 params

Update an existing Microsoft Teams online meeting by meeting ID. Any combination of subject, start time, end time, and allowed presenters can be updated in a single call.

NameTypeRequiredDescription
meeting_idstringrequiredThe unique identifier of the online meeting to update. Obtain from the ID field returned when creating or listing meetings.
allowed_presentersstringoptionalUpdated setting for who can present in the meeting. Valid values: 'everyone', 'organization', 'roleIsPresenter', 'organizer'.
end_date_timestringoptionalUpdated end date and time for the meeting in ISO 8601 UTC format. Example: '2024-07-15T11:00:00Z'. Leave blank to keep the existing end time.
start_date_timestringoptionalUpdated start date and time for the meeting in ISO 8601 UTC format. Example: '2024-07-15T10:00:00Z'. Leave blank to keep the existing start time.
subjectstringoptionalUpdated subject/title for the online meeting. Leave blank to keep the existing subject.
microsoft365_teams_update_shift#Update an existing shift in a Microsoft Teams team schedule by shift ID. Replaces the shift with the provided fields. Requires team ID and shift ID. The sharedShift block fields (start/end time, display name, notes, theme) are built conditionally from optional inputs.9 params

Update an existing shift in a Microsoft Teams team schedule by shift ID. Replaces the shift with the provided fields. Requires team ID and shift ID. The sharedShift block fields (start/end time, display name, notes, theme) are built conditionally from optional inputs.

NameTypeRequiredDescription
shift_idstringrequiredThe unique identifier of the shift to update. Obtain from the create shift response or list shifts API.
team_idstringrequiredThe unique identifier of the Microsoft Teams team whose schedule contains the shift.
display_namestringoptionalUpdated display name for the shift shown on the schedule. Leave blank to keep the existing display name.
end_date_timestringoptionalUpdated end date and time for the shift in ISO 8601 UTC format. Example: '2024-07-15T18:00:00Z'. Leave blank to keep the existing end time.
notesstringoptionalUpdated notes for the shift visible to the assigned employee. Leave blank to keep the existing notes.
scheduling_group_idstringoptionalUpdated scheduling group ID for the shift. Leave blank to keep the existing scheduling group.
start_date_timestringoptionalUpdated start date and time for the shift in ISO 8601 UTC format. Example: '2024-07-15T10:00:00Z'. Leave blank to keep the existing start time.
themestringoptionalUpdated color theme for the shift block on the schedule view. Valid values: white, blue, green, purple, pink, yellow, gray, darkBlue, darkGreen, darkPurple, darkPink, darkYellow.
user_idstringoptionalUpdated user ID (Azure AD object ID) to reassign the shift to. Leave blank to keep the existing assignment.
microsoft365_teams_update_team#Update the properties of an existing Microsoft Teams team. Requires team_id. At least one of display_name, description, or visibility must be provided. Returns HTTP 204 with no body on success.4 params

Update the properties of an existing Microsoft Teams team. Requires team_id. At least one of display_name, description, or visibility must be provided. Returns HTTP 204 with no body on success.

NameTypeRequiredDescription
team_idstringrequiredThe unique identifier of the Microsoft Teams team to update.
descriptionstringoptionalNew description for the team (plain text, up to 1024 characters).
display_namestringoptionalNew display name for the team.
visibilitystringoptionalVisibility of the team. Valid values: 'public' (anyone in org can join), 'private' (owner must invite). Note: changing from private to public is allowed; changing back may be restricted.
microsoft365_teams_update_team_member#Update the role of an existing member in a Microsoft Teams team, promoting them to owner or demoting them to member. Requires the team ID, the conversationMember ID (membership_id), and the new role. Returns the updated conversationMember resource (HTTP 200).3 params

Update the role of an existing member in a Microsoft Teams team, promoting them to owner or demoting them to member. Requires the team ID, the conversationMember ID (membership_id), and the new role. Returns the updated conversationMember resource (HTTP 200).

NameTypeRequiredDescription
membership_idstringrequiredThe conversationMember ID of the membership to update. This is the unique ID of the member's team membership returned by the list team members or add member APIs — it is NOT the Azure AD user ID.
rolestringrequiredThe new role to assign to the team member. Valid values: 'member' (standard member) or 'owner' (team owner with admin privileges).
team_idstringrequiredThe unique identifier of the Microsoft Teams team containing the member to update.
microsoft365_word_create_document#Create a new Word document (.docx) in OneDrive by initiating a resumable upload session. Returns an uploadUrl that the caller must use to upload the .docx file bytes via one or more PUT requests. The document is placed under the specified parent folder with the given filename. Requires Files.ReadWrite or Files.ReadWrite.All scope.3 params

Create a new Word document (.docx) in OneDrive by initiating a resumable upload session. Returns an uploadUrl that the caller must use to upload the .docx file bytes via one or more PUT requests. The document is placed under the specified parent folder with the given filename. Requires Files.ReadWrite or Files.ReadWrite.All scope.

NameTypeRequiredDescription
filenamestringrequiredThe base name of the Word document to create, without the .docx extension. The extension is appended automatically. Example: "Project Proposal" creates "Project Proposal.docx".
parent_idstringrequiredThe OneDrive item ID of the parent folder where the document will be created. Use "root" to create the document at the top level of OneDrive. Obtain folder IDs from list or get drive item operations.
conflict_behaviorstringoptionalBehavior when a file with the same name already exists in the target folder. "fail" aborts and returns an error, "replace" overwrites the existing file, "rename" saves the new document with a different auto-generated name. Default: replace.
microsoft365_outlook_create_shared_calendar_event#Create a calendar event on another user's calendar (shared or delegated access). Targets POST /users/{id}/events. Requires Calendars.ReadWrite application permission or delegated access granted by the target user.13 params

Create a calendar event on another user's calendar (shared or delegated access). Targets POST /users/{id}/events. Requires Calendars.ReadWrite application permission or delegated access granted by the target user.

NameTypeRequiredDescription
user_idstringrequiredUser ID or userPrincipalName (email) of the target user whose calendar to write to (e.g., colleague@company.com).
subjectstringrequiredEvent subject / title.
start_datetimestringrequiredStart date and time in ISO 8601 format (e.g., 2024-09-15T10:00:00).
start_timezonestringrequiredIANA timezone for the start time (e.g., America/New_York).
end_datetimestringrequiredEnd date and time in ISO 8601 format.
end_timezonestringrequiredIANA timezone for the end time.
body_contentstringoptionalEvent body/description text.
body_contentTypestringoptionalBody content type: "text" or "html".
attendees_requiredarrayoptionalRequired attendee email addresses.
attendees_optionalarrayoptionalOptional attendee email addresses.
locationstringoptionalEvent location display name.
isOnlineMeetingbooleanoptionalWhether to create a Teams online meeting.
isAllDaybooleanoptionalWhether this is an all-day event.
microsoft365_outlook_update_shared_calendar_event#Update an existing event on another user's calendar (shared or delegated access). Targets PATCH /users/{id}/events/{event_id}. Requires Calendars.ReadWrite application permission or delegated access granted by the target user.10 params

Update an existing event on another user's calendar (shared or delegated access). Targets PATCH /users/{id}/events/{event_id}. Requires Calendars.ReadWrite application permission or delegated access granted by the target user.

NameTypeRequiredDescription
user_idstringrequiredUser ID or userPrincipalName (email) of the target user whose calendar to update (e.g., colleague@company.com).
event_idstringrequiredID of the calendar event to update.
subjectstringoptionalUpdated event subject / title.
start_datetimestringoptionalUpdated start date and time in ISO 8601 format.
start_timezonestringoptionalIANA timezone for the updated start time.
end_datetimestringoptionalUpdated end date and time in ISO 8601 format.
end_timezonestringoptionalIANA timezone for the updated end time.
body_contentstringoptionalUpdated event body/description text.
body_contentTypestringoptionalBody content type: "text" or "html".
locationstringoptionalUpdated event location display name.
microsoft365_outlook_get_shared_mailbox_message#Get a single message from a shared mailbox by message ID. Targets GET /users/{id}/messages/{message_id}. Requires Mail.Read or Mail.ReadWrite permission on the shared mailbox.3 params

Get a single message from a shared mailbox by message ID. Targets GET /users/{id}/messages/{message_id}. Requires Mail.Read or Mail.ReadWrite permission on the shared mailbox.

NameTypeRequiredDescription
shared_mailbox_idstringrequiredEmail address or user ID of the shared mailbox (e.g., support@company.com).
message_idstringrequiredThe ID of the message to retrieve.
$selectstringoptionalComma-separated list of message properties to return (e.g., subject,from,receivedDateTime,body).
microsoft365_outlook_list_shared_contacts#List contacts from another user's default contacts folder (a colleague's contacts). Targets GET /users/{id}/contacts. Requires Contacts.Read application permission or delegated access granted by the target user.6 params

List contacts from another user's default contacts folder (a colleague's contacts). Targets GET /users/{id}/contacts. Requires Contacts.Read application permission or delegated access granted by the target user.

NameTypeRequiredDescription
user_idstringrequiredUser ID or userPrincipalName (email) of the target user whose contacts to list (e.g., colleague@company.com).
$filterstringoptionalOData filter expression (e.g., "displayName eq 'John Doe'").
$orderbystringoptionalOData orderby expression (e.g., "displayName asc").
$selectstringoptionalComma-separated contact properties to return (e.g., displayName,emailAddresses,mobilePhone).
$topintegeroptionalMaximum number of contacts to return (1–1000).
$skipintegeroptionalNumber of contacts to skip for pagination.
microsoft365_outlook_get_shared_contact#Get a single contact from another user's contacts by contact ID. Targets GET /users/{id}/contacts/{contact_id}. Requires Contacts.Read application permission or delegated access granted by the target user.3 params

Get a single contact from another user's contacts by contact ID. Targets GET /users/{id}/contacts/{contact_id}. Requires Contacts.Read application permission or delegated access granted by the target user.

NameTypeRequiredDescription
user_idstringrequiredUser ID or userPrincipalName (email) of the target user whose contact to retrieve (e.g., colleague@company.com).
contact_idstringrequiredThe ID of the contact to retrieve.
selectstringoptionalComma-separated contact properties to return.
microsoft365_outlook_list_shared_todo_lists#List Microsoft To Do task lists belonging to another user (a colleague). Targets GET /users/{id}/todo/lists. Requires Tasks.Read application permission or delegated access granted by the target user.1 param

List Microsoft To Do task lists belonging to another user (a colleague). Targets GET /users/{id}/todo/lists. Requires Tasks.Read application permission or delegated access granted by the target user.

NameTypeRequiredDescription
user_idstringrequiredUser ID or userPrincipalName (email) of the target user whose To Do lists to retrieve (e.g., colleague@company.com).
microsoft365_outlook_list_shared_todo_tasks#List tasks in a Microsoft To Do list belonging to another user (a colleague). Targets GET /users/{id}/todo/lists/{list_id}/tasks. Requires Tasks.Read application permission or delegated access granted by the target user.6 params

List tasks in a Microsoft To Do list belonging to another user (a colleague). Targets GET /users/{id}/todo/lists/{list_id}/tasks. Requires Tasks.Read application permission or delegated access granted by the target user.

NameTypeRequiredDescription
user_idstringrequiredUser ID or userPrincipalName (email) of the target user whose tasks to list (e.g., colleague@company.com).
list_idstringrequiredThe ID of the To Do task list to retrieve tasks from.
$filterstringoptionalOData filter expression to narrow results.
$orderbystringoptionalOData orderby expression (e.g., "dueDateTime/dateTime asc").
$topintegeroptionalMaximum number of tasks to return.
$skipintegeroptionalNumber of tasks to skip for pagination.