softeria/ms-365-mcp-server

softeria/ms-365-mcp-server

от softeria
MCP сервер для работы с Microsoft 365 через Graph API. Предоставляет 200+ инструментов для управления почтой, календарём и OneDrive, включая Teams и SharePoint. Автоматизируйте офисные задачи с ИИ-ассистентами.

ms-365-mcp-server

npm version build status license

Microsoft 365 MCP Server

A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Microsoft Office services through the Graph API.

Supported Clouds

This server supports multiple Microsoft cloud environments:

Cloud Description Auth Endpoint Graph API Endpoint
Global (default) International Microsoft 365 login.microsoftonline.com graph.microsoft.com
China (21Vianet) Microsoft 365 operated by 21Vianet login.chinacloudapi.cn microsoftgraph.chinacloudapi.cn

Prerequisites

  • Node.js >= 20 (recommended)
  • Node.js 14+ may work with dependency warnings

Features

  • Authentication via Microsoft Authentication Library (MSAL)
  • Comprehensive Microsoft 365 service integration
  • Read-only mode support for safe operations
  • Tool filtering for granular access control

Output Format: JSON vs TOON

The server supports two output formats that can be configured globally:

JSON Format (Default)

Standard JSON output with pretty-printing:

{
  "value": [
    {
      "id": "1",
      "displayName": "Alice Johnson",
      "mail": "alice@example.com",
      "jobTitle": "Software Engineer"
    }
  ]
}
Инструменты были проиндексированы:
accept-calendar-eventвнешний мир

Принимает указанное событие в календаре пользователя. 💡 СОВЕТ: Принимает приглашение на встречу. Необязательное тело: { sendResponse: true, comment: 'Я приду.' }. Установите sendResponse в false, чтобы принять молча без уведомления организатора.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

add-excel-table-rowsвнешний мир

Добавляет строки таблицы Excel. 💡 СОВЕТ: Добавляет строки в таблицу. Тело: { values: [['col1val', 'col2val', 'col3val'], ['row2col1', 'row2col2', 'row2col3']] }. Каждый внутренний массив соответствует одной строке. Values должны соответствовать количеству столбцов в таблице.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookTableIdstringобязательный

    Value for the 'workbookTableId' path segment. Pass it under the name 'workbookTableId', not as 'id'. Use the 'id' field of the workbook table object as returned by Microsoft Graph.

add-mail-attachmentвнешний мир

Используйте этот API для создания нового вложения. Вложение может быть одного из следующих типов: все эти типы ресурсов вложений происходят от ресурса attachment. 💡 СОВЕТ: Единственный путь для вложений размером до 3 МБ. contentBytes должен содержать полный base64 без изменений; усечённый аргумент приводит к ошибке 400 UnableToDeserializePostBody. Для вложений от 3 МБ и выше используйте create-mail-attachment-upload-session, который отклоняет файлы меньшего размера. Тело запроса требует @odata.type: {"@odata.type": "#microsoft.graph.fileAttachment", "name": "file.pdf", "contentBytes": "<base64>"}.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

cancel-calendar-eventвнешний мир

Это действие позволяет организатору встречи отправить сообщение об отмене и отменить событие. Действие перемещает событие в папку Deleted Items. Организатор также может отменить экземпляр повторяющейся встречи, указав идентификатор экземпляра. Участник, вызывающий это действие, получает ошибку (HTTP 400 Bad Request) со следующим сообщением: 'Your request can't be completed. You need to be an organizer to cancel a meeting.' Это действие отличается от Delete тем, что Cancel доступен только организатору и позволяет организатору отправить участникам настраиваемое сообщение об отмене. 💡 СОВЕТ: Отменяет встречу (только организатор) и отправляет сообщение об отмене всем участникам. Тело: { Comment (необязательная строка, настраиваемое сообщение) }. Используйте это вместо delete-calendar-event, если хотите, чтобы участники видели 'Canceled' в своем календаре. Участники, вызывающие это, получают HTTP 400 — им следует использовать decline-calendar-event вместо этого.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

clear-excel-rangeвнешний мир

Очищает диапазон Excel. 💡 Совет: Очищает содержимое ячеек и/или форматирование в заданном диапазоне. Тело запроса: { applyTo: 'All' | 'Formats' | 'Contents' }. 'Contents' удаляет значения, но сохраняет форматирование; 'Formats' сбрасывает стили, но сохраняет значения; 'All' удаляет и то, и другое. Используйте эту операцию, чтобы сбросить участок листа перед новой записью, вместо того чтобы перезаписывать ячейки по одной.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

copy-drive-itemвнешний мир

Копирует элемент диска. 💡 ПОДСКАЗКА: Асинхронно копирует файл или папку в новое расположение и/или под новым именем. Тело запроса: { parentReference: { driveId: '...', id: '...' }, name?: 'New Name.xlsx' }. Возвращает 202 Accepted с заголовком Location, указывающим на URL мониторинга асинхронной задачи. Идеально подходит для дублирования шаблонов (например, клонирование Armhr Census Template для каждого потенциального клиента), массового предоставления файлов или сохранения неизменяемого снимка рабочего файла.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

copy-mail-messageвнешний мир

Копирует сообщение в папку в почтовом ящике пользователя. 💡 СОВЕТ: Копирует сообщение в другую почтовую папку. Body: { DestinationId: '<mailFolder-id или стандартное имя, например inbox, archive, junkemail>' }. Возвращает вновь созданное сообщение (с новым идентификатором) в целевой папке. Для перемещения вместо копирования используйте move-mail-message.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

create-calendarвнешний мир

Создаёт новый календарь для пользователя. 💡 СОВЕТ: Создаёт личный календарь. Тело: { name: 'My Calendar', color: 'auto' }. Доступные цвета: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-calendar-eventвнешний мир

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

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-contact-child-folderвнешний мир

Создаёт новый contactFolder как дочерний элемент указанной папки. Также можно создать новый contactFolder в папке контактов по умолчанию пользователя. 💡 СОВЕТ: Создаёт подпапку внутри существующей папки контактов. Тело: { displayName: 'Имя подпапки' }. Используйте list-contact-folders, чтобы узнать идентификатор родительской папки. Возвращаемый contactFolder имеет собственный идентификатор, который можно использовать с update-contact-folder, delete-contact-folder, list-contact-folder-contacts и create-contact-in-folder, идентификаторы contactFolder уникальны в пределах почтового ящика независимо от глубины вложенности.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • contactFolderIdstringобязательный

    Value for the 'contactFolderId' path segment. Pass it under the name 'contactFolderId', not as 'id'. Use the 'id' field of the contact folder object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-contact-folderвнешний мир

Создаёт новый contactFolder в папке контактов пользователя по умолчанию. Вы также можете создать новый contactfolder как дочерний элемент любой указанной папки контактов. 💡 СОВЕТ: Создаёт новую папку контактов в корне почтового ящика пользователя. Body: { displayName: 'Family' }. Возвращает созданный contactFolder с его id. Чтобы создать подпапку в существующей папке, используйте create-contact-child-folder.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-contact-in-folderвнешний мир

Добавляет контакт в корневую папку Contacts или в конечную точку contacts другой папки контактов. 💡 TIP: Создаёт контакт внутри конкретной папки (вместо папки Contacts по умолчанию). Тело — ресурс контакта: { givenName, surname, displayName, emailAddresses: [{ address, name }], businessPhones: [], mobilePhone, jobTitle, companyName, ... }. Существующий create-outlook-contact (POST /me/contacts) записывает только в папку по умолчанию; используйте этот инструмент при организации контактов в именованные папки. Получите идентификатор папки через list-contact-folders.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • contactFolderIdstringобязательный

    Value for the 'contactFolderId' path segment. Pass it under the name 'contactFolderId', not as 'id'. Use the 'id' field of the contact folder object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-draft-emailвнешний мир

Создаёт черновик сообщения Outlook в папке Drafts вошедшего пользователя. Устанавливает тему, тело, toRecipients, ccRecipients и важность. Черновик сохраняется, а не отправляется. Используйте send-mail, чтобы отправить сообщение напрямую, или отправьте черновик позже.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-drive-item-previewвнешний мир

Создаёт предварительный просмотр элемента диска. 💡 СОВЕТ: Генерирует кратковременную встраиваемую ссылку для предварительного просмотра файла (документы Office, PDF, изображения). Тело: { page?: number | string, zoom?: number, viewer?: 'onedrive' | 'office' }. Возвращает getUrl (интерактивный) и postUrl (отправка формы). Полезен для отображения встроенных превью в сводных письмах или сообщениях чата без необходимости получателю открывать файл.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-drive-item-share-linkвнешний мир

Создаёт ссылку для предоставления общего доступа к DriveItem. Действие createLink создаёт новую ссылку для общего доступа, если указанный тип ссылки ещё не существует для вызывающего приложения. Если ссылка для общего доступа указанного типа уже существует для приложения, возвращается существующая ссылка. Ресурсы DriveItem наследуют разрешения на общий доступ от своих предков. 💡 СОВЕТ: Создайте ссылку для общего доступа к файлу или папке БЕЗ отправки приглашения по электронной почте. Тело: { type: 'view' | 'edit' | 'embed', scope: 'anonymous' | 'organization' | 'users', password?: string, expirationDateTime?: ISO-8601, retainInheritedPermissions?: boolean }. Возвращает разрешение с link.webUrl. Используйте вместе с share-drive-item, когда нужно предоставить явный доступ; используйте этот инструмент, когда нужен только URL для вставки в документ/письмо/чат без отправки уведомлений OneDrive.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-excel-chartвнешний мир

Создаёт новую диаграмму.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

create-excel-tableвнешний мир

Создаёт новую таблицу. Адрес исходного диапазона определяет лист, на который будет добавлена таблица. Если таблицу не удаётся добавить (например, из-за неверного адреса или если таблица будет пересекаться с другой таблицей), генерируется ошибка. 💡 СОВЕТ: Преобразует диапазон листа в формальную таблицу Excel. Body: { address: 'A1:H171', hasHeaders: true }. Требуется перед использованием add-excel-table-rows / update-excel-table-row / delete-excel-table-row на листе с обычными ячейками.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

create-focused-inbox-overrideвнешний мир

Создает переопределение для отправителя, указанного по SMTP-адресу. Будущие сообщения с этого SMTP-адреса будут последовательно классифицироваться в соответствии с переопределением. Примечание 💡 СОВЕТ: Создает переопределение Focused Inbox для отправителя. Body: { classifyAs: 'focused', senderEmailAddress: { name: 'Display Name', address: 'sender@example.com' } }. classifyAs должно быть 'focused' или 'other'. Если для этого SMTP-адреса уже существует переопределение, POST обновляет имя и classifyAs существующего переопределения (используйте это, чтобы переименовать отправителя). Узнайте адрес отправителя с помощью list-users или прочитав последний заголовок письма — не выдумывайте SMTP-адреса.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-forward-draftвнешний мир

Создаёт черновик пересылаемого письма. 💡 СОВЕТ: Создаёт черновик пересылки (не отправляет). Полезно, когда пользователь хочет просмотреть перед отправкой.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

create-mail-attachment-upload-sessionвнешний мир

Создаёт сеанс загрузки, который позволяет приложению итеративно загружать диапазоны файла, чтобы прикрепить его к указанному элементу Outlook. Элементом может быть сообщение или событие. Используйте этот подход для прикрепления файла, если его размер от 3 МБ до 150 МБ. Для прикрепления файла размером меньше 3 МБ выполните операцию POST для навигационного свойства attachments элемента Outlook; см. как это сделать для сообщения или для события. В ответе это действие возвращает URL для загрузки, который можно использовать в последующих последовательных PUT-запросах. Заголовки запросов каждой операции PUT позволяют указать точный диапазон байтов для загрузки. Это позволяет возобновить передачу, если сетевое соединение прервалось во время загрузки. Ниже приведены шаги для прикрепления файла к элементу Outlook с помощью сеанса загрузки: пример см. в разделе «Прикрепление больших файлов к сообщениям или событиям Outlook». 💡 ПОДСКАЗКА: для вложений от 3 МБ до 150 МБ. Graph отклоняет файлы меньшего размера с ошибкой ErrorAttachmentSizeShouldNotBeLessThanMinimumSize, поэтому для файлов до 3 МБ используйте add-mail-attachment. Тело: { AttachmentItem: { attachmentType: 'file', name: 'report.pdf', size: 5000000 } }. Возвращает предварительно аутентифицированный uploadUrl; вызывающая сторона сама отправляет туда байты диапазонами до 4 МБ. Этот сервер не выполняет PUT.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

create-mail-child-folderвнешний мир

Используйте этот API, чтобы создать новую дочернюю почтовую папку (mailFolder). Если вы намереваетесь скрыть новую папку, необходимо установить свойство isHidden в значение true при создании. 💡 ПОДСКАЗКА: Создает подпапку внутри существующей почтовой папки. Используйте list-mail-folders или list-mail-child-folders, чтобы найти ID родительской папки.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

create-mail-folderвнешний мир

Используйте этот API для создания новой почтовой папки в корневой папке почтового ящика пользователя. Если вы хотите, чтобы новая папка была скрытой, необходимо установить свойство isHidden в true при создании. 💡 СОВЕТ: Создаёт почтовую папку верхнего уровня. Используйте create-mail-child-folder для создания вложенной папки внутри существующей папки. Используйте list-mail-folders для поиска идентификаторов существующих папок.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-mail-ruleвнешний мир

Создаёт объект messageRule с указанным набором условий и действий. Outlook выполняет эти действия, если входящее сообщение в папке «Входящие» пользователя соответствует заданным условиям. 💡 СОВЕТ: Создаёт правило сообщения для почтовой папки. Используйте ID папки «Входящие» (получите его из list-mail-folders) для правил на входящие. Тело запроса: { displayName: 'Имя правила', sequence: 1, isEnabled: true, conditions: { fromAddresses: [{ emailAddress: { address: 'user@example.com' } }] }, actions: { moveToFolder: 'folder-id' } }. Действия: moveToFolder, copyToFolder, forwardTo, forwardAsAttachmentTo, delete, markAsRead, markImportance, stopProcessingRules.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

create-my-calendar-permissionвнешний мир

Создаёт ресурс calendarPermission, указывающий личность и роль пользователя, с которым указанный календарь предоставляется в общий доступ или делегируется. 💡 СОВЕТ: Предоставляет общий доступ к основному календарю пользователя другому пользователю (или настраивает делегата). Тело: { emailAddress: { name: 'Adele Vance', address: 'adele@contoso.com' }, role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess', isInsideOrganization: true, isRemovable: true }. Используйте list-users для определения SMTP-адреса получателя. Возвращает созданный calendarPermission с его id (используется методами update-my-calendar-permission и delete-my-calendar-permission).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-onedrive-folderвнешний мир

Создаёт папку OneDrive. 💡 СОВЕТ: Создаёт новую папку внутри указанного элемента диска. Тело запроса должно включать поля name (string) и folder ({}). Используйте @microsoft.graph.conflictBehavior для управления поведением при конфликте имён: 'rename' (по умолчанию), 'replace' или 'fail'.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-onenote-notebookвнешний мир

Создаёт новую записную книжку OneNote. 💡 ПОДСКАЗКА: Создаёт новую записную книжку OneNote. Тело: { displayName: 'Notebook Name' }. Имя должно быть уникальным среди всех записных книжек пользователя.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-onenote-pageвнешний мир

Создаёт новую страницу OneNote в разделе по умолчанию стандартной записной книжки. Чтобы создать страницу в другом разделе той же записной книжки, используйте параметр запроса sectionName. Пример: ../onenote/pages?sectionName=My%20section. Операция POST /onenote/pages используется только для создания страниц в записной книжке по умолчанию текущего пользователя. Если вы работаете с другими записными книжками, вы можете создавать страницы в указанном разделе. 💡 СОВЕТ: Тело запроса должно быть полным HTML-документом (с <html><head><title>...</title></head><body>...</body></html>). Частичный HTML или обычный текст незаметно завершается ошибкой или создаёт некорректные страницы.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-onenote-sectionвнешний мир

Создаёт новый onenoteSection в указанной записной книжке. 💡 TIP: Создаёт новый раздел в записной книжке. Body: { displayName: 'Section Name' }

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • notebookIdstringобязательный

    Value for the 'notebookId' path segment. Pass it under the name 'notebookId', not as 'id'. Use the 'id' field of the notebook object as returned by Microsoft Graph.

create-onenote-section-pageвнешний мир

Создаёт новую страницу в указанном разделе. 💡 СОВЕТ: Тело должно быть полным HTML-документом (с <html><head><title>...</title></head><body>...</body></html>). Частичный HTML молча завершается ошибкой.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • onenoteSectionIdstringобязательный

    Value for the 'onenoteSectionId' path segment. Pass it under the name 'onenoteSectionId', not as 'id'. Use the 'id' field of the onenote section object as returned by Microsoft Graph.

create-outlook-categoryвнешний мир

Создаёт объект outlookCategory в главном списке категорий пользователя. 💡 ПОДСКАЗКА: Создаёт новую категорию Outlook. Тело: { displayName (уникальный), color (один из: none, preset0 … preset24 - соответствует red, orange, yellow, green, teal, olive, blue, purple, cranberry, steel, dark-steel, gray, dark-gray, black, dark-red, dark-orange, dark-yellow, dark-green, dark-teal, dark-olive, dark-blue, dark-purple, dark-cranberry) }. Имена категорий чувствительны к регистру при применении к сообщениям/событиям.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-outlook-contactвнешний мир

Добавляет контакт в корневую папку контактов или в конечную точку контактов другой папки контактов.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-planner-bucketвнешний мир

Создаёт новый объект plannerBucket.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-planner-taskвнешний мир

Создаёт новый plannerTask.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-planner-task-messageвнешний мир

[beta] Создаёт новое plannerTaskChatMessage в plannerTask. 💡 СОВЕТ: Отправляет сообщение в чат задачи Planner (современный «чат задачи», а не устаревший conversationThreadId). Microsoft убирает классические комментарии к задачам и скрывает их из задачи (обновление Planner 2026), поэтому чат задачи — это текущий поддерживаемый способ публикации обновлений по задаче, которые увидят коллеги, с @упоминаниями. Тело: { content: 'обычный текст или очищенный HTML', mentions?: [{ mentioned: 'идентификатор-пользователя', position: 0, mentionType: 'user' }] } (mentions опционально). ETag/If-Match не требуется. BETA Graph API: может измениться; только делегированные рабочие/учебные учетные записи — без разрешений приложения, без личных учетных записей Microsoft, только глобальное облако (не GCC/DoD/21Vianet).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerTaskIdstringобязательный

    Value for the 'plannerTaskId' path segment. Pass it under the name 'plannerTaskId', not as 'id'. Use the 'id' field of the planner task object as returned by Microsoft Graph.

create-reply-all-draftвнешний мир

Создаёт черновик ответа отправителю и всем получателям сообщения в формате JSON или MIME. При использовании формата JSON: - Указывает либо comment, либо свойство body параметра message. Указание обоих возвращает ошибку HTTP 400 Bad Request. - Если исходное сообщение задаёт получателя в свойстве replyTo, по стандарту Internet Message Format (RFC 2822) отправляйте ответ получателям из свойств replyTo и toRecipients, а не получателям из свойств from и toRecipients. - Черновик можно обновить позже — добавить содержимое ответа в тело или изменить другие свойства сообщения. При использовании формата MIME: - Указывает соответствующие заголовки интернет-сообщений и MIME-содержимое: всё кодируется в base64 в теле запроса. - Добавляет любые вложения и свойства S/MIME в MIME-содержимое. Отправляет черновик сообщения последующей операцией. Либо отвечает всем в одном действии. 💡 ПОДСКАЗКА: Для HTML-ответов передавайте Message.body.contentType: 'html' с Message.body.content в виде HTML. Примечание: передача Message.body заменяет всё тело черновика, поэтому исходная цитируемая история не включается. Указание одновременно 'comment' и Message.body возвращает 400. Подписи добавляются только клиентом Outlook, не через Graph.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

create-reply-draftвнешний мир

Создаёт черновик для ответа отправителю сообщения в формате JSON или MIME. При использовании JSON: - Указывает либо комментарий, либо свойство body параметра message. Указание обоих возвращает ошибку HTTP 400 Bad Request. - Если в исходном сообщении указан replyTo, согласно Internet Message Format (RFC 2822), следует отправлять ответ получателям из replyTo, а не из from. - Черновик можно обновить позже, чтобы добавить текст ответа в body или изменить другие свойства сообщения. При использовании MIME: - Предоставляет применимые заголовки Internet-сообщений и MIME-содержимое, все закодированные в формате base64 в теле запроса. - Добавляет любые вложения и свойства S/MIME в MIME-содержимое. Отправляет черновик сообщения последующей операцией. Или отвечает на сообщение одной операцией. 💡 СОВЕТ: Для HTML-ответов передаёт Message.body.contentType: 'html' с Message.body.content в виде HTML. Примечание: передача Message.body заменяет всё тело черновика, поэтому исходная цитируемая история не включается. Указание и 'comment', и Message.body возвращает 400. Подписи добавляются только клиентом Outlook.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

create-specific-calendar-eventвнешний мир

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

Параметры
  • bodyobjectобязательный
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-subscriptionвнешний мир

Подписывает приложение-слушатель на получение уведомлений об изменениях определённых типов в указанном ресурсе Microsoft Graph. Чтобы определить ресурсы, для которых можно создавать подписки, и ограничения подписок, см. раздел Настройка уведомлений об изменениях данных ресурсов: Поддерживаемые ресурсы. Некоторые ресурсы поддерживают расширенные уведомления — уведомления, содержащие данные ресурса. Дополнительные сведения о таких ресурсах см. в разделе Настройка уведомлений об изменениях, включающих данные ресурса: Поддерживаемые ресурсы. 💡 СОВЕТ: Создаёт вебхук-подписку для уведомлений об изменениях. Обязательное тело запроса: { changeType (через запятую: 'created,updated,deleted'), notificationUrl (HTTPS, должен пройти проверку с помощью токена эха), resource (например '/me/mailFolders/inbox/messages', '/users/{id}/events', '/teams/{id}/channels/{id}/messages'), expirationDateTime (ISO 8601, максимальное значение зависит от типа ресурса — 1 час для звонков, 24 часа для сообщений, 3 дня для почты), clientState (непрозрачная строка, возвращается в уведомлениях, для проверки) }. Необязательно: includeResourceData (true включает расширенные уведомления, требуется encryptionCertificate + encryptionCertificateId). Отдельная область не требуется — вызывающий должен иметь разрешение на чтение целевого ресурса (например Mail.Read, Calendars.Read, ChannelMessage.Read.All, Files.Read.All).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-todo-linked-resourceвнешний мир

Создаёт объект linkedResource для связывания указанной задачи с элементом в партнерском приложении. Например, вы можете связать задачу с элементом электронной почты в Outlook, который побудил задачу, и создать объект linkedResource для отслеживания этой связи. Вы также можете создать объект linkedResource при создании самой задачи. 💡 СОВЕТ: Связывает ресурс с задачей To Do. Тело: { webUrl: 'https://...', applicationName: 'Mail', displayName: 'Related email', externalId: 'optional-id' }. Связывает задачи с электронными письмами, файлами или веб-страницами для контекста.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • todoTaskIdstringобязательный

    Value for the 'todoTaskId' path segment. Pass it under the name 'todoTaskId', not as 'id'. Use the 'id' field of the todo task object as returned by Microsoft Graph.

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

create-todo-taskвнешний мир

Создаёт новый объект задачи в указанном todoTaskList. 💡 СОВЕТ: Создаёт новую задачу в списке Microsoft To Do. Тело: { title: "..." }; необязательные dueDateTime, reminderDateTime, importance, body (notes), recurrence, categories. Требуется todoTaskListId из list-todo-task-lists.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

create-todo-task-listвнешний мир

Создаёт новый объект списка. 💡 СОВЕТ: Создаёт новый список задач Microsoft To Do (именованные списки задач, отображаемые на боковой панели приложения To Do). Тело запроса: { displayName: 'My new list' }. Возвращает созданный todoTaskList с его id, displayName, isOwner, isShared и wellknownListName ('none' для списков, созданных пользователем). Встроенные списки ('Tasks', 'Flagged emails') уже существуют, и их нельзя создать заново. Используйте вместе с create-todo-task для создания задач.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

create-upload-sessionвнешний мир

Создаёт сеанс загрузки. 💡 СОВЕТ: Для загрузки больших файлов (без ограничений по размеру и без минимального, в отличие от сеанса вложений Outlook). Возвращает предварительно аутентифицированный uploadUrl; вызывающий сам PUT-запросом отправляет туда байты. Этот сервер не выполняет PUT. Для новых файлов используйте путь: /items/{parentId}:/{fileName}:/createUploadSession. Тело запроса (необязательно): { item: { '@microsoft.graph.conflictBehavior': 'rename' } }.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

decline-calendar-eventвнешний мир

Отклоняет приглашение на указанное событие в календаре пользователя. Если событие допускает предложения нового времени, при отклонении события приглашенный может предложить альтернативное время, включив параметр proposedNewTime. Дополнительную информацию о том, как предложить время и как получить и принять предложение нового времени, см. в разделе Propose new meeting times. 💡 TIP: Отклоняет приглашение на встречу. Необязательное тело: { sendResponse: true, comment: 'Cannot attend, conflict.' }. Событие остается в календаре как отклоненное, если пользователь не удалит его.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

delete-calendarвнешний мир

Удаляет календарь, кроме календаря по умолчанию. 💡 СОВЕТ: Удаляет календарь и все его события. Календарь по умолчанию нельзя удалить. Это действие нельзя отменить.

Параметры
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

delete-calendar-eventвнешний мир

Удаляет указанное событие из содержащего календаря. Если событие является встречей, удаление события в календаре организатора отправляет сообщение об отмене участникам встречи. 💡 СОВЕТ: Удаление seriesMaster удаляет ВСЕ вхождения повторяющегося события. Чтобы отменить одно вхождение, удалите конкретный идентификатор экземпляра из list-calendar-event-instances.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

delete-contact-folderвнешний мир

Удаляет контактную папку, отличную от папки по умолчанию. 💡 СОВЕТ: Удаляет контактную папку. Папку по умолчанию 'Contacts' удалить нельзя - Graph возвращает ошибку. Папка (и её содержимое) обычно попадает в Deleted Items, а не удаляется навсегда. Получите идентификатор папки через list-contact-folders.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • contactFolderIdstringобязательный

    Value for the 'contactFolderId' path segment. Pass it under the name 'contactFolderId', not as 'id'. Use the 'id' field of the contact folder object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

delete-drive-item-permissionвнешний мир

Удаляет разрешение элемента диска. 💡 СОВЕТ: Удаляет конкретное разрешение из файла или папки. Удалить можно только неунаследованные разрешения. Сначала используйте list-drive-item-permissions, чтобы найти идентификатор разрешения.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • permissionIdstringобязательный

    Value for the 'permissionId' path segment. Pass it under the name 'permissionId', not as 'id'. Use the 'id' field of the permission object as returned by Microsoft Graph.

delete-excel-rangeвнешний мир

Удаляет диапазон Excel. 💡 СОВЕТ: Удаляет ячейки в указанном диапазоне, сдвигая оставшееся содержимое. Body: { shift: 'Up' } или { shift: 'Left' }. Используйте 'Up', чтобы удалить ячейки и сдвинуть вверх, 'Left' - сдвинуть влево.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

delete-excel-table-rowвнешний мир

Удаляет строку таблицы Excel. 💡 СОВЕТ: Удалите одну строку из формальной таблицы Excel по индексу, начинающемуся с нуля.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • indexstringобязательный

    Value for the 'index' path segment.

  • workbookTableIdstringобязательный

    Value for the 'workbookTableId' path segment. Pass it under the name 'workbookTableId', not as 'id'. Use the 'id' field of the workbook table object as returned by Microsoft Graph.

delete-focused-inbox-overrideвнешний мир

Удаляет переопределение, указанное по его ID. 💡 СОВЕТ: Удаляет переопределение Focused Inbox. Будущие сообщения от этого отправителя возвращаются к поведению по умолчанию классификатора Outlook ML. Используйте list-focused-inbox-overrides, чтобы сначала найти ID.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • inferenceClassificationOverrideIdstringобязательный

    Value for the 'inferenceClassificationOverrideId' path segment. Pass it under the name 'inferenceClassificationOverrideId', not as 'id'. Use the 'id' field of the inference classification override object as returned by Microsoft Graph.

delete-mail-attachmentвнешний мир

Удаляет вложение электронной почты.

Параметры
  • attachmentIdstringобязательный

    Value for the 'attachmentId' path segment. Pass it under the name 'attachmentId', not as 'id'. Use the 'id' field of the attachment object as returned by Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

delete-mail-folderвнешний мир

Удаляет указанную папку mailFolder. Папка может быть mailSearchFolder. Можно указать папку почты по её идентификатору папки или по её общеизвестному имени папки, если оно существует. 💡 СОВЕТ: Удаляет папку почты и всё её содержимое. Это действие необратимо. Используйте list-mail-folders, чтобы найти идентификатор папки.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

delete-mail-messageвнешний мир

Удаляет сообщение электронной почты Outlook по его идентификатору сообщения. Это мягкое удаление, которое перемещает сообщение в Deleted Items. 💡 СОВЕТ: Мягкое удаление — перемещает в Deleted Items. Чтобы удалить навсегда, удалите снова из Deleted Items.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

delete-mail-ruleвнешний мир

Удаляет указанный объект messageRule. 💡 СОВЕТ: Удаляет правило сообщения без возможности восстановления. Используйте идентификатор папки Inbox (получите его из list-mail-folders) для правил входящих сообщений.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

  • messageRuleIdstringобязательный

    Value for the 'messageRuleId' path segment. Pass it under the name 'messageRuleId', not as 'id'. Use the 'id' field of the message rule object as returned by Microsoft Graph.

delete-my-calendar-permissionвнешний мир

Удаляет разрешение для моего календаря. 💡 СОВЕТ: Отменяет общий доступ к календарю или делегированный доступ. Получите идентификатор разрешения через list-my-calendar-permissions. Разрешения, у которых isRemovable=false (например, неявное разрешение 'My Organization' по умолчанию), нельзя удалить — Graph возвращает ошибку.

Параметры
  • calendarPermissionIdstringобязательный

    Value for the 'calendarPermissionId' path segment. Pass it under the name 'calendarPermissionId', not as 'id'. Use the 'id' field of the calendar permission object as returned by Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

delete-onedrive-fileвнешний мир

Удаляет файл OneDrive.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

delete-onenote-pageвнешний мир

Удаляет страницу OneNote. 💡 СОВЕТ: Удаляет страницу OneNote навсегда. Это действие нельзя отменить.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • onenotePageIdstringобязательный

    Value for the 'onenotePageId' path segment. Pass it under the name 'onenotePageId', not as 'id'. Use the 'id' field of the onenote page object as returned by Microsoft Graph.

delete-outlook-contactвнешний мир

Удаляет контакт.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • contactIdstringобязательный

    Value for the 'contactId' path segment. Pass it under the name 'contactId', not as 'id'. Use the 'id' field of the contact object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

delete-planner-bucketвнешний мир

Удаляет plannerBucket. 💡 ПОДСКАЗКА: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match с ETag из get-planner-bucket (используйте includeHeaders=true).

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerBucketIdstringобязательный

    Value for the 'plannerBucketId' path segment. Pass it under the name 'plannerBucketId', not as 'id'. Use the 'id' field of the planner bucket object as returned by Microsoft Graph.

delete-planner-task-messageвнешний мир

[beta] Удаляет объект plannerTaskChatMessage. 💡 СОВЕТ: Удаляет сообщение из чата задачи Planner. Тело запроса не требуется; If-Match опционален для условного удаления; возвращает 204. BETA Graph API: может измениться; только делегированные рабочие/учебные учетные записи, без разрешений приложения, без личных учетных записей Microsoft, только глобальное облако (не GCC/DoD/21Vianet). 💡 СОВЕТ: Используйте это только если у вас есть идентификатор чата и идентификатор задачи. Предпочтительнее использовать метод list для поиска идентификатора сообщения.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerTaskChatMessageIdstringобязательный

    Value for the 'plannerTaskChatMessageId' path segment. Pass it under the name 'plannerTaskChatMessageId', not as 'id'. Use the 'id' field of the planner task chat message object as returned by Microsoft Graph.

  • plannerTaskIdstringобязательный

    Value for the 'plannerTaskId' path segment. Pass it under the name 'plannerTaskId', not as 'id'. Use the 'id' field of the planner task object as returned by Microsoft Graph.

delete-specific-calendar-eventвнешний мир

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

Параметры
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

delete-subscriptionвнешний мир

Удаляет подписку. Список ресурсов, поддерживающих подписку на уведомления об изменениях, см. в таблице в разделе Permissions. 💡 СОВЕТ: Удаляет подписку вебхука. Последующие уведомления об изменениях отправляться не будут. Используйте, чтобы очистить устаревшие подписки или прекратить получение уведомлений. Используйте list-subscriptions, чтобы найти идентификатор.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • subscriptionIdstringобязательный

    Value for the 'subscriptionId' path segment. Pass it under the name 'subscriptionId', not as 'id'. Use the 'id' field of the subscription object as returned by Microsoft Graph.

delete-todo-linked-resourceвнешний мир

Удаляет объект linkedResource. 💡 TIP: Удаляет связанный ресурс из задачи To Do.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • linkedResourceIdstringобязательный

    Value for the 'linkedResourceId' path segment. Pass it under the name 'linkedResourceId', not as 'id'. Use the 'id' field of the linked resource object as returned by Microsoft Graph.

  • todoTaskIdstringобязательный

    Value for the 'todoTaskId' path segment. Pass it under the name 'todoTaskId', not as 'id'. Use the 'id' field of the todo task object as returned by Microsoft Graph.

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

delete-todo-taskвнешний мир

Удаляет объект todoTask.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • todoTaskIdstringобязательный

    Value for the 'todoTaskId' path segment. Pass it under the name 'todoTaskId', not as 'id'. Use the 'id' field of the todo task object as returned by Microsoft Graph.

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

delete-todo-task-listвнешний мир

Удаляет объект todoTaskList. 💡 СОВЕТ: Удаляет список задач Microsoft To Do. Встроенные списки (Flagged emails, список задач по умолчанию) нельзя удалить - API возвращает ошибку для них. Получайте идентификаторы списков через list-todo-task-lists.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

dismiss-calendar-event-reminderвнешний мир

Отклоняет напоминание, которое было вызвано для события в календаре пользователя. 💡 СОВЕТ: Отклоняет сработавшее напоминание о событии, чтобы оно не сработало повторно. Тело запроса не требуется. Используйте совместно с list-calendar-events или get-schedule для поиска активных напоминаний.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

download-bytesтолько чтениевнешний мир

Загружает двоичное содержимое из Microsoft Graph и возвращает его в формате base64. Единый инструмент для чтения любых двоичных данных: содержимое файла на диске, вложение почты, фото профиля, контент, размещенный в Teams, запись встречи. Возвращает { contentType, encoding: "base64", contentLength, contentBytes }. Для больших файлов на диске/SharePoint предпочитайте get-download-url, который возвращает предварительно аутентифицированный URL для потоковой передачи байтов out-of-band вместо base64 через контекст агента.

Параметры
  • targetstringобязательный

    Relative Microsoft Graph path starting with "/". Common paths: /drives/{drive-id}/items/{driveItem-id}/content (drive file content); /me/messages/{message-id}/attachments/{attachment-id}/$value (mail attachment, list-mail-attachments returns the IDs); /me/photo/$value or /users/{user-id}/photo/$value (profile photo); /chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value (Teams chat hosted content, list-chat-message-hosted-contents returns the IDs); /teams/{team-id}/channels/{channel-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value (Teams channel hosted content). For meeting recordings, use get-meeting-recording-content where available; Microsoft Graph returns authenticated recording bytes, not a pre-authenticated download URL.

download-bytes-to-fileтолько чтениевнешний мир

Записывает аутентифицированное байтовое содержимое Microsoft Graph в локальный файл на сервере, возвращая { path, contentType, bytesWritten } вместо base64. Это единственный способ сохранить вложения почты и записи собраний вне основного канала, байты которых доступны только через аутентифицированные конечные точки. Также обрабатывает фотографии профиля и контент, размещённый в Teams. Записывает в абсолютный outputPath и никогда не перезаписывает существующий файл. Работает только в stdio-режиме: через HTTP недоступен. Для содержимого файлов OneDrive или SharePoint лучше использовать get-download-url - он возвращает предварительно аутентифицированный URL для полной загрузки вне основного канала, без загрузки байтов на сервер.

Параметры
  • outputPathstringобязательный

    Absolute path on the server's filesystem where the bytes are written, e.g. /Users/me/downloads/invoice.pdf. Must be absolute; relative paths are rejected. The parent directory must already exist, and an existing file is never overwritten (the call errors if outputPath already exists).

  • targetstringобязательный

    Relative Microsoft Graph path starting with "/". Common paths: /drives/{drive-id}/items/{driveItem-id}/content (drive file content); /me/messages/{message-id}/attachments/{attachment-id}/$value (mail attachment, list-mail-attachments returns the IDs); /me/photo/$value or /users/{user-id}/photo/$value (profile photo); /chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value (Teams chat hosted content, list-chat-message-hosted-contents returns the IDs); /teams/{team-id}/channels/{channel-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value (Teams channel hosted content). For meeting recordings, use get-meeting-recording-content where available; Microsoft Graph returns authenticated recording bytes, not a pre-authenticated download URL.

format-excel-rangeвнешний мир

Форматирует диапазон Excel. 💡 СОВЕТ: Применяет свойства rangeFormat к конкретному диапазону. Обязательный параметр пути 'address' (например, 'A1:E5' или 'Sheet1!A1:E5'). Тело запроса: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Шрифт, заливка и границы здесь НЕ задаются; используйте format-excel-range-font, format-excel-range-fill и format-excel-range-border для этого.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

format-excel-range-borderвнешний мир

Форматирует границу диапазона Excel. 💡 СОВЕТ: Устанавливает одну сторону границы. Параметр пути {sideIndex} выбирает сторону: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown или DiagonalUp. Чтобы обвести все четыре края, вызовите один раз для каждой стороны.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • sideIndexstringобязательный

    Value for the 'sideIndex' path segment.

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

format-excel-range-fillвнешний мир

Форматирует заливку диапазона Excel. 💡 СОВЕТ: Установите цвет фоновой заливки ячеек диапазона.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

format-excel-range-fontвнешний мир

Форматирует шрифт диапазона Excel. 💡 СОВЕТ: Установите форматирование шрифта для диапазона: жирный, курсив, подчеркивание, размер, цвет и название шрифта.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

forward-calendar-eventвнешний мир

Это действие позволяет организатору или участнику встречи переслать запрос на встречу новому получателю. Если запрос на встречу пересылается из почтового ящика участника Microsoft 365 другому получателю, это действие также отправляет уведомление организатору о пересылке и добавляет получателя в копию встречи организатора. Эта возможность недоступна при пересылке из учётной записи Outlook.com. 💡 ПОДСКАЗКА: Пересылает приглашение на встречу дополнительным получателям. Body: { ToRecipients: [{ emailAddress: { address, name } }], Comment (необязательно) }. Если отправитель пересылки является участником (не организатором), организатор также уведомляется, и новый получатель добавляется в список участников организатора.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

forward-mail-messageвнешний мир

Пересылает сообщение в формате JSON или MIME. При использовании JSON: - Укажите либо comment, либо свойство body параметра message. Указание обоих вернёт ошибку HTTP 400 Bad Request. - Укажите либо параметр toRecipients, либо свойство toRecipients параметра message. Указание обоих или отсутствие обоих вернёт ошибку HTTP 400 Bad Request. При использовании MIME: - Передайте соответствующие заголовки интернет-сообщения и MIME-содержимое, закодированные в base64, в теле запроса. - Добавьте любые вложения и свойства S/MIME в MIME-содержимое. Этот метод сохраняет сообщение в папке «Отправленные». Как альтернатива, создайте черновик для пересылки сообщения и отправьте его позже. 💡 СОВЕТ: Пересылает письмо с сохранением полного HTML-форматирования и вложений. Поле 'comment' добавляет текст над пересылаемым содержимым. toRecipients обязателен. НЕ восстанавливайте письмо вручную — этот эндпоинт обрабатывает всё на стороне сервера.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

get-calendar-eventтолько чтениевнешний мир

Получает свойства и связи указанного объекта события. В настоящее время эта операция возвращает тела событий только в формате HTML. Есть два сценария, в которых приложение может получить событие в календаре другого пользователя: поскольку ресурс событий поддерживает расширения, вы также можете использовать операцию GET для получения пользовательских свойств и данных расширений в экземпляре события.

Параметры
  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • expandExtendedPropertiesboolean

    When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • timezonestring

    IANA timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") for calendar event times. If not specified, times are returned in UTC.

get-calendar-viewтолько чтениевнешний мир

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

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • endDateTimestringобязательный

    The end date and time of the time range, represented in ISO 8601 format. For example, 2019-11-08T20:00:00-08:00

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • expandExtendedPropertiesboolean

    When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • startDateTimestringобязательный

    The start date and time of the time range, represented in ISO 8601 format. For example, 2019-11-08T19:00:00-08:00

  • timezonestring

    IANA timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") for calendar event times. If not specified, times are returned in UTC.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

get-current-userтолько чтениевнешний мир

Извлекает свойства и связи объекта user. По умолчанию эта операция возвращает только подмножество наиболее часто используемых свойств для каждого user. Эти свойства по умолчанию указаны в разделе Properties. Чтобы получить свойства, которые не возвращаются по умолчанию, выполните операцию GET для user и укажите свойства в параметре запроса OData $select. Поскольку ресурс user поддерживает расширения, вы также можете использовать операцию GET для получения настраиваемых свойств и данных расширения в экземпляре user. Клиенты через Microsoft Entra ID for customers также могут использовать эту операцию API для получения своих данных.

Параметры
  • ConsistencyLevelstring

    Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-download-urlтолько чтениевнешний мир

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

Параметры
  • targetstringобязательный

    Relative Microsoft Graph path starting with "/". Either a driveItem content path or the item path itself, e.g. /drives/{drive-id}/items/{driveItem-id}/content, /me/drive/items/{driveItem-id}/content, or /sites/{site-id}/drive/items/{driveItem-id}. A trailing /content is optional and is stripped automatically for drive items. Mail attachment $value paths and meeting recordings are not supported (Graph exposes no pre-authenticated URL for them).

get-drive-deltaтолько чтениевнешний мир

Отслеживает изменения в driveItem и его дочерних элементах с течением времени. Ваше приложение начинает с вызова delta без параметров. Служба начинает перечисление иерархии диска, возвращая страницы элементов и либо @odata.nextLink, либо @odata.deltaLink, как описано ниже. Приложение должно продолжать вызывать с @odata.nextLink, пока вы больше не увидите возвращаемый @odata.nextLink или не увидите ответ с пустым набором изменений. После того как вы закончите получать все изменения, вы можете применить их к своему локальному состоянию. Чтобы проверять изменения в будущем, снова вызовите delta с @odata.deltaLink из предыдущего ответа. Удаленные элементы возвращаются с аспектом deleted. Элементы с этим установленным свойством следует удалить из вашего локального состояния. 💡 СОВЕТ: Отслеживает изменения в driveItem и его дочерних элементах с течением времени. Возвращает коллекцию driveItems, которые были созданы, изменены или удалены. Сначала используйте get-drive-root-item, чтобы получить корневой driveItem-id, затем передайте его сюда. Поддерживает $select и delta tokens для инкрементальной синхронизации через @odata.deltaLink.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

get-drive-itemтолько чтениевнешний мир

Все элементы, содержащиеся в диске. Только для чтения. Может быть null. 💡 СОВЕТ: Получает метаданные файла или папки: name, size, lastModifiedDateTime, createdBy, webUrl, file (mimeType, hashes), folder (childCount), parentReference и @microsoft.graph.downloadUrl. Для больших файлов на диске или в SharePoint вызовите get-download-url с target=/drives/{drive-id}/items/{driveItem-id}/content, чтобы загрузить данные внеполосно (без заголовка Authorization). Для небольших файлов, если base64 в ответе инструмента приемлем, вызовите download-bytes с тем же целевым путем /content.

Параметры
  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-drive-root-itemтолько чтениевнешний мир

Корневая папка диска. Только для чтения.

Параметры
  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-excel-rangeтолько чтениевнешний мир

Получает диапазон Excel.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

get-excel-range-formatтолько чтениевнешний мир

Возвращает объект формата, инкапсулирующий шрифт, заливку, границы, выравнивание и другие свойства диапазона. Только для чтения. 💡 СОВЕТ: Читает формат диапазона: alignment, wrapText, columnWidth, rowHeight. Шрифт, заливка и границы вложены и по умолчанию опущены; добавьте font, fill и borders в параметр $expand, чтобы включить их за один вызов. Оформление ячеек часто кодирует смысл (цвет заливки или шрифта помечает статус, например «предварительный» или «согласованный»), поэтому раскрывайте эти свойства, чтобы интерпретировать, что означают ячейки.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

get-excel-tableтолько чтениевнешний мир

Представляет коллекцию таблиц, связанных с рабочей книгой. Только для чтения. 💡 СОВЕТ: Получает конкретную таблицу по имени или ID. Возвращает свойства таблицы, включая columns, showHeaders, showTotals и style.

Параметры
  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • workbookTableIdstringобязательный

    Value for the 'workbookTableId' path segment. Pass it under the name 'workbookTableId', not as 'id'. Use the 'id' field of the workbook table object as returned by Microsoft Graph.

get-excel-used-rangeтолько чтениевнешний мир

Получает использованный диапазон Excel. 💡 СОВЕТ: Получает наименьший диапазон, охватывающий все ячейки с данными или форматированием на листе. Возвращает адрес, значения, формулы, numberFormat, количество строк, количество столбцов. Используйте этот диапазон, чтобы определить заполненные границы листа перед чтением или добавлением данных - избавляет от необходимости угадывать, насколько далеко простираются данные. Опциональный $select для сужения возвращаемых полей.

Параметры
  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

get-mailbox-settingsтолько чтениевнешний мир

Получает настройки почтового ящика пользователя. Можно просмотреть все настройки почтового ящика или получить конкретные. Пользователи могут задать следующие настройки для своих почтовых ящиков через клиент Outlook: пользователи могут установить предпочитаемые форматы даты и времени с помощью Outlook в Интернете. Пользователь выбирает один из поддерживаемых форматов короткой даты или короткого времени. Эта операция GET возвращает выбранный пользователем формат. Пользователи могут задать предпочитаемый часовой пояс в любом клиенте Outlook, выбрав один из поддерживаемых часовых поясов, которые администратор настроил для их почтового сервера. Администратор может настроить часовые пояса в формате часовых поясов Windows или в формате часовых поясов Internet Assigned Numbers Authority (IANA) (также известных как часовые пояса Olson). Формат Windows используется по умолчанию. Эта операция GET возвращает предпочитаемый часовой пояс пользователя в том формате, который настроил администратор. Если вы хотите получить часовой пояс в определённом формате (Windows или IANA), вы можете сначала обновить предпочитаемый часовой пояс в этом формате как настройку почтового ящика. Затем вы сможете получить часовой пояс в этом формате. Или вы можете управлять преобразованием формата отдельно в своём приложении. 💡 Подсказка: Получает настройки почтового ящика текущего пользователя, включая automaticRepliesSetting (статус отсутствия на работе, сообщение, scheduledStartDateTime/EndDateTime, externalAudience), language, timeZone, dateFormat, timeFormat, delegateMeetingMessageDeliveryOptions и workingHours.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-mail-messageтолько чтениевнешний мир

Получает одно письмо Outlook по его идентификатору, включая полную тему, отправителя, получателей, содержимое и флаги вложений. Сначала используйте list-mail-messages, чтобы получить идентификатор письма.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-mail-message-mimeтолько чтениевнешний мир

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

Параметры
  • Acceptstring

    Accept header for the response representation. Defaults to "text/plain". Only set this when Graph asks for a different format — e.g. a 403 SpeakerAttributionNotAllowed on transcript content names the media type to retry with.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • includeHiddenMessagesstring

    Include Hidden Messages

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

get-mail-tipsтолько чтениевнешний мир

Получает MailTips одного или нескольких получателей, доступные вошедшему в систему пользователю. Обратите внимание, что с помощью POST-вызова действия getMailTips вы можете запросить определённые типы MailTips для нескольких получателей одновременно. Запрошенные MailTips возвращаются в коллекции mailTips. 💡 СОВЕТ: Просматривает MailTips для одного или нескольких получателей перед отправкой письма — отвечает на вопросы: «этот человек в автоответе / OOF?», «превысит ли моё письмо его квоту почтового ящика?», «является ли он внешним получателем?», «это почтовый ящик или список рассылки?». Тело: { EmailAddresses: ['user@contoso.com', ...], MailTipsOptions: 'automaticReplies, mailboxFullStatus, customMailTip, externalMemberCount, totalMemberCount, maxMessageSize, deliveryRestriction, moderationStatus, recipientScope, recipientSuggestions' (подмножество через запятую) }. Возвращает MailTips для каждого получателя с заполненными запрошенными полями. Используйте это, чтобы не отправлять срочные письма, когда получатель в OOF, или чтобы предупредить перед рассылкой большому числу адресатов.

Параметры
  • bodyobjectобязательный
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

get-my-profileтолько чтениевнешний мир

[beta] Получает свойства и связи объекта profile для заданного пользователя. Ресурс profile предоставляет различные расширенные свойства, описывающие пользователя в виде связей, например, годовщины и сведения об образовании. Чтобы получить одно из этих навигационных свойств, используйте соответствующий метод GET для этого свойства. Смотрите методы, предоставляемые profile. 💡 СОВЕТ: Получает расширенный профиль вошедшего в систему пользователя — более богатый объект, чем get-current-user, предоставляющий связи, такие как навыки, проекты, языки, образование и места работы. Используйте $expand для извлечения связанных коллекций (например, $expand=skills,projects,languages,education,workPositions).

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-onenote-page-contentтолько чтениевнешний мир

HTML-содержимое страницы.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • onenotePageIdstringобязательный

    Value for the 'onenotePageId' path segment. Pass it under the name 'onenotePageId', not as 'id'. Use the 'id' field of the onenote page object as returned by Microsoft Graph.

get-outlook-contactтолько чтениевнешний мир

Извлекает свойства и связи объекта контакта. Есть два сценария, при которых приложение может получить контакт из папки контактов другого пользователя:

Параметры
  • contactIdstringобязательный

    Value for the 'contactId' path segment. Pass it under the name 'contactId', not as 'id'. Use the 'id' field of the contact object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-planner-bucketтолько чтениевнешний мир

Получает свойства и связи объекта plannerBucket. 💡 СОВЕТ: Ответ включает @odata.etag — требуется в качестве If-Match для update-planner-bucket и delete-planner-bucket. Используйте includeHeaders=true.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerBucketIdstringобязательный

    Value for the 'plannerBucketId' path segment. Pass it under the name 'plannerBucketId', not as 'id'. Use the 'id' field of the planner bucket object as returned by Microsoft Graph.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-planner-planтолько чтениевнешний мир

Получает свойства и связи объекта plannerplan.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerPlanIdstringобязательный

    Value for the 'plannerPlanId' path segment. Pass it under the name 'plannerPlanId', not as 'id'. Use the 'id' field of the planner plan object as returned by Microsoft Graph.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-planner-taskтолько чтениевнешний мир

Получает свойства и связи объекта plannerTask. 💡 ПОДСКАЗКА: Ответ включает @odata.etag — сохраните его, требуется в качестве заголовка If-Match для update-planner-task. Используйте includeHeaders=true, чтобы получить его.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerTaskIdstringобязательный

    Value for the 'plannerTaskId' path segment. Pass it under the name 'plannerTaskId', not as 'id'. Use the 'id' field of the planner task object as returned by Microsoft Graph.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-planner-task-detailsтолько чтениевнешний мир

Получает свойства и связи объекта plannerTaskDetails. 💡 СОВЕТ: Ответ содержит @odata.etag — требуется для update-planner-task-details. Используйте includeHeaders=true.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerTaskIdstringобязательный

    Value for the 'plannerTaskId' path segment. Pass it under the name 'plannerTaskId', not as 'id'. Use the 'id' field of the planner task object as returned by Microsoft Graph.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

get-specific-calendar-eventтолько чтениевнешний мир

Получает одно событие из одного из календарей вошедшего в систему пользователя, указанного по идентификатору календаря и идентификатору события. Любой календарь можно указать таким образом, включая календарь по умолчанию.

Параметры
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • expandExtendedPropertiesboolean

    When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • timezonestring

    IANA timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") for calendar event times. If not specified, times are returned in UTC.

get-specific-calendar-viewтолько чтениевнешний мир

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

Параметры
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • endDateTimestringобязательный

    The end date and time of the time range, represented in ISO 8601 format. For example, 2019-11-08T20:00:00-08:00

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • expandExtendedPropertiesboolean

    When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • startDateTimestringобязательный

    The start date and time of the time range, represented in ISO 8601 format. For example, 2019-11-08T19:00:00-08:00

  • timezonestring

    IANA timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") for calendar event times. If not specified, times are returned in UTC.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

get-subscriptionтолько чтениевнешний мир

Получает свойства и отношения подписки. См. таблицу в разделе Permissions для списка ресурсов, поддерживающих подписку на уведомления об изменениях. 💡 СОВЕТ: Получает конкретную подписку webhook по идентификатору. Используйте list-subscriptions, чтобы найти идентификатор. Возвращает полные сведения о подписке, включая resource, changeType, notificationUrl, expirationDateTime, applicationId.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • subscriptionIdstringобязательный

    Value for the 'subscriptionId' path segment. Pass it under the name 'subscriptionId', not as 'id'. Use the 'id' field of the subscription object as returned by Microsoft Graph.

get-todo-taskтолько чтениевнешний мир

Читает свойства и связи объекта todoTask. 💡 СОВЕТ: Возвращает одну задачу To Do. ПРИМЕЧАНИЕ: $select НЕ поддерживается: не передавайте параметр select, иначе Graph вернёт RequestBroker--ParseUri (400). Используйте $expand=linkedResources для включения связанной почты/ресурса. Возвращает содержимое тела (в формате HTML), элементы контрольного списка и связанные ресурсы.

Параметры
  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • todoTaskIdstringобязательный

    Value for the 'todoTaskId' path segment. Pass it under the name 'todoTaskId', not as 'id'. Use the 'id' field of the todo task object as returned by Microsoft Graph.

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

graph-batchвнешний мир

Объединяет до 20 запросов Graph в один HTTP-вызов. Тело: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Возвращает { responses: [{ id, status, body, headers }] } в произвольном порядке — сопоставляйте по id. Варианты использования: (1) распараллеливание множества мелких чтений (например, получить 15 почтовых сообщений по id за один round-trip); (2) последовательность зависимых записей через dependsOn; (3) группировка множества записей диапазонов Excel в один вызов для значительного снижения задержки при сборке больших книг. Примечание: URL каждого подзапроса указывается относительно корня версии Graph (/me/..., /drives/..., НЕ https://graph.microsoft.com/v1.0/...). 💡 СОВЕТ: Объединяет до 20 запросов Graph в один HTTP-вызов. Тело: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Возвращает { responses: [{ id, status, body, headers }] } в произвольном порядке — сопоставляйте по id. Варианты использования: (1) распараллеливание множества мелких чтений (например, получить 15 почтовых сообщений по id за один round-trip); (2) последовательность зависимых записей через dependsOn; (3) группировка множества записей диапазонов Excel в один вызов для значительного снижения задержки при сборке больших книг. Примечание: URL каждого подзапроса указывается относительно корня версии Graph (/me/..., /drives/..., НЕ https://graph.microsoft.com/v1.0/...).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

insert-excel-rangeвнешний мир

Вставляет диапазон Excel. 💡 СОВЕТ: Вставляет пустые ячейки в указанный диапазон, смещая существующее содержимое. Body: { shift: 'Down' } или { shift: 'Right' }. Используйте 'Down', чтобы вставить пустые строки над существующими данными.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

list-accountsтолько чтение

Перечисляет все учетные записи Microsoft, настроенные на этом сервере. Используйте это, чтобы узнать доступные адреса электронной почты учетных записей перед вызовами инструментов. Отражает учетные записи, добавленные во время сеанса через --login.

Параметры

Без параметров.

list-all-onenote-sectionsтолько чтениевнешний мир

Извлекает список объектов onenoteSection. 💡 СОВЕТ: Перечисляет все разделы во всех записных книжках. Вместо этого используйте list-onenote-notebook-sections, чтобы перечислить разделы в конкретной записной книжке.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-calendar-event-instancesтолько чтениевнешний мир

Вхождения повторяющейся серии, если событие является основным событием серии. Это свойство включает вхождения, которые являются частью шаблона повторения, и изменённые исключения, но не включает вхождения, отменённые из серии. Свойство навигации. Только для чтения. Допускает значение null. 💡 СОВЕТ: Разверните повторяющееся событие в отдельные вхождения в пределах диапазона дат. Требуются параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Используйте это, чтобы увидеть все вхождения повторяющегося события.

Параметры
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • endDateTimestringобязательный

    The end date and time of the time range, represented in ISO 8601 format. For example, 2019-11-08T20:00:00-08:00

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • expandExtendedPropertiesboolean

    When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • startDateTimestringобязательный

    The start date and time of the time range, represented in ISO 8601 format. For example, 2019-11-08T19:00:00-08:00

  • timezonestring

    IANA timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") for calendar event times. If not specified, times are returned in UTC.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-calendar-eventsтолько чтениевнешний мир

Получает список объектов событий в почтовом ящике пользователя. Список содержит отдельные встречи и основные серии (series masters). Чтобы получить развернутые экземпляры событий, можно получить представление календаря или получить экземпляры события. В настоящее время эта операция возвращает тела событий только в формате HTML. Существует два сценария, в которых приложение может получать события в календаре другого пользователя: 💡 СОВЕТ: ПРЕДУПРЕЖДЕНИЕ: НЕ разворачивает повторяющиеся события — возвращает только seriesMaster. Вместо этого используйте get-calendar-view для просмотра отдельных вхождений в серии.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • expandExtendedPropertiesboolean

    When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • timezonestring

    IANA timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") for calendar event times. If not specified, times are returned in UTC.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-calendar-events-deltaтолько чтениевнешний мир

Получает набор ресурсов событий, которые были добавлены, удалены или обновлены в calendarView (диапазон событий, заданный датами начала и окончания) основного календаря пользователя. Обычно синхронизация событий в calendarView в локальном хранилище включает серию из нескольких дельта-вызовов. Первый вызов — полная синхронизация, каждый последующий дельта-вызов в той же серии получает инкрементальные изменения (добавления, удаления или обновления). Так вы поддерживаете и синхронизируете локальное хранилище событий в указанном calendarView, не загружая все события этого календаря с сервера каждый раз. 💡 СОВЕТ: Инкрементальная синхронизация событий в календаре по умолчанию. Первый вызов возвращает все события и @odata.deltaLink. Последующие вызовы с этой ссылкой возвращают только добавления/обновления/удаления. Используйте $select, чтобы ограничить поля. Дельта истекает через ~30 дней — начните заново, если сервер возвращает 410 Gone. Для ограниченного по времени представления с дельта-семантикой используйте list-calendar-view-delta.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • endDateTimestringобязательный

    The end date and time of the time range in the function, represented in ISO 8601 format. For example, 2019-11-08T20:00:00-08:00

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • startDateTimestringобязательный

    The start date and time of the time range in the function, represented in ISO 8601 format. For example, 2019-11-08T20:00:00-08:00

list-calendarsтолько чтениевнешний мир

Получает все календари пользователя (свойство навигации /calendars), получает календари из группы календарей по умолчанию или из конкретной группы календарей.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-calendar-view-deltaтолько чтениевнешний мир

Получает набор ресурсов событий, которые были добавлены, удалены или обновлены в представлении calendarView (диапазон событий, заданный датами начала и окончания) основного календаря пользователя. Обычно синхронизация событий в calendarView в локальном хранилище включает несколько вызовов дельта-функции. Первый вызов — полная синхронизация, а каждый последующий вызов дельты в том же раунде получает инкрементальные изменения (добавления, удаления или обновления). Это позволяет поддерживать и синхронизировать локальное хранилище событий в указанном calendarView, без необходимости каждый раз загружать все события этого календаря с сервера. 💡 СОВЕТ: Инкрементальная синхронизация событий в пределах временного окна. Обязательные параметры запроса при первом вызове: startDateTime, endDateTime (ISO 8601). Возвращает события в окне плюс @odata.deltaLink; последующие вызовы с этой ссылкой возвращают только изменения. Разворачивает повторяющиеся события в отдельные экземпляры (в отличие от list-calendar-events-delta, который возвращает основное повторяющееся событие). Используйте для календарных интерфейсов, показывающих диапазон дат.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • endDateTimestringобязательный

    The end date and time of the time range in the function, represented in ISO 8601 format. For example, 2019-11-08T20:00:00-08:00

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • startDateTimestringобязательный

    The start date and time of the time range in the function, represented in ISO 8601 format. For example, 2019-11-08T20:00:00-08:00

list-contact-folder-child-foldersтолько чтениевнешний мир

Получает коллекцию дочерних папок в указанной контактной папке. 💡 ПОДСКАЗКА: Перечисляет непосредственные подпапки в заданной контактной папке. Возвращает id, displayName, parentFolderId. Используйте list-contact-folders, чтобы найти папки верхнего уровня, а затем этот инструмент, чтобы спуститься на один уровень глубже. Поддерживает $filter, $top, $orderby. Примечание: контактные папки обычно представляют собой плоский список в клиентах Outlook, но Graph позволяет вкладывать папки с помощью этого инструмента.

Параметры
  • contactFolderIdstringобязательный

    Value for the 'contactFolderId' path segment. Pass it under the name 'contactFolderId', not as 'id'. Use the 'id' field of the contact folder object as returned by Microsoft Graph.

  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-contact-folder-contactsтолько чтениевнешний мир

Получает коллекцию контактов из папки "Контакты" по умолчанию для вошедшего в систему пользователя (.../me/contacts) или из указанной папки контактов. 💡 СОВЕТ: Выводит список контактов внутри определённой папки. Используйте вместе с list-contact-folders, чтобы узнать идентификатор папки. Примечание: существующий list-outlook-contacts (GET /me/contacts) возвращает контакты только из папки по умолчанию, используйте этот инструмент для чтения контактов из любой папки. Поддерживает $filter, $search='query', $orderby, $top, $select.

Параметры
  • contactFolderIdstringобязательный

    Value for the 'contactFolderId' path segment. Pass it under the name 'contactFolderId', not as 'id'. Use the 'id' field of the contact folder object as returned by Microsoft Graph.

  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-contact-foldersтолько чтениевнешний мир

Получает коллекцию папок контактов в папке Контакты по умолчанию вошедшего в систему пользователя. 💡 ПОДСКАЗКА: Перечисляет папки контактов Outlook пользователя (именованные контейнеры, которые организуют контакты). Всегда включает встроенную папку 'Contacts'; также отображаются папки, созданные пользователем. Возвращает id, displayName и parentFolderId. Чтобы определить папку по умолчанию, сравните displayName === 'Contacts'. Используйте это перед list-contact-folder-contacts или create-contact-in-folder для поиска идентификаторов папок. Поддерживает OData-запросы.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-drive-item-permissionsтолько чтениевнешний мир

Набор разрешений для элемента. Только для чтения. Допускает значение null. 💡 СОВЕТ: Перечисляет все разрешения (ссылки для общего доступа, прямой доступ, унаследованные) для файла или папки. Каждое разрешение имеет роли, grantedTo (пользователь), link (URL общего доступа) и inheritedFrom.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-drive-item-thumbnailsтолько чтениевнешний мир

Коллекция объектов thumbnailSet, связанных с элементом. Для получения дополнительной информации см. раздел getting thumbnails. Только для чтения. Допускает значение null. 💡 СОВЕТ: Перечисляет наборы миниатюр для файла. Каждый набор содержит миниатюры маленького (96px), среднего (176px), большого (800px) размера с URL и размерами. Возвращает пустой результат для неподдерживаемых типов (текстовые документы). Используйте $select=small,medium,large или $expand=small($select=url) для получения конкретных размеров. Возвращаемые URL-адреса имеют короткий срок действия — загружайте данные немедленно.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-drive-item-versionsтолько чтениевнешний мир

Список предыдущих версий элемента. Подробнее см. в разделе получения предыдущих версий. Только для чтения. Допускает значение null. 💡 СОВЕТ: Выводит историю версий файла. У каждой версии есть id, lastModifiedDateTime, lastModifiedBy и size. Используйте идентификатор версии с /versions/{id}/content, чтобы скачать конкретную версию.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-drivesтолько чтениевнешний мир

Получает список ресурсов Drive, доступных для целевого пользователя, группы или сайта.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-excel-table-rowsтолько чтениевнешний мир

Список всех строк в таблице. Только для чтения. 💡 СОВЕТ: Перечисляет все строки в таблице. Каждая строка содержит индекс и значения (массив значений ячеек). Используйте $top и $skip для постраничной навигации по большим таблицам.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

  • workbookTableIdstringобязательный

    Value for the 'workbookTableId' path segment. Pass it under the name 'workbookTableId', not as 'id'. Use the 'id' field of the workbook table object as returned by Microsoft Graph.

list-excel-tablesтолько чтениевнешний мир

Коллекция таблиц, связанных с рабочей книгой. Только для чтения. 💡 СОВЕТ: Перечисляет все именованные таблицы в рабочей книге. Каждая таблица имеет id, name, showHeaders, showTotals, columns и style. Используйте имя таблицы или id с другими endpoints таблицы.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-excel-worksheetsтолько чтениевнешний мир

Представляет коллекцию листов, связанных с рабочей книгой. Только для чтения.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-focused-inbox-overridesтолько чтениевнешний мир

Получает переопределения, которые пользователь настроил для постоянной классификации сообщений от определённых отправителей определённым образом. Каждое переопределение соответствует SMTP-адресу отправителя. Изначально у пользователя нет переопределений. 💡 СОВЕТ: Перечисляет переопределения классификации Focused Inbox — явные правила, которые принудительно помещают сообщения от заданного отправителя (по SMTP-адресу) на вкладку Focused или Other, независимо от того, что предсказал бы классификатор Outlook ML. Каждое переопределение содержит id, classifyAs ('focused' или 'other') и senderEmailAddress {name, address}. Возвращает пустую коллекцию, если пользователь никогда не задавал переопределения.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-folder-filesтолько чтениевнешний мир

Возвращает коллекцию DriveItems в отношении children для DriveItem. DriveItems с непустым аспектом folder или package могут иметь один или несколько дочерних DriveItems.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-mail-attachmentsтолько чтениевнешний мир

Получает список объектов вложений. 💡 СОВЕТ: Выводит список вложений сообщения: id, name, contentType, size, isInline. Чтобы загрузить байты, вызовите download-bytes с параметром target=/me/messages/{message-id}/attachments/{attachment-id}/$value (суффикс /$value возвращает необработанные байты; простой URL вложения встраивает contentBytes в JSON, что может обрезать большие файлы).

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-mail-child-foldersтолько чтениевнешний мир

Получает коллекцию папок в указанной папке. Вы можете использовать сокращение .../me/mailFolders, чтобы получить коллекцию папок верхнего уровня и перейти к другой папке. По умолчанию эта операция не возвращает скрытые папки. Используйте параметр запроса includeHiddenFolders, чтобы включить их в ответ.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • includeHiddenFoldersstring

    Include Hidden Folders

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-mail-folder-messagesтолько чтениевнешний мир

Получает все сообщения в почтовом ящике указанного пользователя или сообщения в указанной папке этого почтового ящика. 💡 СОВЕТ: Выводит список, читает и ищет письма Outlook в указанной почтовой папке. КРИТИЧНО: При поиске писем значение параметра $search ОБЯЗАТЕЛЬНО должно быть заключено в двойные кавычки. Формат: $search="ваш поисковый запрос здесь". Используйте синтаксис KQL (Keyword Query Language) для поиска по конкретным свойствам: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Примеры: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:alice AND importance:high". Помните: ВСЕГДА заключайте всё поисковое выражение в двойные кавычки! Ссылка: https://learn.microsoft.com/en-us/graph/search-query-parameter ВАЖНО: Всегда используйте $select для ограничения возвращаемых полей и уменьшения размера ответа. Рекомендуемый набор по умолчанию: $select=id,subject,from,toRecipients,receivedDateTime,bodyPreview,isRead,hasAttachments. Для списков используйте bodyPreview вместо body. Чтобы прочитать полное тело письма, используйте get-mail-message с указанием идентификатора конкретного сообщения.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-mail-folder-messages-deltaтолько чтениевнешний мир

Получает набор сообщений, добавленных, удалённых или обновлённых в указанной папке. Вызов дельта-функции для сообщений в папке аналогичен запросу GET, за исключением того, что, правильно применяя токены состояния в одном или нескольких таких вызовах, вы можете запрашивать инкрементальные изменения сообщений в этой папке. Она позволяет поддерживать и синхронизировать локальное хранилище сообщений пользователя без необходимости каждый раз получать полный набор сообщений с сервера. 💡 СОВЕТ: Инкрементальная синхронизация сообщений в почтовой папке. Graph поддерживает дельту только в пределах папки: используйте mailFolder-id = 'inbox' для стандартного входящего, или другой идентификатор папки из list-mail-folders. Первый вызов возвращает все сообщения плюс @odata.deltaLink; последующие вызовы с этой ссылкой возвращают только изменения (созданные/обновлённые/удалённые). @odata.nextLink разбивает на страницы в рамках одного окна дельты. Дельта-токены истекают примерно через 30 дней бездействия. Начните заново, если сервер возвращает 410. Предпочитайте это полному повторному списку для опроса.

Параметры
  • changeTypestring

    A custom query option to filter the delta response based on the type of change. Supported values are created, updated or deleted.

  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-mail-foldersтолько чтениевнешний мир

Получает коллекцию почтовых папок, находящихся непосредственно в корневой папке вошедшего пользователя. Возвращаемая коллекция включает любые почтовые папки поиска, находящиеся непосредственно в корне. По умолчанию эта операция не возвращает скрытые папки. Используйте параметр запроса includeHiddenFolders, чтобы включить их в ответ. Эта операция не возвращает все почтовые папки в почтовом ящике, а только дочерние папки корневой папки. Чтобы вернуть все почтовые папки в почтовом ящике, необходимо перебрать каждую дочернюю папку отдельно.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • includeHiddenFoldersstring

    Include Hidden Folders

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-mail-messagesтолько чтениевнешний мир

Перечисляет, ищет и фильтрует сообщения электронной почты Outlook в почтовом ящике текущего пользователя по всем папкам. Возвращает метаданные сообщения (тема, отправитель, дата получения, прочитано, есть вложения), а также предпросмотр тела письма. Используйте $search для запросов по ключевым словам, $filter для фильтрации по отправителю/состоянию прочтения/дате, $top для ограничения размера страницы и $select для сокращения полей. 💡 СОВЕТ: перечисляйте, читайте и ищите мои письма Outlook по всем папкам. КРИТИЧЕСКИ ВАЖНО: при поиске писем значение параметра $search ОБЯЗАТЕЛЬНО должно быть заключено в двойные кавычки. Формат: $search="ваш поисковый запрос". Используйте синтаксис KQL (Keyword Query Language) для поиска по конкретным свойствам: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Примеры: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:john AND importance:high". Помните: ВСЕГДА заключайте всё поисковое выражение в двойные кавычки! Ссылка: https://learn.microsoft.com/en-us/graph/search-query-parameter ВАЖНО: всегда используйте $select для ограничения возвращаемых полей и уменьшения размера ответа. Рекомендуемый набор по умолчанию: $select=id,subject,from,toRecipients,receivedDateTime,bodyPreview,isRead,hasAttachments. Для списков используйте bodyPreview вместо body. Чтобы прочитать полное тело письма, используйте get-mail-message с конкретным идентификатором сообщения.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • includeHiddenMessagesstring

    Include Hidden Messages

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-mail-rulesтолько чтениевнешний мир

Получает все объекты messageRule, определённые для папки "Входящие" пользователя. 💡 TIP: Перечисляет все правила сообщений для почтовой папки. Используйте идентификатор папки Inbox (получите его из list-mail-folders) для правил входящих сообщений. Каждое правило включает displayName, sequence, isEnabled, conditions (fromAddresses, subjectContains и т.д.), actions (moveToFolder, forwardTo, delete и т.д.) и exceptions.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-my-calendar-permissionsтолько чтениевнешний мир

Разрешения пользователей, которым предоставлен доступ к календарю. 💡 Совет: Перечисляет получателей общего доступа и делегатов в основном календаре пользователя. Возвращает объекты calendarPermission с полями id, role ('none' | 'freeBusyRead' | 'limitedRead' | 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' | 'custom'), emailAddress { name, address }, isInsideOrganization, isRemovable, allowedRoles. Возвращает пустую коллекцию при вызове делегатом или получателем доступа (только владелец календаря видит полный список). Для неосновного календаря используйте /me/calendars/{calendar-id}/calendarPermissions — в настоящее время не раскрыта.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-onenote-notebooksтолько чтениевнешний мир

Получает список объектов notebook.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-onenote-notebook-sectionsтолько чтениевнешний мир

Извлекает список объектов onenoteSection из указанной записной книжки.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • notebookIdstringобязательный

    Value for the 'notebookId' path segment. Pass it under the name 'notebookId', not as 'id'. Use the 'id' field of the notebook object as returned by Microsoft Graph.

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-onenote-pagesтолько чтениевнешний мир

Получает список объектов страниц. 💡 СОВЕТ: Перечисляет все страницы OneNote в каждой записной книжке и разделе, к которым у пользователя есть доступ — поперечная альтернатива обходу записных книжек → разделов → страниц. По умолчанию возвращает первые 20, отсортированные по lastModifiedTime по убыванию. Поддерживает $filter (например, lastModifiedTime gt 2026-01-01 или contains(tolower(title), 'topic') для поиска по заголовку), $top (макс. 100), $select и $expand=parentNotebook,parentSection. Используйте этот метод вместо перебора list-onenote-notebooks / list-all-onenote-sections / list-onenote-section-pages, когда у вас есть конкретная тема.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-onenote-section-groupsтолько чтениевнешний мир

Получает список объектов sectionGroup. 💡 СОВЕТ: Выводит все группы разделов OneNote (подпапки внутри блокнотов, содержащие собственные разделы и вложенные группы разделов) для пользователя. Группа разделов - это контейнер, похожий на папку. Многие блокноты используют их для организации разделов по темам. Сортировка по умолчанию - по имени по возрастанию. Поддерживает $expand=sections,sectionGroups,parentNotebook,parentSectionGroup для обхода полной иерархии. Используйте вместе с list-onenote-notebooks для полной картины структуры блокнотов пользователя.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-onenote-section-pagesтолько чтениевнешний мир

Извлекает список объектов страницы из указанного раздела.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • onenoteSectionIdstringобязательный

    Value for the 'onenoteSectionId' path segment. Pass it under the name 'onenoteSectionId', not as 'id'. Use the 'id' field of the onenote section object as returned by Microsoft Graph.

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-outlook-categoriesтолько чтениевнешний мир

Получает все категории, которые были определены для пользователя. 💡 СОВЕТ: Перечисляет категории Outlook пользователя (цветные метки), используемые для пометки сообщений, событий, контактов и задач. Каждая категория имеет displayName и color (preset0 – preset24 или 'none'). Используйте это, чтобы показать доступные метки перед применением через update-mail-message или update-calendar-event с телом { categories: ['categoryName'] }.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-outlook-contactsтолько чтениевнешний мир

Получает коллекцию контактов из папки контактов по умолчанию вошедшего в систему пользователя. Есть два сценария, в которых приложение может получить контакты из папки контактов другого пользователя: 💡 СОВЕТ: $filter поддерживает только startswith(), а contains() и eq для emailAddresses не работают. Используйте $search как альтернативу для более широкого поиска.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-plan-bucketsтолько чтениевнешний мир

Возвращает список объектов plannerBucket, содержащихся в объекте plannerPlan.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • plannerPlanIdstringобязательный

    Value for the 'plannerPlanId' path segment. Pass it under the name 'plannerPlanId', not as 'id'. Use the 'id' field of the planner plan object as returned by Microsoft Graph.

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-planner-task-messagesтолько чтениевнешний мир

[beta] Получает список объектов plannerTaskChatMessage, связанных с задачей plannerTask. 💡 СОВЕТ: Выводит список сообщений в чате задачи Planner — современный "чат задачи" Planner, в отличие от устаревших комментариев conversationThreadId (которые находятся в ветке обсуждения группы M365). Каждое сообщение содержит id, content (HTML), createdBy, createdDateTime, mentions, reactions. BETA Graph API: может меняться; только делегированные рабочие/учебные учетные записи — без разрешений приложений, без личных учетных записей Microsoft, только глобальное облако (не GCC/DoD/21Vianet).

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • plannerTaskIdstringобязательный

    Value for the 'plannerTaskId' path segment. Pass it under the name 'plannerTaskId', not as 'id'. Use the 'id' field of the planner task object as returned by Microsoft Graph.

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-planner-tasksтолько чтениевнешний мир

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

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-plan-tasksтолько чтениевнешний мир

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

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • plannerPlanIdstringобязательный

    Value for the 'plannerPlanId' path segment. Pass it under the name 'plannerPlanId', not as 'id'. Use the 'id' field of the planner plan object as returned by Microsoft Graph.

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-specific-calendar-eventsтолько чтениевнешний мир

Перечисляет события из одного из календарей вошедшего в систему пользователя, заданного по calendar ID. 💡 ПОДСКАЗКА: ВНИМАНИЕ: НЕ разворачивает повторяющиеся события — возвращает только seriesMaster. Вместо этого используйте get-specific-calendar-view.

Параметры
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • expandExtendedPropertiesboolean

    When true, expands singleValueExtendedProperties on each event. Use this to retrieve custom extended properties (e.g., sync metadata) stored on calendar events.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • timezonestring

    IANA timezone name (e.g., "America/New_York", "Europe/London", "Asia/Tokyo") for calendar event times. If not specified, times are returned in UTC.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-subscriptionsтолько чтениевнешний мир

Получает свойства и связи подписок webhook на основе идентификатора приложения, пользователя и его роли в клиенте. Содержимое ответа зависит от контекста, в котором приложение выполняет вызов; подробности — в сценариях раздела Permissions. 💡 Совет: выводит список подписок webhook, принадлежащих текущему приложению или пользователю. Возвращает id, resource, changeType, notificationUrl, expirationDateTime, clientState. Используйте $filter=resource eq '/me/messages', чтобы найти подписки для конкретного ресурса. Отдельной области действия 'Subscription.*' не существует — вызывающая сторона уже должна иметь разрешение на чтение подписанного ресурса (например, Mail.Read для /me/messages), которое предоставляет инструмент, читающий этот ресурс.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-supported-languagesтолько чтениевнешний мир

Получает список языков и региональных параметров, поддерживаемых для пользователя и настроенных на его почтовом сервере. При настройке клиента Outlook пользователь выбирает предпочитаемый язык из этого списка поддерживаемых. После этого вы можете получить предпочитаемый язык, получив настройки почтового ящика пользователя. 💡 СОВЕТ: Перечисляет языки и региональные параметры, которые почтовый сервер пользователя поддерживает для интерфейса Outlook и отображения сообщений. Возвращает объекты localeInfo с параметром locale (например, 'en-US') и displayName ('English (United States)'). Используйте это для проверки значения locale перед вызовом update-mailbox-settings для изменения предпочитаемого языка пользователя.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-supported-time-zonesтолько чтениевнешний мир

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

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • TimeZoneStandardstringобязательный

    Value for the 'TimeZoneStandard' path segment.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-todo-linked-resourcesтолько чтениевнешний мир

Получает информацию об одном или нескольких элементах в партнёрском приложении, на основании которых была создана указанная задача. Информация представлена в объекте linkedResource для каждого элемента. Она включает внешний идентификатор элемента в партнёрском приложении и, если применимо, глубокую ссылку на этот элемент в приложении. 💡 СОВЕТ: Перечисляет ресурсы, связанные с задачей To Do (электронные письма, URL-адреса и т.д.). Каждый связанный ресурс имеет displayName, webUrl, applicationName и deepLink.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • todoTaskIdstringобязательный

    Value for the 'todoTaskId' path segment. Pass it under the name 'todoTaskId', not as 'id'. Use the 'id' field of the todo task object as returned by Microsoft Graph.

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-todo-task-listsтолько чтениевнешний мир

Получает список объектов todoTaskList и их свойства. 💡 СОВЕТ: Перечисляет все списки задач. Возвращает todoTaskList-id, необходимый для всех операций с задачами. Список по умолчанию обычно называется 'Tasks'. ПРИМЕЧАНИЕ: $select НЕ поддерживается этой конечной точкой - не передавайте параметр select, Graph возвращает 400.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

list-todo-tasksтолько чтениевнешний мир

Получает ресурсы todoTask из навигационного свойства tasks указанного todoTaskList. 💡 СОВЕТ: Выводит задачи в списке To Do. Требуется todoTaskList-id - используйте list-todo-task-lists, чтобы найти его. ПРИМЕЧАНИЕ: $select НЕ поддерживается - не передавайте select, Graph возвращает код 400. Используйте $filter=status eq 'notStarted' или $filter=status eq 'completed', чтобы отфильтровать по статусу. Используйте $top для ограничения количества результатов. Возможные значения статуса: 'notStarted', 'inProgress', 'completed', 'waitingOnOthers', 'deferred'.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

login

Аутентифицирует с учётной записью Microsoft

Параметры
  • forceboolean

    Force a new login even if already logged in

logout

Выйти из учетной записи Microsoft

Параметры

Без параметров.

merge-excel-rangeвнешний мир

Объединяет диапазон Excel. 💡 СОВЕТ: Объединяет ячейки в указанном диапазоне в одну ячейку. Body: { across: false } объединяет весь диапазон в одну ячейку; { across: true } объединяет каждую строку отдельно. Пригодится для создания стилизованных заголовков, баннерных строк и макетов отчетов.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

move-mail-messageвнешний мир

Перемещает сообщение в другую папку в почтовом ящике указанного пользователя. Это создаёт новую копию сообщения в целевой папке и удаляет исходное сообщение. 💡 СОВЕТ: destinationId принимает идентификатор папки или стандартное имя (inbox, drafts, sentitems, deleteditems, junkemail, archive).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

move-rename-onedrive-itemвнешний мир

Перемещает или переименовывает элемент OneDrive. 💡 СОВЕТ: Перемещает и/или переименовывает файл или папку. Чтобы переместить, укажите parentReference с id целевой папки. Чтобы переименовать, укажите новое имя. Обе операции можно выполнить в одном запросе.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

parse-teams-urlтолько чтение

Преобразует любой формат URL собрания Teams (короткий /meet/, полный /meetup-join/ или recap с ?threadId=) в стандартный joinWebUrl. Используйте этот инструмент перед list-online-meetings, когда пользователь предоставляет recap или короткий URL.

Параметры
  • urlstringобязательный

    Teams meeting URL in any format

reauthorize-subscriptionвнешний мир

Переавторизует подписку при получении запроса reauthorizationRequired. 💡 СОВЕТ: Повторно авторизует подписку после получения уведомления жизненного цикла 'reauthorizationRequired' от Microsoft Graph. Тело запроса не требуется. Вызов должен производиться в окне reauthorizationRequiredDateTime (обычно 48 часов), чтобы избежать истечения срока подписки.

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • subscriptionIdstringобязательный

    Value for the 'subscriptionId' path segment. Pass it under the name 'subscriptionId', not as 'id'. Use the 'id' field of the subscription object as returned by Microsoft Graph.

remove-account

Удаляет учётную запись Microsoft из кеша. Принимает адрес электронной почты (например, user@outlook.com) или идентификатор учётной записи. Используйте list-accounts, чтобы узнать доступные учётные записи.

Параметры
  • accountstringобязательный

    Email address or account ID of the account to remove

reply-all-mail-messageвнешний мир

Отвечает всем получателям сообщения в формате JSON или MIME. При использовании формата JSON: - Укажите либо comment, либо свойство body параметра message. Указание обоих приведет к ошибке HTTP 400 Bad Request. - Если исходное сообщение указывает получателя в свойстве replyTo в соответствии с Internet Message Format (RFC 2822), отправляет ответ получателям из replyTo, а не получателю из свойства from. При использовании формата MIME: - Укажите соответствующие заголовки интернет-сообщения и MIME-содержимое, закодированные в формате base64 в теле запроса. - Добавьте любые вложения и свойства S/MIME в MIME-содержимое. Этот метод сохраняет сообщение в папке Sent Items. Альтернативно, создайте черновик для ответа всем на сообщение и отправьте его позже. 💡 СОВЕТ: Ответ всем с сохранением полного HTML-форматирования. Поле 'comment' — ваш текст.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

reply-mail-messageвнешний мир

Отвечает отправителю сообщения в формате JSON или MIME. При использовании формата JSON: * Указывайте либо свойство comment, либо свойство body параметра message. Указание обоих вернёт ошибку HTTP 400 Bad Request. * Если исходное сообщение содержит получателя в свойстве replyTo, в соответствии с Internet Message Format (RFC 2822), отправляйте ответ получателям из replyTo, а не получателю из свойства from. При использовании формата MIME: - Предоставьте соответствующие заголовки Internet Message и содержимое MIME, закодированные в base64, в теле запроса. - Добавьте любые вложения и свойства S/MIME в содержимое MIME. Этот метод сохраняет сообщение в папке Sent Items. Либо создайте черновик для ответа на существующее сообщение и отправьте его позже. 💡 TIP: Отвечайте на письмо с сохранением полного HTML-форматирования. Поле 'comment' содержит текст вашего ответа. НЕ восстанавливайте письмо вручную.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

search-onedrive-filesтолько чтениевнешний мир

Ищет элементы в иерархии по заданному запросу. Можно искать в иерархии папок, на всём диске или среди файлов, к которым у текущего пользователя есть доступ. 💡 СОВЕТ: Ищет файлы на диске по имени или содержимому. Параметр q проверяет имена файлов, метаданные и содержимое файлов. Возвращает подходящие объекты driveItem с полями id, name, webUrl, size, lastModifiedDateTime. Сначала используйте list-drives, чтобы получить идентификатор диска.

Параметры
  • countboolean

    Set true to enable advanced query mode (ConsistencyLevel: eventual). Required for complex $filter on flag/flagStatus or contains().

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • expandstring[]

    Navigation properties to inline, e.g. attachments on a message or event. Only navigation properties can be expanded: expanding a non-navigation property such as a message body fails with "Parsing OData Select and Expand failed", and an unsupported value may be ignored rather than reported. Request ordinary fields with $select instead.

  • fetchAllPagesboolean

    Follow @odata.nextLink and merge up to 100 pages into one response. Can return enormous payloads—only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.

  • filterstring

    OData filter expression. Add $count=true for advanced filters (flag/flagStatus, contains()). Cannot combine with $search.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • qstringобязательный

    Value for the 'q' path segment.

  • searchstring

    KQL search query in one pair of double quotes; directory (users/groups) instead quotes each clause with no outer pair. Cannot combine with $filter.

  • selectstring

    Comma-separated fields to return, e.g. id,subject,from,receivedDateTime

  • skipnumber

    Items to skip for pagination. Not supported with $search.

  • topnumber

    Page size (Graph $top). Start small (e.g. 5–15) so responses fit the model context; raise only if needed. Use $select to return fewer fields per item. For more rows, use @odata.nextLink from the response instead of a very large $top.

select-account

Выбирает учётную запись Microsoft по умолчанию. Принимает адрес электронной почты (например, user@outlook.com) или идентификатор учётной записи. Используйте list-accounts, чтобы найти доступные учётные записи.

Параметры
  • accountstringобязательный

    Email address or account ID of the account to select

send-draft-messageвнешний мир

Отправляет существующий черновик сообщения. Черновик может быть новым черновиком, черновиком ответа, черновиком ответа всем или черновиком пересылки. Этот метод сохраняет сообщение в папке "Отправленные". Альтернативно, отправляет новое сообщение одной операцией. 💡 СОВЕТ: тело запроса не требуется — просто вызовите с идентификатором сообщения. Черновик должен существовать в папке "Черновики".

Параметры
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

send-mailвнешний мир

Отправляет сообщение, указанное в теле запроса, в формате JSON или MIME. При использовании формата JSON вы можете включить вложение файла в тот же вызов действия sendMail. При использовании формата MIME: этот метод сохраняет сообщение в папке «Отправленные». Кроме того, можно создать черновик сообщения для отправки позже. Чтобы узнать больше о шагах, выполняемых в бэкенде перед доставкой письма получателям, смотрите здесь. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

share-drive-itemвнешний мир

Отправляет приглашение к совместному доступу для driveItem. Приглашение к совместному доступу предоставляет разрешения получателям и, опционально, отправляет им email с уведомлением о том, что элемент был опубликован. 💡 ПОДСКАЗКА: Предоставляет общий доступ к файлу или папке конкретным пользователям. Тело: { recipients: [{ email: 'user@example.com' }], roles: ['read'], sendInvitation: true, message: 'Please review this file.' }. Роли: 'read', 'write', 'owner'. Установите requireSignIn в true, чтобы требовать вход в систему.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

snooze-calendar-event-reminderвнешний мир

Откладывает напоминание о событии в календаре пользователя до нового времени. 💡 СОВЕТ: Откладывает уже сработавшее напоминание о событии. Тело: { NewReminderTime: { dateTime (ISO 8601), timeZone (IANA or Windows, например 'Pacific Standard Time') } }. Напоминание сработает заново в новое время.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

sort-excel-rangeвнешний мир

Сортирует диапазон Excel.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

tentatively-accept-calendar-eventвнешний мир

Предварительно принимает указанное событие в календаре пользователя. Если событие допускает предложения нового времени, при ответе «Предварительно принято» на событие участник может предложить альтернативное время, указав параметр proposedNewTime. Дополнительную информацию о том, как предложить время и как получить и принять новое предложение времени, см. в разделе Propose new meeting times. 💡 СОВЕТ: Предварительно принимает приглашение на встречу. Необязательное тело: { sendResponse: true, comment: 'I might be able to attend.' }. Используйте proposedNewTime, чтобы предложить альтернативу: { proposedNewTime: { start: { dateTime, timeZone }, end: { dateTime, timeZone } } }.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

unmerge-excel-rangeвнешний мир

Отменяет объединение диапазона Excel. 💡 TIP: Отменяет объединение всех объединённых ячеек в указанном диапазоне обратно в отдельные ячейки. Без тела запроса. Обратная операция к merge-excel-range.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

update-calendarвнешний мир

Обновляет календарь. 💡 СОВЕТ: Обновляет свойства календаря. Тело: { name: 'New Name', color: 'lightBlue' }. Не обновляет свойства календаря по умолчанию.

Параметры
  • bodyobjectобязательный
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

update-calendar-eventвнешний мир

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

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

update-contact-folderвнешний мир

Обновляет свойства объекта contactfolder. 💡 СОВЕТ: Обновляет контактную папку. Тело: { displayName?: 'New name', parentFolderId?: '<id>' } — оба свойства displayName (переименование) и parentFolderId (перемещение) доступны для записи. Папку 'Contacts' по умолчанию, возможно, нельзя переименовать. Получите идентификатор папки через list-contact-folders.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • contactFolderIdstringобязательный

    Value for the 'contactFolderId' path segment. Pass it under the name 'contactFolderId', not as 'id'. Use the 'id' field of the contact folder object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

update-excel-rangeвнешний мир

Обновляет диапазон Excel. 💡 СОВЕТ: Задаёт значения ячеек, формулы или числовой формат для любого диапазона — НЕ требует, чтобы лист был формальной таблицей Excel. Body: { values: [['v1','v2','v3']] } для одной строки или [['a','b'],['c','d']] для нескольких строк. Используйте это для добавления (укажите адрес следующей пустой строки, например 'A172:H172'), обновления (укажите отдельную ячейку типа 'H42') или вставки в начало (прочитайте существующие данные, объедините, запишите обратно). Количество значений во внутреннем массиве должно соответствовать количеству столбцов диапазона.

Параметры
  • addressstringобязательный

    Value for the 'address' path segment.

  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • workbookWorksheetIdstringобязательный

    Value for the 'workbookWorksheetId' path segment. Pass it under the name 'workbookWorksheetId', not as 'id'. Use the 'id' field of the workbook worksheet object as returned by Microsoft Graph.

update-excel-table-rowвнешний мир

Обновляет строку таблицы Excel. 💡 СОВЕТ: Обновляет одну строку в формальной таблице Excel по индексу строки, начиная с нуля. Тело: { values: [[...]] } с одним внутренним массивом, соответствующим количеству столбцов.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • indexstringобязательный

    Value for the 'index' path segment.

  • workbookTableIdstringобязательный

    Value for the 'workbookTableId' path segment. Pass it under the name 'workbookTableId', not as 'id'. Use the 'id' field of the workbook table object as returned by Microsoft Graph.

update-focused-inbox-overrideвнешний мир

Изменяет поле classifyAs переопределения в соответствии с заданными параметрами. Нельзя использовать PATCH для изменения любых других полей в экземпляре inferenceClassificationOverride. Если для отправителя существует переопределение и отправитель меняет свое отображаемое имя, вы можете использовать POST, чтобы принудительно обновить поле имени в существующем переопределении. Если для отправителя существует переопределение и отправитель меняет свой SMTP-адрес, удаление существующего переопределения и создание нового с новым SMTP-адресом — единственный способ «обновить» переопределение для этого отправителя. 💡 СОВЕТ: Обновляет поле classifyAs существующего переопределения. Тело: { classifyAs: 'focused' } или { classifyAs: 'other' }. Согласно Graph API, PATCH не может изменить senderEmailAddress — чтобы изменить SMTP-адрес, удалите и создайте переопределение заново. Чтобы переименовать только отображаемое имя, отправьте POST нового переопределения с тем же SMTP-адресом (оно перезапишет имя).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • inferenceClassificationOverrideIdstringобязательный

    Value for the 'inferenceClassificationOverrideId' path segment. Pass it under the name 'inferenceClassificationOverrideId', not as 'id'. Use the 'id' field of the inference classification override object as returned by Microsoft Graph.

update-mailbox-settingsвнешний мир

Включает, настраивает или отключает одну или несколько следующих настроек как часть mailboxSettings пользователя. При обновлении предпочтительного формата даты или времени для пользователя указывайте его в формате краткой даты или краткого времени соответственно. При обновлении предпочтительного часового пояса пользователя указывайте его в часовом поясе Windows или Internet Assigned Numbers Authority (IANA) (также известном как часовой пояс Олсона). Вы также можете дополнительно настроить часовой пояс, как показано в примере 2 ниже. 💡 TIP: Обновляет настройки почтового ящика. Типичное использование: настройка автоответа (автоматических ответов). Пример тела запроса: { automaticRepliesSetting: { status: 'scheduled', scheduledStartDateTime: { dateTime: '2026-03-28T17:00:00', timeZone: 'Eastern Standard Time' }, scheduledEndDateTime: { dateTime: '2026-04-01T08:00:00', timeZone: 'Eastern Standard Time' }, internalReplyMessage: 'I am OOO.', externalReplyMessage: 'I am out of office.' } }. Значения статуса: disabled, alwaysEnabled, scheduled.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

update-mail-folderвнешний мир

Обновляет свойства объекта mailfolder. 💡 СОВЕТ: Переименовывает почтовую папку, обновляя её displayName. Используйте list-mail-folders, чтобы найти ID папки.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

update-mail-messageвнешний мир

Обновляет существующее письмо Outlook по его идентификатору (message ID) - например, помечает прочитанным или непрочитанным (isRead), устанавливает флаг (flag), изменяет категории, важность или редактирует тему, тело или получателей черновика.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • messageIdstringобязательный

    Value for the 'messageId' path segment. Pass it under the name 'messageId', not as 'id'. Use the 'id' field of the message object as returned by Microsoft Graph.

update-mail-ruleвнешний мир

Изменяет записываемые свойства объекта messageRule и сохраняет изменения. 💡 СОВЕТ: Обновляет существующее правило сообщения. Используйте идентификатор папки Inbox (получить его можно из list-mail-folders) для правил входящих сообщений. Отправляйте только изменяемые свойства. Обычное использование: { isEnabled: false } для отключения правила или обновления условий.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • mailFolderIdstringобязательный

    Value for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.

  • messageRuleIdstringобязательный

    Value for the 'messageRuleId' path segment. Pass it under the name 'messageRuleId', not as 'id'. Use the 'id' field of the message rule object as returned by Microsoft Graph.

update-my-calendar-permissionвнешний мир

Обновляет разрешение моего календаря. 💡 СОВЕТ: Изменяет роль (уровень прав), предоставленную существующему получателю общего доступа или делегату. Тело: { role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' }. Только свойство role доступно для записи — чтобы изменить email получателя или другие свойства, удалите и создайте заново с помощью delete-my-calendar-permission + create-my-calendar-permission. Получите идентификатор разрешения через list-my-calendar-permissions.

Параметры
  • bodyobjectобязательный
  • calendarPermissionIdstringобязательный

    Value for the 'calendarPermissionId' path segment. Pass it under the name 'calendarPermissionId', not as 'id'. Use the 'id' field of the calendar permission object as returned by Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

update-outlook-contactвнешний мир

Обновляет свойства контактного объекта. 💡 СОВЕТ: массив emailAddresses заменяется целиком: включайте все адреса, а не только новые.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • contactIdstringобязательный

    Value for the 'contactId' path segment. Pass it under the name 'contactId', not as 'id'. Use the 'id' field of the contact object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

update-planner-bucketвнешний мир

Обновляет свойства объекта plannerbucket. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требует заголовок If-Match с ETag из get-planner-bucket (используйте includeHeaders=true).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstringобязательный

    ETag value.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerBucketIdstringобязательный

    Value for the 'plannerBucketId' path segment. Pass it under the name 'plannerBucketId', not as 'id'. Use the 'id' field of the planner bucket object as returned by Microsoft Graph.

update-planner-taskвнешний мир

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

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstringобязательный

    ETag value.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerTaskIdstringобязательный

    Value for the 'plannerTaskId' path segment. Pass it under the name 'plannerTaskId', not as 'id'. Use the 'id' field of the planner task object as returned by Microsoft Graph.

update-planner-task-detailsвнешний мир

Обновляет свойства объекта plannerTaskDetails. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: требуется заголовок If-Match с ETag от get-planner-task-details (используйте includeHeaders=true). Элементы контрольного списка используют GUID-ключи: {"checklist": {"<guid>": {"title": "...", "isChecked": false}}}

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • If-Matchstringобязательный

    ETag value.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • plannerTaskIdstringобязательный

    Value for the 'plannerTaskId' path segment. Pass it under the name 'plannerTaskId', not as 'id'. Use the 'id' field of the planner task object as returned by Microsoft Graph.

update-specific-calendar-eventвнешний мир

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

Параметры
  • bodyobjectобязательный
  • calendarIdstringобязательный

    Value for the 'calendarId' path segment. Pass it under the name 'calendarId', not as 'id'. Use the 'id' field of the calendar object as returned by Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • eventIdstringобязательный

    Value for the 'eventId' path segment. Pass it under the name 'eventId', not as 'id'. Use the 'id' field of the event object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

update-subscriptionвнешний мир

Продлевает подписку, увеличивая время её истечения. В таблице в разделе Permissions перечислены ресурсы, которые поддерживают подписку на уведомления об изменениях. Подписки истекают через разное время в зависимости от типа ресурса. Чтобы не пропустить уведомления об изменениях, приложение должно продлевать подписки задолго до даты их истечения. Смотрите subscription для получения информации о максимальной продолжительности подписки для каждого типа ресурса. 💡 СОВЕТ: Продлевает подписку webhook, увеличивая срок её действия. Тело: { expirationDateTime (ISO 8601, новый срок истечения) }. Вызывайте до текущего expirationDateTime, чтобы не пропустить уведомления. Максимальное продление зависит от типа ресурса — смотрите документацию Microsoft Graph для получения информации об ограничениях подписки.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • subscriptionIdstringобязательный

    Value for the 'subscriptionId' path segment. Pass it under the name 'subscriptionId', not as 'id'. Use the 'id' field of the subscription object as returned by Microsoft Graph.

update-todo-taskвнешний мир

Обновляет свойства объекта todoTask. 💡 СОВЕТ: Обновляет задачу Microsoft To Do. Используйте это, чтобы пометить элемент списка дел как выполненный (body: { status: "completed" }), открыть его заново (status: "notStarted"), переименовать (title) или изменить срок выполнения (dueDateTime), напоминание (reminderDateTime), важность или заметки (body). Требует todoTaskListId из list-todo-task-lists и todoTaskId из list-todo-tasks.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • todoTaskIdstringобязательный

    Value for the 'todoTaskId' path segment. Pass it under the name 'todoTaskId', not as 'id'. Use the 'id' field of the todo task object as returned by Microsoft Graph.

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

update-todo-task-listвнешний мир

Обновляет свойства объекта todoTaskList. 💡 СОВЕТ: Переименовывает список задач Microsoft To Do. Тело: { displayName: 'New name' }. Только displayName можно изменять. Встроенные списки (Flagged emails, список Tasks по умолчанию) переименовать нельзя – API возвращает ошибку. Получите идентификаторы списков через list-todo-task-lists.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • todoTaskListIdstringобязательный

    Value for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.

upload-file-contentвнешний мир

Поток содержимого — если элемент является файлом. 💡 СОВЕТ: Тело — это строка в base64 с байтами файла; сервер декодирует её перед PUT. Graph принимает до 250 МБ, но вся строка передаётся как аргумент инструмента, и обрезанная строка декодируется в обрезанный файл без ошибки, поэтому используйте create-upload-session вместо отправки большой строки base64. Для новых файлов используйте формат пути: /items/root:/path/to/file.txt:/content. Перезаписывает существующие файлы без предупреждения.

Параметры
  • bodystringобязательный

    Base64-encoded file content. The server decodes it and PUTs the raw bytes to Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • driveIdstringобязательный

    Value for the 'driveId' path segment. Pass it under the name 'driveId', not as 'id'. Use the 'id' field of the drive object as returned by Microsoft Graph.

  • driveItemIdstringобязательный

    Value for the 'driveItemId' path segment. Pass it under the name 'driveItemId', not as 'id'. Use the 'id' field of the drive item object as returned by Microsoft Graph.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

upload-my-profile-photoвнешний мир

Обновляет фото для указанного контакта, группы, команды или пользователя в арендаторе. Размер обновляемого фото ограничен 4 МБ. Для этой операции можно использовать PATCH или PUT. 💡 СОВЕТ: Загружает новое фото профиля для текущего пользователя. Тело запроса — строка в base64, представляющая байты изображения (сервер декодирует перед PUT). Фото должно быть в формате JPEG, максимум 4 МБ; base64 передаётся как аргумент инструмента, и усечённая строка записывается без ошибки, поэтому изменяйте размер перед кодированием вместо генерации длинной строки. Microsoft 365 автоматически создаёт уменьшенные HD-варианты (48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, 648x648). Для учётных записей организаций или учебных заведений более точным альтернативным разрешением является ProfilePhoto.ReadWrite.All. Используйте download-bytes с параметром target=/me/photo/$value для получения текущего фото.

Параметры
  • bodystringобязательный

    Base64-encoded file content. The server decodes it and PUTs the raw bytes to Microsoft Graph.

  • confirmboolean

    For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

verify-login

Проверяет текущий статус аутентификации Microsoft

Параметры

Без параметров.

Похожие MCP-сервера

yjcho9317/nworks

yjcho9317/nworks

nworks — MCP-сервер для LINE WORKS с 26 инструментами: сообщения, календарь, диск, почта, задачи и доски. Подходит для AI-агентов и автоматизации рабочих процессов через CLI или MCP-протокол. Включ...

TypeScript24
littlebearapps/outlook-assistant

littlebearapps/outlook-assistant

MCP-сервер для Outlook, подключающий AI-ассистентов к вашей электронной почте, календарю и контактам. Поддерживает личные Outlook.com и корпоративные Microsoft 365 — поиск, отправку, экспорт писем,...

JavaScript36
vakharwalad23/google-mcp

vakharwalad23/google-mcp

MCP сервер для интеграции Google-сервисов (почта, календарь, диски, задачи) с AI-клиентами. Позволяет отправлять письма с вложениями, управлять событиями, файлами и задачами. Упрощает автоматизацию рабочих процессов.

TypeScript21
HuntsDesk/ve-gws

HuntsDesk/ve-gws

MCP сервер для Google Workspace с 28 дополнительными инструментами авторской работы: создание слайдов, форматирование документов, управление таблицами и диском. Полный контроль над Gmail, Календарем, Чатами и Формами. Поддержка OAuth 2.1 и CLI.

Python2
conorbronsdon/gws-mcp-server

conorbronsdon/gws-mcp-server

MCP сервер для безопасной интеграции Google Workspace с AI агентами. 41 тщательно отобранный инструмент для Gmail, Calendar, Drive, Sheets, Docs и Tasks — без раздувания контекста. Требуется gws CLI. Идеально для автоматизации офисных задач.

TypeScript10
MarkusPfundstein/mcp-gsuite

MarkusPfundstein/mcp-gsuite

MCP сервер для работы с Gmail и Google Календарем: чтение, поиск и создание писем, управление черновиками, получение и создание событий. Поддерживает несколько аккаунтов. Полезен для автоматизации задач.

Python490
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин