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: 'I will attend.' }. Установите sendResponse: false, чтобы принять молча, без уведомления организатора.

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

Параметры

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

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Создаёт новое навигационное свойство для строк в дисках 💡 ПОДСКАЗКА: Добавляет строки в таблицу. Тело: { values: [['col1val', 'col2val', 'col3val'], ['row2col1', 'row2col2', 'row2col3']] }. Каждый внутренний массив — одна строка. Количество значений должно совпадать с количеством столбцов в таблице.

Создаёт новое навигационное свойство для строк в дисках 💡 ПОДСКАЗКА: Добавляет строки в таблицу. Тело: { values: [['col1val', 'col2val', 'col3val'], ['row2col1', 'row2col2', 'row2col3']] }. Каждый внутренний массив — одна строка. Количество значений должно совпадать с количеством столбцов в таблице.

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookTableId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Это действие позволяет организатору встречи отправить сообщение об отмене и отменить событие. Действие перемещает событие в папку "Удаленные". Организатор также может отменить отдельное вхождение повторяющейся встречи, указав идентификатор этого вхождения. Участник, вызывающий это действие, получает ошибку (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 вместо этого.

Это действие позволяет организатору встречи отправить сообщение об отмене и отменить событие. Действие перемещает событие в папку "Удаленные". Организатор также может отменить отдельное вхождение повторяющейся встречи, указав идентификатор этого вхождения. Участник, вызывающий это действие, получает ошибку (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обязательный
  • eventIdstringобязательный

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

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

    Path parameter: address

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Создаёт (планирует) новое событие календаря, встречу или запись, в календаре пользователя. Задаёт тему, время начала/окончания, часовой пояс, место, описание и участников; поддерживает онлайн-встречи и повторение. 💡 СОВЕТ: ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей.

Создаёт (планирует) новое событие календаря, встречу или запись, в календаре пользователя. Задаёт тему, время начала/окончания, часовой пояс, место, описание и участников; поддерживает онлайн-встречи и повторение. 💡 СОВЕТ: ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей.

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: contactFolderId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: contactFolderId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Создает открытое расширение (объект openTypeExtension) и добавляет пользовательские свойства в новый или существующий экземпляр ресурса. Вы можете создать открытое расширение в экземпляре ресурса и сохранить в него пользовательские данные в одной и той же операции, за исключением отдельных ресурсов. Таблица в разделе Permissions перечисляет ресурсы, которые поддерживают открытые расширения.

Создает открытое расширение (объект openTypeExtension) и добавляет пользовательские свойства в новый или существующий экземпляр ресурса. Вы можете создать открытое расширение в экземпляре ресурса и сохранить в него пользовательские данные в одной и той же операции, за исключением отдельных ресурсов. Таблица в разделе Permissions перечисляет ресурсы, которые поддерживают открытые расширения.

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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.

Создаёт ссылку для предоставления общего доступа к ресурсу 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обязательный
  • driveIdstringобязательный

    Path parameter: driveId

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

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Создает сеанс загрузки, который позволяет приложению итеративно загружать диапазоны файла, чтобы прикрепить файл к указанному элементу Outlook. Элементом может быть сообщение или событие. Используйте этот подход для прикрепления файла, если его размер составляет от 3 МБ до 150 МБ. Чтобы прикрепить файл размером менее 3 МБ, выполните операцию POST для свойства навигации attachments элемента Outlook; см. как это сделать для сообщения или для события. В ответе это действие возвращает URL для загрузки, который можно использовать в последующих последовательных запросах PUT. Заголовки запросов для каждой операции PUT позволяют указать точный диапазон загружаемых байтов. Это позволяет возобновить передачу в случае обрыва сетевого соединения во время загрузки. Далее приведены шаги для прикрепления файла к элементу Outlook с помощью сеанса загрузки: см. пример прикрепления больших файлов к сообщениям или событиям Outlook. 💡 СОВЕТ: Для больших вложений (3-150 МБ). Тело: { AttachmentItem: { attachmentType: 'file', name: 'report.pdf', size: 5000000 } }. Возвращает предварительно авторизованный uploadUrl для прямой PUT-загрузки байтов файла.

Создает сеанс загрузки, который позволяет приложению итеративно загружать диапазоны файла, чтобы прикрепить файл к указанному элементу Outlook. Элементом может быть сообщение или событие. Используйте этот подход для прикрепления файла, если его размер составляет от 3 МБ до 150 МБ. Чтобы прикрепить файл размером менее 3 МБ, выполните операцию POST для свойства навигации attachments элемента Outlook; см. как это сделать для сообщения или для события. В ответе это действие возвращает URL для загрузки, который можно использовать в последующих последовательных запросах PUT. Заголовки запросов для каждой операции PUT позволяют указать точный диапазон загружаемых байтов. Это позволяет возобновить передачу в случае обрыва сетевого соединения во время загрузки. Далее приведены шаги для прикрепления файла к элементу Outlook с помощью сеанса загрузки: см. пример прикрепления больших файлов к сообщениям или событиям Outlook. 💡 СОВЕТ: Для больших вложений (3-150 МБ). Тело: { AttachmentItem: { attachmentType: 'file', name: 'report.pdf', size: 5000000 } }. Возвращает предварительно авторизованный uploadUrl для прямой PUT-загрузки байтов файла.

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: mailFolderId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: mailFolderId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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).

Создаёт ресурс 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обязательный
  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: notebookId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: onenoteSectionId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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) }. Имена категорий чувствительны к регистру при применении к сообщениям/событиям.

Создаёт объект 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обязательный
  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: plannerTaskId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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.

Создаёт черновик для ответа отправителю и всем получателям сообщения в формате 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обязательный
  • messageIdstringобязательный

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Используйте этот API, чтобы создать новое событие в календаре. Календарь может быть календарём пользователя или календарём по умолчанию группы Microsoft 365. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей.

Используйте этот API, чтобы создать новое событие в календаре. Календарь может быть календарём пользователя или календарём по умолчанию группы Microsoft 365. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей.

Параметры

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

    Path parameter: calendarId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Подписывает приложение-слушатель на получение уведомлений об изменениях, когда запрошенный тип изменений происходит с указанным ресурсом в Microsoft Graph. Чтобы узнать, для каких ресурсов можно создавать подписки и какие ограничения на подписки действуют, см. раздел Set up notifications for changes in resource data: Supported resources. Некоторые ресурсы поддерживают расширенные уведомления, то есть уведомления, содержащие данные ресурса. Дополнительные сведения об этих ресурсах см. в разделе Set up change notifications that include resource data: Supported resources. 💡 СОВЕТ: Создает вебхук-подписку для уведомлений об изменениях. Обязательное тело: { changeType (через запятую: 'created,updated,deleted'), notificationUrl (HTTPS, должен пройти проверку с echo токена), 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).

Подписывает приложение-слушатель на получение уведомлений об изменениях, когда запрошенный тип изменений происходит с указанным ресурсом в Microsoft Graph. Чтобы узнать, для каких ресурсов можно создавать подписки и какие ограничения на подписки действуют, см. раздел Set up notifications for changes in resource data: Supported resources. Некоторые ресурсы поддерживают расширенные уведомления, то есть уведомления, содержащие данные ресурса. Дополнительные сведения об этих ресурсах см. в разделе Set up change notifications that include resource data: Supported resources. 💡 СОВЕТ: Создает вебхук-подписку для уведомлений об изменениях. Обязательное тело: { changeType (через запятую: 'created,updated,deleted'), notificationUrl (HTTPS, должен пройти проверку с echo токена), 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обязательный
  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: todoTaskListId

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

    Path parameter: todoTaskId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Создаёт новый объект задачи в указанном todoTaskList.

Создаёт новый объект задачи в указанном todoTaskList.

Параметры

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

    Path parameter: todoTaskListId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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 для его заполнения.

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

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: calendarId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: contactFolderId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: permissionId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

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

    Path parameter: address

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: drive-id

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

    Path parameter: driveItem-id

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

    Path parameter: workbookTable-id

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

    Path parameter: index

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: inferenceClassificationOverrideId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Удаляет навигационное свойство attachments для меня

Удаляет навигационное свойство attachments для меня

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: messageId

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

    Path parameter: attachmentId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: mailFolderId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Удаляет указанный объект messageRule. 💡 ПОДСКАЗКА: Удаляет правило сообщения навсегда. Для правил входящих сообщений используйте идентификатор папки Inbox (получите его из list-mail-folders).

Удаляет указанный объект messageRule. 💡 ПОДСКАЗКА: Удаляет правило сообщения навсегда. Для правил входящих сообщений используйте идентификатор папки Inbox (получите его из list-mail-folders).

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: mailFolderId

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

    Path parameter: messageRuleId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: calendarPermissionId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Удаляет элементы навигационного свойства для дисков.

Удаляет элементы навигационного свойства для дисков.

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: onenotePageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: contactId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: plannerBucketId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: plannerTaskId

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

    Path parameter: plannerTaskChatMessageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Удаляет свойство навигации events для меня 💡 СОВЕТ: Удаление seriesMaster удаляет ВСЕ экземпляры. Чтобы отменить один экземпляр, используйте конкретный идентификатор экземпляра.

Удаляет свойство навигации events для меня 💡 СОВЕТ: Удаление seriesMaster удаляет ВСЕ экземпляры. Чтобы отменить один экземпляр, используйте конкретный идентификатор экземпляра.

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: calendarId

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

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: subscriptionId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: todoTaskListId

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

    Path parameter: todoTaskId

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

    Path parameter: linkedResourceId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: todoTaskListId

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

    Path parameter: todoTaskId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • If-Matchstring

    ETag

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

    Path parameter: todoTaskListId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

Загружает двоичное содержимое из 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.

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

Обновляет свойство навигации format в drives. 💡 СОВЕТ: Применяет свойства rangeFormat к определенному диапазону. Обязательный параметр пути 'address' (например, 'A1:E5' или 'Sheet1!A1:E5'). Тело: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Примечание: font, fill и borders - подресурсы rangeFormat, задавайте их через /format/font, /format/fill и /format/borders/{sideIndex} соответственно, а не на этой конечной точке.

Обновляет свойство навигации format в drives. 💡 СОВЕТ: Применяет свойства rangeFormat к определенному диапазону. Обязательный параметр пути 'address' (например, 'A1:E5' или 'Sheet1!A1:E5'). Тело: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Примечание: font, fill и borders - подресурсы rangeFormat, задавайте их через /format/font, /format/fill и /format/borders/{sideIndex} соответственно, а не на этой конечной точке.

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

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

    Path parameter: address

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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 обязателен. НЕ восстанавливайте письмо вручную - эта конечная точка обрабатывает всё на стороне сервера.

Пересылает сообщение в формате 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обязательный
  • messageIdstringобязательный

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: eventId

  • 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

  • excludeResponseboolean

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

  • 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.

  • expandExtendedPropertiesboolean

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

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

Получает вхождения, исключения и отдельные экземпляры событий в представлении календаря, заданном временным диапазоном, из календаря пользователя по умолчанию или из другого календаря этого пользователя. 💡 СОВЕТ: Возвращает развёрнутые повторяющиеся экземпляры событий (не только seriesMaster) в заданном диапазоне дат для календаря по умолчанию. Требует параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Используйте get-specific-calendar-view, если нужен нестандартный календарь. Чтобы найти собрания Teams, используйте $filter=isOnlineMeeting eq true. Для поиска по теме — $filter=contains(subject,'keyword'). Собрания Teams содержат свойство joinWebUrl, необходимое для доступа к расшифровке через list-online-meetings.

Получает вхождения, исключения и отдельные экземпляры событий в представлении календаря, заданном временным диапазоном, из календаря пользователя по умолчанию или из другого календаря этого пользователя. 💡 СОВЕТ: Возвращает развёрнутые повторяющиеся экземпляры событий (не только seriesMaster) в заданном диапазоне дат для календаря по умолчанию. Требует параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Используйте get-specific-calendar-view, если нужен нестандартный календарь. Чтобы найти собрания Teams, используйте $filter=isOnlineMeeting eq true. Для поиска по теме — $filter=contains(subject,'keyword'). Собрания Teams содержат свойство joinWebUrl, необходимое для доступа к расшифровке через list-online-meetings.

Параметры

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

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

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

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

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

  • 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.

  • expandExtendedPropertiesboolean

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

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

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

Получает свойства и связи объекта user. Эта операция по умолчанию возвращает только подмножество наиболее часто используемых свойств для каждого пользователя. Эти свойства по умолчанию указаны в разделе Properties. Чтобы получить свойства, которые не возвращаются по умолчанию, выполните GET-операцию для пользователя и укажите свойства в параметре запроса $select OData. Поскольку ресурс 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

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Формирует краткосрочный предварительно аутентифицированный URL для загрузки бинарного контента из Microsoft Graph, который предоставляет содержимое одного файла (диск/SharePoint). Возвращённый URL передаёт байты потоком БЕЗ заголовка Authorization, поэтому клиент может сохранять их прямо на диск (например, через curl) без преобразования в base64 в контексте агента. Предпочитайте этот способ download-bytes для любых файлов размером более нескольких КБ или для массовой загрузки. Возвращает { downloadUrl, name?, size?, contentType? }. ВНИМАНИЕ: вложения почтовых сообщений (/messages/{id}/attachments/{id}/$value) и записи собраний НЕ предоставляют предварительно аутентифицированный URL — у Graph нет такой ссылки для них; для небольших файлов используйте download-bytes.

Формирует краткосрочный предварительно аутентифицированный URL для загрузки бинарного контента из Microsoft Graph, который предоставляет содержимое одного файла (диск/SharePoint). Возвращённый URL передаёт байты потоком БЕЗ заголовка Authorization, поэтому клиент может сохранять их прямо на диск (например, через curl) без преобразования в base64 в контексте агента. Предпочитайте этот способ download-bytes для любых файлов размером более нескольких КБ или для массовой загрузки. Возвращает { downloadUrl, name?, size?, contentType? }. ВНИМАНИЕ: вложения почтовых сообщений (/messages/{id}/attachments/{id}/$value) и записи собраний НЕ предоставляют предварительно аутентифицированный URL — у Graph нет такой ссылки для них; для небольших файлов используйте 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-токены для инкрементальной синхронизации через @odata.deltaLink.

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

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • selectstring

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • 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

  • excludeResponseboolean

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

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 с тем же target=/content.

Все элементы, содержащиеся в диске. Только для чтения. Допускает значение 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 с тем же target=/content.

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

  • 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

  • excludeResponseboolean

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

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

Вызывает функцию range

Вызывает функцию range

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

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

    Path parameter: address

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookTableId

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

  • 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

  • excludeResponseboolean

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

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 и userPurpose.

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Получает свойства и связи объекта eventMessage. Применяет параметр $expand к свойству навигации event, чтобы получить связанное событие в календаре участника. В настоящее время эта операция возвращает тела сообщений событий только в формате HTML.

Получает свойства и связи объекта eventMessage. Применяет параметр $expand к свойству навигации event, чтобы получить связанное событие в календаре участника. В настоящее время эта операция возвращает тела сообщений событий только в формате HTML.

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: messageId

  • 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

  • excludeResponseboolean

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

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

Получает расширение open (объект openTypeExtension), идентифицированное по имени или полному имени. Таблица в разделе Permissions перечисляет ресурсы, поддерживающие открытые расширения. Следующая таблица перечисляет три сценария, в которых можно получить открытое расширение из поддерживаемого экземпляра ресурса. 💡 СОВЕТ: Скачивает сообщение электронной почты как необработанный MIME-контент RFC 5322 (формат .eml). Используйте это при архивировании письма на диск с сохранением всех оригинальных заголовков, тела и встроенных закодированных вложений. Возвращает MIME-поток в виде текста. Сначала найдите идентификатор сообщения с помощью list-mail-messages.

Получает расширение open (объект openTypeExtension), идентифицированное по имени или полному имени. Таблица в разделе Permissions перечисляет ресурсы, поддерживающие открытые расширения. Следующая таблица перечисляет три сценария, в которых можно получить открытое расширение из поддерживаемого экземпляра ресурса. 💡 СОВЕТ: Скачивает сообщение электронной почты как необработанный MIME-контент RFC 5322 (формат .eml). Используйте это при архивировании письма на диск с сохранением всех оригинальных заголовков, тела и встроенных закодированных вложений. Возвращает MIME-поток в виде текста. Сначала найдите идентификатор сообщения с помощью list-mail-messages.

Параметры

  • includeHiddenMessagesstring

    Include Hidden Messages

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

    Path parameter: messageId

  • 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

  • excludeResponseboolean

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

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, или предупредить перед массовой рассылкой на большой список рассылки.

Получает 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обязательный
  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

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

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

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

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

    Path parameter: onenotePageId

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: contactId

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: plannerBucketId

  • 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

  • excludeResponseboolean

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

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

Извлекает свойства и отношения объекта plannerplan.

Извлекает свойства и отношения объекта plannerplan.

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: plannerPlanId

  • 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

  • excludeResponseboolean

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

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

Извлекает свойства и отношения объекта plannerTask. 💡 СОВЕТ: Ответ содержит @odata.etag - сохраните его, он требуется как заголовок If-Match для update-planner-task. Используйте includeHeaders=true, чтобы получить его.

Извлекает свойства и отношения объекта plannerTask. 💡 СОВЕТ: Ответ содержит @odata.etag - сохраните его, он требуется как заголовок If-Match для update-planner-task. Используйте includeHeaders=true, чтобы получить его.

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: plannerTaskId

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: plannerTaskId

  • 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

  • excludeResponseboolean

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

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

События в календаре. Навигационное свойство. Только для чтения.

События в календаре. Навигационное свойство. Только для чтения.

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: calendarId

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

    Path parameter: eventId

  • 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

  • excludeResponseboolean

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

  • 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.

  • expandExtendedPropertiesboolean

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

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

Представление календаря для этого календаря. Навигационное свойство. Только для чтения. 💡 СОВЕТ: Возвращает развернутые экземпляры повторяющихся событий (не только seriesMaster) в заданном диапазоне дат для конкретного календаря. Требует параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Каждый экземпляр включает поля seriesMasterId и type (occurrence/exception) для связывания повторяющихся событий. Используйте fetchAllPages=true, чтобы получить все результаты, если событий много. Чтобы найти собрания Teams, используйте $filter=isOnlineMeeting eq true. Собрания Teams включают свойство joinWebUrl, необходимое для доступа к расшифровке через list-online-meetings.

Представление календаря для этого календаря. Навигационное свойство. Только для чтения. 💡 СОВЕТ: Возвращает развернутые экземпляры повторяющихся событий (не только seriesMaster) в заданном диапазоне дат для конкретного календаря. Требует параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Каждый экземпляр включает поля seriesMasterId и type (occurrence/exception) для связывания повторяющихся событий. Используйте fetchAllPages=true, чтобы получить все результаты, если событий много. Чтобы найти собрания Teams, используйте $filter=isOnlineMeeting eq true. Собрания Teams включают свойство joinWebUrl, необходимое для доступа к расшифровке через list-online-meetings.

Параметры

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

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

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

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

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: calendarId

  • 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

  • excludeResponseboolean

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

  • 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.

  • expandExtendedPropertiesboolean

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

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

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

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

Параметры

  • selectstring

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

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

    Path parameter: subscriptionId

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: todoTaskListId

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

    Path parameter: todoTaskId

  • 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

  • excludeResponseboolean

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

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 за один круговой обход); (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 за один круговой обход); (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 за один круговой обход); (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 за один круговой обход); (2) последовательность зависимых запросов на запись через dependsOn; (3) пакетная запись многих диапазонов Excel за один вызов, чтобы значительно снизить задержку при сборке больших книг. Примечание: URL каждого подзапроса указывается относительно корня версии Graph (/me/..., /drives/..., а НЕ https://graph.microsoft.com/v1.0/...).

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

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

    Path parameter: address

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

list-accountsтолько чтение

Перечисляет все учетные записи Microsoft, настроенные на этом сервере. Используйте это, чтобы узнать доступные адреса электронной почты учетных записей перед вызовами инструментов. Отражает учетные записи, добавленные во время сеанса через --login.

Перечисляет все учетные записи Microsoft, настроенные на этом сервере. Используйте это, чтобы узнать доступные адреса электронной почты учетных записей перед вызовами инструментов. Отражает учетные записи, добавленные во время сеанса через --login.

Параметры

Без параметров.

list-all-onenote-sectionsтолько чтениевнешний мир

Получает список объектов onenoteSection. 💡 СОВЕТ: Перечисляет все разделы во всех записных книжках. Используйте list-onenote-notebook-sections, чтобы перечислить разделы в определенной записной книжке.

Получает список объектов onenoteSection. 💡 СОВЕТ: Перечисляет все разделы во всех записных книжках. Используйте list-onenote-notebook-sections, чтобы перечислить разделы в определенной записной книжке.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Вхождения повторяющейся серии, если событие является основным событием серии. Это свойство включает вхождения, являющиеся частью шаблона повторения, и изменённые исключения, но не включает вхождения, отменённые из серии. Свойство навигации. Только для чтения. Допускает значение null. 💡 СОВЕТ: Разворачивает повторяющееся событие в отдельные экземпляры в пределах диапазона дат. Требует параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Используйте это, чтобы увидеть все вхождения повторяющегося события.

Вхождения повторяющейся серии, если событие является основным событием серии. Это свойство включает вхождения, являющиеся частью шаблона повторения, и изменённые исключения, но не включает вхождения, отменённые из серии. Свойство навигации. Только для чтения. Допускает значение null. 💡 СОВЕТ: Разворачивает повторяющееся событие в отдельные экземпляры в пределах диапазона дат. Требует параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Используйте это, чтобы увидеть все вхождения повторяющегося события.

Параметры

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

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

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

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

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: calendarId

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

    Path parameter: eventId

  • 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

  • excludeResponseboolean

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

  • 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.

  • expandExtendedPropertiesboolean

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

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

Получает список объектов событий в почтовом ящике пользователя. Список содержит отдельные встречи и series masters. Чтобы получить развернутые экземпляры событий, можно использовать get-calendar-view или получить экземпляры события. В настоящее время эта операция возвращает тела событий только в формате HTML. Есть два сценария, в которых приложение может получать события из календаря другого пользователя: 💡 СОВЕТ: ВНИМАНИЕ: НЕ разворачивает повторяющиеся события - возвращает только seriesMaster. Используйте get-calendar-view, чтобы увидеть отдельные вхождения в заданном диапазоне дат.

Получает список объектов событий в почтовом ящике пользователя. Список содержит отдельные встречи и series masters. Чтобы получить развернутые экземпляры событий, можно использовать get-calendar-view или получить экземпляры события. В настоящее время эта операция возвращает тела событий только в формате HTML. Есть два сценария, в которых приложение может получать события из календаря другого пользователя: 💡 СОВЕТ: ВНИМАНИЕ: НЕ разворачивает повторяющиеся события - возвращает только seriesMaster. Используйте get-calendar-view, чтобы увидеть отдельные вхождения в заданном диапазоне дат.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

  • 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.

  • expandExtendedPropertiesboolean

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

list-calendar-events-deltaтолько чтениевнешний мир

Получает набор ресурсов событий, которые были добавлены, удалены или обновлены в представлении календаря (диапазоне событий, заданном датами начала и окончания) основного календаря пользователя. Обычно синхронизация событий в представлении календаря в локальном хранилище включает несколько вызовов дельта-функции за один раунд. Первый вызов — полная синхронизация, а каждый последующий дельта-вызов в том же раунде получает только инкрементальные изменения (добавления, удаления или обновления). Это позволяет поддерживать и синхронизировать локальное хранилище событий в указанном представлении календаря, не загружая все события этого календаря с сервера каждый раз. 💡 СОВЕТ: Инкрементальная синхронизация событий в календаре по умолчанию. Первый вызов возвращает все события плюс @odata.deltaLink. Последующие вызовы с этой ссылкой возвращают только добавления/обновления/удаления. Используйте $select, чтобы ограничить поля. Дельта-токены истекают примерно через 30 дней. Начните заново, если сервер вернул 410 Gone. Для ограниченного по времени представления с дельта-семантикой используйте list-calendar-view-delta.

Получает набор ресурсов событий, которые были добавлены, удалены или обновлены в представлении календаря (диапазоне событий, заданном датами начала и окончания) основного календаря пользователя. Обычно синхронизация событий в представлении календаря в локальном хранилище включает несколько вызовов дельта-функции за один раунд. Первый вызов — полная синхронизация, а каждый последующий дельта-вызов в том же раунде получает только инкрементальные изменения (добавления, удаления или обновления). Это позволяет поддерживать и синхронизировать локальное хранилище событий в указанном представлении календаря, не загружая все события этого календаря с сервера каждый раз. 💡 СОВЕТ: Инкрементальная синхронизация событий в календаре по умолчанию. Первый вызов возвращает все события плюс @odata.deltaLink. Последующие вызовы с этой ссылкой возвращают только добавления/обновления/удаления. Используйте $select, чтобы ограничить поля. Дельта-токены истекают примерно через 30 дней. Начните заново, если сервер вернул 410 Gone. Для ограниченного по времени представления с дельта-семантикой используйте list-calendar-view-delta.

Параметры

  • 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

  • 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

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • selectstring

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

list-calendarsтолько чтениевнешний мир

Получает все календари пользователя (/calendars navigation property), получает календари из группы календарей по умолчанию или из конкретной группы календарей.

Получает все календари пользователя (/calendars navigation property), получает календари из группы календарей по умолчанию или из конкретной группы календарей.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Получает набор ресурсов событий, которые были добавлены, удалены или обновлены в представлении календаря (calendarView — диапазон событий, заданный датами начала и окончания) основного календаря пользователя. Обычно синхронизация событий в представлении календаря в локальном хранилище включает раунд из нескольких вызовов дельта-функции. Первый вызов — полная синхронизация, а каждый последующий дельта-вызов в том же раунде получает инкрементальные изменения (добавления, удаления или обновления). Это позволяет поддерживать и синхронизировать локальное хранилище событий в указанном представлении календаря без необходимости каждый раз загружать все события этого календаря с сервера. 💡 СОВЕТ: Инкрементальная синхронизация событий во временном окне. Обязательные параметры запроса при первом вызове: startDateTime, endDateTime (ISO 8601). Возвращает события в окне плюс @odata.deltaLink; последующие вызовы с этой ссылкой возвращают только изменения. Разворачивает повторяющиеся события в отдельные вхождения (в отличие от list-calendar-events-delta, который возвращает главный элемент серии). Используйте это для UI календаря, показывающего недельный или месячный вид.

Получает набор ресурсов событий, которые были добавлены, удалены или обновлены в представлении календаря (calendarView — диапазон событий, заданный датами начала и окончания) основного календаря пользователя. Обычно синхронизация событий в представлении календаря в локальном хранилище включает раунд из нескольких вызовов дельта-функции. Первый вызов — полная синхронизация, а каждый последующий дельта-вызов в том же раунде получает инкрементальные изменения (добавления, удаления или обновления). Это позволяет поддерживать и синхронизировать локальное хранилище событий в указанном представлении календаря без необходимости каждый раз загружать все события этого календаря с сервера. 💡 СОВЕТ: Инкрементальная синхронизация событий во временном окне. Обязательные параметры запроса при первом вызове: startDateTime, endDateTime (ISO 8601). Возвращает события в окне плюс @odata.deltaLink; последующие вызовы с этой ссылкой возвращают только изменения. Разворачивает повторяющиеся события в отдельные вхождения (в отличие от list-calendar-events-delta, который возвращает главный элемент серии). Используйте это для UI календаря, показывающего недельный или месячный вид.

Параметры

  • 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

  • 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

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • selectstring

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

list-contact-folder-child-foldersтолько чтениевнешний мир

Получает коллекцию дочерних папок внутри указанной папки контактов. 💡 ПОДСКАЗКА: Перечисляет непосредственные подпапки внутри заданной папки контактов. Возвращает id, displayName, parentFolderId. Используйте list-contact-folders для обнаружения папок верхнего уровня, затем этот инструмент для перехода на один уровень глубже. Поддерживает $filter, $top, $orderby. Примечание: папки контактов обычно представляют собой плоский список в клиентах Outlook, но Graph позволяет вложенность через эту конечную точку.

Получает коллекцию дочерних папок внутри указанной папки контактов. 💡 ПОДСКАЗКА: Перечисляет непосредственные подпапки внутри заданной папки контактов. Возвращает id, displayName, parentFolderId. Используйте list-contact-folders для обнаружения папок верхнего уровня, затем этот инструмент для перехода на один уровень глубже. Поддерживает $filter, $top, $orderby. Примечание: папки контактов обычно представляют собой плоский список в клиентах Outlook, но 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: contactFolderId

  • 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

  • excludeResponseboolean

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

list-contact-folder-contactsтолько чтениевнешний мир

Получает коллекцию контактов из папки «Контакты» по умолчанию вошедшего в систему пользователя (.../me/contacts) или из указанной папки контактов. 💡 СОВЕТ: Перечисляет контакты внутри определенной папки. Используйте вместе с list-contact-folders, чтобы узнать идентификатор папки. Примечание: существующий list-outlook-contacts (GET /me/contacts) возвращает контакты только из папки по умолчанию - используйте этот инструмент для чтения контактов из любой папки. Поддерживает $filter, $search='query', $orderby, $top, $select.

Получает коллекцию контактов из папки «Контакты» по умолчанию вошедшего в систему пользователя (.../me/contacts) или из указанной папки контактов. 💡 СОВЕТ: Перечисляет контакты внутри определенной папки. Используйте вместе с list-contact-folders, чтобы узнать идентификатор папки. Примечание: существующий list-outlook-contacts (GET /me/contacts) возвращает контакты только из папки по умолчанию - используйте этот инструмент для чтения контактов из любой папки. Поддерживает $filter, $search='query', $orderby, $top, $select.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: contactFolderId

  • 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

  • excludeResponseboolean

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

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

Получает коллекцию папок контактов в стандартной папке Contacts вошедшего в систему пользователя. 💡 СОВЕТ: Перечисляет папки контактов Outlook пользователя (именованные контейнеры, которые упорядочивают контакты). Всегда включает встроенную папку 'Contacts'; созданные пользователем папки также отображаются. Возвращает id, displayName и parentFolderId. Чтобы определить папку по умолчанию, найдите папку с displayName === 'Contacts'. Используйте этот инструмент перед list-contact-folder-contacts или create-contact-in-folder, чтобы узнать идентификаторы папок. Поддерживает параметры запросов OData.

Получает коллекцию папок контактов в стандартной папке Contacts вошедшего в систему пользователя. 💡 СОВЕТ: Перечисляет папки контактов Outlook пользователя (именованные контейнеры, которые упорядочивают контакты). Всегда включает встроенную папку 'Contacts'; созданные пользователем папки также отображаются. Возвращает id, displayName и parentFolderId. Чтобы определить папку по умолчанию, найдите папку с displayName === 'Contacts'. Используйте этот инструмент перед list-contact-folder-contacts или create-contact-in-folder, чтобы узнать идентификаторы папок. Поддерживает параметры запросов OData.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Набор разрешений для элемента. Только чтение. Nullable. 💡 СОВЕТ: Перечисляет все разрешения (ссылки для общего доступа, прямой доступ, унаследованные) для файла или папки. Каждое разрешение имеет роли, grantedTo (пользователь), link (URL общего доступа) и inheritedFrom.

Набор разрешений для элемента. Только чтение. Nullable. 💡 СОВЕТ: Перечисляет все разрешения (ссылки для общего доступа, прямой доступ, унаследованные) для файла или папки. Каждое разрешение имеет роли, grantedTo (пользователь), link (URL общего доступа) и inheritedFrom.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • 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

  • excludeResponseboolean

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

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

Коллекция объектов thumbnailSet, связанных с элементом. Дополнительные сведения см. в разделе получения эскизов. Только для чтения. Допускает значение NULL. 💡 СОВЕТ: Перечисляет наборы эскизов для файла. Каждый набор содержит маленькие (96px), средние (176px) и большие (800px) эскизы с URL и размерами. Возвращает пустой результат для неподдерживаемых типов (текстовые документы). Используйте $select=small,medium,large или $expand=small($select=url), чтобы получить нужные размеры. Возвращаемые URL-адреса живут недолго: загружайте байты сразу же.

Коллекция объектов thumbnailSet, связанных с элементом. Дополнительные сведения см. в разделе получения эскизов. Только для чтения. Допускает значение NULL. 💡 СОВЕТ: Перечисляет наборы эскизов для файла. Каждый набор содержит маленькие (96px), средние (176px) и большие (800px) эскизы с URL и размерами. Возвращает пустой результат для неподдерживаемых типов (текстовые документы). Используйте $select=small,medium,large или $expand=small($select=url), чтобы получить нужные размеры. Возвращаемые URL-адреса живут недолго: загружайте байты сразу же.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • 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

  • excludeResponseboolean

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

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

Список предыдущих версий элемента. Дополнительную информацию см. в разделе «Получение предыдущих версий». Только для чтения. Может быть null. 💡 СОВЕТ: Перечисляет историю версий файла. Каждая версия содержит id, lastModifiedDateTime, lastModifiedBy и size. Используйте идентификатор версии с /versions/{id}/content для загрузки конкретной версии.

Список предыдущих версий элемента. Дополнительную информацию см. в разделе «Получение предыдущих версий». Только для чтения. Может быть null. 💡 СОВЕТ: Перечисляет историю версий файла. Каждая версия содержит id, lastModifiedDateTime, lastModifiedBy и size. Используйте идентификатор версии с /versions/{id}/content для загрузки конкретной версии.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • 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

  • excludeResponseboolean

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

list-drivesтолько чтениевнешний мир

Получает список ресурсов Drive, доступных для целевого пользователя, группы или сайта.

Получает список ресурсов Drive, доступных для целевого пользователя, группы или сайта.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Список всех строк таблицы. Только для чтения. 💡 СОВЕТ: Перечисляет все строки таблицы. Каждая строка содержит индекс и значения (массив значений ячеек). Для постраничной навигации по большим таблицам используйте $top и $skip.

Список всех строк таблицы. Только для чтения. 💡 СОВЕТ: Перечисляет все строки таблицы. Каждая строка содержит индекс и значения (массив значений ячеек). Для постраничной навигации по большим таблицам используйте $top и $skip.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookTableId

  • 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

  • excludeResponseboolean

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

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

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

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

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • 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

  • excludeResponseboolean

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

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

Представляет коллекцию листов, связанных с книгой. Только для чтения.

Представляет коллекцию листов, связанных с книгой. Только для чтения.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • 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

  • excludeResponseboolean

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

list-focused-inbox-overridesтолько чтениевнешний мир

Получает переопределения, которые настроил пользователь, чтобы всегда классифицировать сообщения от определённых отправителей заданным образом. Каждое переопределение соответствует SMTP-адресу отправителя. Изначально у пользователя нет никаких переопределений. 💡 ПОДСКАЗКА: Перечисляет переопределения классификации Focused Inbox — явные правила, которые принудительно помещают сообщения от указанного отправителя (по SMTP-адресу) либо на вкладку Focused, либо на вкладку Other, независимо от прогноза классификатора машинного обучения Outlook. Каждое переопределение содержит id, classifyAs ('focused' или 'other') и senderEmailAddress {name, address}. Возвращает пустую коллекцию, если пользователь никогда не устанавливал переопределение.

Получает переопределения, которые настроил пользователь, чтобы всегда классифицировать сообщения от определённых отправителей заданным образом. Каждое переопределение соответствует SMTP-адресу отправителя. Изначально у пользователя нет никаких переопределений. 💡 ПОДСКАЗКА: Перечисляет переопределения классификации Focused Inbox — явные правила, которые принудительно помещают сообщения от указанного отправителя (по SMTP-адресу) либо на вкладку Focused, либо на вкладку Other, независимо от прогноза классификатора машинного обучения Outlook. Каждое переопределение содержит id, classifyAs ('focused' или 'other') и senderEmailAddress {name, address}. Возвращает пустую коллекцию, если пользователь никогда не устанавливал переопределение.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

list-folder-filesтолько чтениевнешний мир

Возвращает коллекцию DriveItems из отношения children для DriveItem. DriveItems с ненулевым фасетом folder или package могут иметь один или несколько дочерних DriveItems.

Возвращает коллекцию DriveItems из отношения children для DriveItem. DriveItems с ненулевым фасетом folder или package могут иметь один или несколько дочерних DriveItems.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • 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

  • excludeResponseboolean

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

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

Извлекает список объектов вложений. 💡 СОВЕТ: Перечисляет вложения в сообщении: id, name, contentType, size, isInline. Чтобы скачать байты, вызовите download-bytes с target=/me/messages/{message-id}/attachments/{attachment-id}/$value (суффикс /$value возвращает сырые байты; обычный URL вложения встраивает contentBytes в JSON, что может обрезать большие файлы).

Извлекает список объектов вложений. 💡 СОВЕТ: Перечисляет вложения в сообщении: id, name, contentType, size, isInline. Чтобы скачать байты, вызовите download-bytes с target=/me/messages/{message-id}/attachments/{attachment-id}/$value (суффикс /$value возвращает сырые байты; обычный URL вложения встраивает contentBytes в JSON, что может обрезать большие файлы).

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: messageId

  • 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

  • excludeResponseboolean

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

list-mail-child-foldersтолько чтениевнешний мир

Получает коллекцию папок в указанной папке. Вы можете использовать сокращение .../me/mailFolders, чтобы получить коллекцию папок верхнего уровня и перейти в другую папку. По умолчанию эта операция не возвращает скрытые папки. Используйте параметр запроса includeHiddenFolders, чтобы включить их в ответ.

Получает коллекцию папок в указанной папке. Вы можете использовать сокращение .../me/mailFolders, чтобы получить коллекцию папок верхнего уровня и перейти в другую папку. По умолчанию эта операция не возвращает скрытые папки. Используйте параметр запроса includeHiddenFolders, чтобы включить их в ответ.

Параметры

  • includeHiddenFoldersstring

    Include Hidden Folders

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: mailFolderId

  • 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

  • excludeResponseboolean

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

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 с конкретным идентификатором сообщения.

Получает все сообщения в почтовом ящике указанного пользователя или сообщения в указанной папке почтового ящика. 💡 СОВЕТ: Выводит список, читает и ищет электронные письма 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 с конкретным идентификатором сообщения.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: mailFolderId

  • 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

  • excludeResponseboolean

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

list-mail-folder-messages-deltaтолько чтениевнешний мир

Получает набор сообщений, добавленных, удалённых или обновлённых в указанной папке. Вызов дельта-функции для сообщений в папке аналогичен GET-запросу, за тем исключением, что при правильном применении токенов состояния в одном или нескольких таких вызовах вы можете [запросить инкрементальные изменения сообщений в этой папке](/graph/delta-query-messages). Это позволяет поддерживать и синхронизировать локальное хранилище сообщений пользователя без необходимости каждый раз получать полный набор сообщений с сервера. 💡 СОВЕТ: Инкрементальная синхронизация сообщений в папке почты. Graph поддерживает дельту только в рамках папки — используйте mailFolder-id = 'inbox' для стандартного входящего ящика или другой идентификатор папки из list-mail-folders. Первый вызов возвращает все сообщения плюс @odata.deltaLink; последующие вызовы с этой ссылкой возвращают только изменения (созданные/обновлённые/удалённые). @odata.nextLink разбивает на страницы в пределах одного окна дельты. Дельта истекает через ~30 дней бездействия — начинайте заново, если сервер возвращает 410. Предпочитайте этот метод полному повторному получению списка для опроса.

Получает набор сообщений, добавленных, удалённых или обновлённых в указанной папке. Вызов дельта-функции для сообщений в папке аналогичен GET-запросу, за тем исключением, что при правильном применении токенов состояния в одном или нескольких таких вызовах вы можете [запросить инкрементальные изменения сообщений в этой папке](/graph/delta-query-messages). Это позволяет поддерживать и синхронизировать локальное хранилище сообщений пользователя без необходимости каждый раз получать полный набор сообщений с сервера. 💡 СОВЕТ: Инкрементальная синхронизация сообщений в папке почты. 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.

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • selectstring

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • expandstring[]

    Expand related entities

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

    Path parameter: mailFolderId

  • 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

  • excludeResponseboolean

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

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

Получает коллекцию папок почтового ящика, расположенных непосредственно в корневой папке вошедшего пользователя. Возвращаемая коллекция включает любые папки поиска, находящиеся непосредственно в корне. По умолчанию эта операция не возвращает скрытые папки. Используйте параметр запроса includeHiddenFolders, чтобы включить их в ответ. Эта операция не возвращает все папки почтового ящика, а только дочерние папки корневой папки. Чтобы вернуть все папки почтового ящика, необходимо пройти по каждой дочерней папке отдельно.

Получает коллекцию папок почтового ящика, расположенных непосредственно в корневой папке вошедшего пользователя. Возвращаемая коллекция включает любые папки поиска, находящиеся непосредственно в корне. По умолчанию эта операция не возвращает скрытые папки. Используйте параметр запроса includeHiddenFolders, чтобы включить их в ответ. Эта операция не возвращает все папки почтового ящика, а только дочерние папки корневой папки. Чтобы вернуть все папки почтового ящика, необходимо пройти по каждой дочерней папке отдельно.

Параметры

  • includeHiddenFoldersstring

    Include Hidden Folders

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Получает открытое расширение (объект openTypeExtension), идентифицированное по имени или полному имени. Таблица в разделе Permissions перечисляет ресурсы, которые поддерживают открытые расширения. Следующая таблица перечисляет три сценария, в которых можно получить открытое расширение из поддерживаемого экземпляра ресурса. 💡 СОВЕТ: Выводит список, читает и ищет письма Outlook в разных папках. КРИТИЧЕСКИ ВАЖНО: При поиске писем значение параметра $search ДОЛЖНО быть заключено в двойные кавычки. Формат: $search="your search query here". Используйте синтаксис 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 с конкретным идентификатором сообщения.

Получает открытое расширение (объект openTypeExtension), идентифицированное по имени или полному имени. Таблица в разделе Permissions перечисляет ресурсы, которые поддерживают открытые расширения. Следующая таблица перечисляет три сценария, в которых можно получить открытое расширение из поддерживаемого экземпляра ресурса. 💡 СОВЕТ: Выводит список, читает и ищет письма Outlook в разных папках. КРИТИЧЕСКИ ВАЖНО: При поиске писем значение параметра $search ДОЛЖНО быть заключено в двойные кавычки. Формат: $search="your search query here". Используйте синтаксис 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 с конкретным идентификатором сообщения.

Параметры

  • includeHiddenMessagesstring

    Include Hidden Messages

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Получает все объекты messageRule, определённые для папки «Входящие» пользователя. 💡 TIP: Списывает все правила сообщений для почтовой папки. Используйте идентификатор папки «Входящие» (получите его из list-mail-folders) для правил входящих. Каждое правило имеет displayName, sequence, isEnabled, условия (fromAddresses, subjectContains и т.д.), действия (moveToFolder, forwardTo, delete и т.д.) и исключения.

Получает все объекты messageRule, определённые для папки «Входящие» пользователя. 💡 TIP: Списывает все правила сообщений для почтовой папки. Используйте идентификатор папки «Входящие» (получите его из list-mail-folders) для правил входящих. Каждое правило имеет displayName, sequence, isEnabled, условия (fromAddresses, subjectContains и т.д.), действия (moveToFolder, forwardTo, delete и т.д.) и исключения.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: mailFolderId

  • 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

  • excludeResponseboolean

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

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: в настоящее время не раскрыто.

Разрешения пользователей, с которыми предоставлен доступ к календарю. 💡 ПОДСКАЗКА: Перечисляет получателей общего доступа и делегатов в основном календаре пользователя. Возвращает объекты calendarPermission с полями id, role ('none' | 'freeBusyRead' | 'limitedRead' | 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' | 'custom'), emailAddress { name, address }, isInsideOrganization, isRemovable, allowedRoles. Возвращает пустую коллекцию при вызове делегатом или получателем общего доступа (только владелец календаря видит полный список). Для неосновного календаря используйте /me/calendars/{calendar-id}/calendarPermissions: в настоящее время не раскрыто.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

list-onenote-notebooksтолько чтениевнешний мир

Получает список объектов notebook.

Получает список объектов notebook.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

list-onenote-notebook-sectionsтолько чтениевнешний мир

Извлекает список объектов onenoteSection из указанной записной книжки.

Извлекает список объектов onenoteSection из указанной записной книжки.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: notebookId

  • 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

  • excludeResponseboolean

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

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, когда у вас есть тема.

Получает список объектов страниц. 💡 СОВЕТ: Выводит все страницы 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, когда у вас есть тема.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

list-onenote-section-groupsтолько чтениевнешний мир

Получает список объектов sectionGroup. 💡 TIP: Выводит все группы разделов OneNote (вложенные папки внутри записных книжек, содержащие собственные разделы и вложенные группы разделов) для пользователя. Группа разделов — это контейнер, похожий на папку: многие записные книжки используют их для организации разделов по темам. Сортировка по умолчанию — по имени по возрастанию. Поддерживает $expand=sections,sectionGroups,parentNotebook,parentSectionGroup для обхода всей иерархии. Используйте вместе с list-onenote-notebooks для получения полной структуры записной книжки пользователя.

Получает список объектов sectionGroup. 💡 TIP: Выводит все группы разделов OneNote (вложенные папки внутри записных книжек, содержащие собственные разделы и вложенные группы разделов) для пользователя. Группа разделов — это контейнер, похожий на папку: многие записные книжки используют их для организации разделов по темам. Сортировка по умолчанию — по имени по возрастанию. Поддерживает $expand=sections,sectionGroups,parentNotebook,parentSectionGroup для обхода всей иерархии. Используйте вместе с list-onenote-notebooks для получения полной структуры записной книжки пользователя.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

list-onenote-section-pagesтолько чтениевнешний мир

Извлекает список объектов страниц из указанного раздела.

Извлекает список объектов страниц из указанного раздела.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: onenoteSectionId

  • 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

  • excludeResponseboolean

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

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

Получает все категории, определённые для пользователя. 💡 ПОДСКАЗКА: Перечисляет категории Outlook пользователя (цветные метки), используемые для маркировки сообщений, событий, контактов и задач. Каждая категория имеет displayName и color (от preset0 до preset24 или 'none'). Используйте это для отображения доступных меток перед применением через update-mail-message или update-calendar-event с телом { categories: ['Category Name'] }.

Получает все категории, определённые для пользователя. 💡 ПОДСКАЗКА: Перечисляет категории Outlook пользователя (цветные метки), используемые для маркировки сообщений, событий, контактов и задач. Каждая категория имеет displayName и color (от preset0 до preset24 или 'none'). Используйте это для отображения доступных меток перед применением через update-mail-message или update-calendar-event с телом { categories: ['Category Name'] }.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Получает коллекцию контактов из папки контактов по умолчанию вошедшего в систему пользователя. Есть два сценария, при которых приложение может получать контакты из папки контактов другого пользователя: 💡 СОВЕТ: $filter поддерживает только startswith() — contains() и eq для emailAddresses не работают. В качестве альтернативы для более широкого поиска используйте $search.

Получает коллекцию контактов из папки контактов по умолчанию вошедшего в систему пользователя. Есть два сценария, при которых приложение может получать контакты из папки контактов другого пользователя: 💡 СОВЕТ: $filter поддерживает только startswith() — contains() и eq для emailAddresses не работают. В качестве альтернативы для более широкого поиска используйте $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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Извлекает список объектов plannerBucket, содержащихся в объекте plannerPlan.

Извлекает список объектов plannerBucket, содержащихся в объекте plannerPlan.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: plannerPlanId

  • 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

  • excludeResponseboolean

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

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

[beta] Получает список объектов plannerTaskChatMessage, связанных с plannerTask. 💡 СОВЕТ: Перечисляет сообщения в чате задачи Planner — современный «чат задачи» Planner, отличный от комментариев legacy conversationThreadId (которые находятся в ветке обсуждения группы M365). Каждое сообщение содержит id, content (HTML), createdBy, createdDateTime, mentions, reactions. BETA Graph API: может изменяться; только делегированные рабочие/учебные учетные записи — без разрешений приложения, без личных учетных записей Microsoft, только глобальное облако (не GCC/DoD/21Vianet).

[beta] Получает список объектов plannerTaskChatMessage, связанных с plannerTask. 💡 СОВЕТ: Перечисляет сообщения в чате задачи Planner — современный «чат задачи» Planner, отличный от комментариев legacy conversationThreadId (которые находятся в ветке обсуждения группы M365). Каждое сообщение содержит id, content (HTML), createdBy, createdDateTime, mentions, reactions. BETA Graph API: может изменяться; только делегированные рабочие/учебные учетные записи — без разрешений приложения, без личных учетных записей Microsoft, только глобальное облако (не GCC/DoD/21Vianet).

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: plannerTaskId

  • 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

  • excludeResponseboolean

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

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

Получает список объектов plannertask, назначенных пользователю. 💡 TIP: Значения приоритета: 0=Срочно, 1=Важно, 3=Средний, 5=Низкий, 9=Не задан.

Получает список объектов plannertask, назначенных пользователю. 💡 TIP: Значения приоритета: 0=Срочно, 1=Важно, 3=Средний, 5=Низкий, 9=Не задан.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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

Получает список объектов plannerTask, связанных с объектом plannerPlan. 💡 СОВЕТ: Значения приоритетов: 0=Срочный, 1=Важный, 3=Средний, 5=Низкий, 9=не установлен.

Получает список объектов plannerTask, связанных с объектом plannerPlan. 💡 СОВЕТ: Значения приоритетов: 0=Срочный, 1=Важный, 3=Средний, 5=Низкий, 9=не установлен.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: plannerPlanId

  • 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

  • excludeResponseboolean

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

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

События в календаре. Навигационное свойство. Только для чтения. 💡 СОВЕТ: ПРЕДУПРЕЖДЕНИЕ: НЕ расширяет повторяющиеся события - возвращает только seriesMaster. Вместо этого используйте get-specific-calendar-view.

События в календаре. Навигационное свойство. Только для чтения. 💡 СОВЕТ: ПРЕДУПРЕЖДЕНИЕ: НЕ расширяет повторяющиеся события - возвращает только seriesMaster. Вместо этого используйте get-specific-calendar-view.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: calendarId

  • 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

  • excludeResponseboolean

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

  • 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.

  • expandExtendedPropertiesboolean

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

list-subscriptionsтолько чтениевнешний мир

Извлекает свойства и связи подписок webhook на основе идентификатора приложения, пользователя и его роли в тенанте. Содержимое ответа зависит от контекста, в котором приложение выполняет вызов; подробнее см. сценарии в разделе Permissions. 💡 СОВЕТ: Перечисляет подписки webhook, принадлежащие текущему приложению/пользователю. Возвращает id, resource, changeType, notificationUrl, expirationDateTime, clientState. Используйте $filter=resource eq '/me/messages', чтобы найти подписки для конкретного ресурса. Не существует выделенной области 'Subscription.*': у вызывающего уже должно быть разрешение на чтение подписанного ресурса (например, Mail.Read для /me/messages), которое предоставляется инструментом, читающим этот ресурс.

Извлекает свойства и связи подписок webhook на основе идентификатора приложения, пользователя и его роли в тенанте. Содержимое ответа зависит от контекста, в котором приложение выполняет вызов; подробнее см. сценарии в разделе Permissions. 💡 СОВЕТ: Перечисляет подписки webhook, принадлежащие текущему приложению/пользователю. Возвращает id, resource, changeType, notificationUrl, expirationDateTime, clientState. Используйте $filter=resource eq '/me/messages', чтобы найти подписки для конкретного ресурса. Не существует выделенной области 'Subscription.*': у вызывающего уже должно быть разрешение на чтение подписанного ресурса (например, Mail.Read для /me/messages), которое предоставляется инструментом, читающим этот ресурс.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

list-supported-languagesтолько чтениевнешний мир

Получает список локалей и языков, которые поддерживаются для пользователя, как настроено на почтовом сервере пользователя. При настройке клиента Outlook пользователь выбирает предпочтительный язык из этого поддерживаемого списка. Затем можно получить предпочтительный язык, получив настройки почтового ящика пользователя. 💡 ПОДСКАЗКА: Перечисляет локали и языки, которые почтовый сервер пользователя поддерживает для интерфейса Outlook и отображения сообщений. Возвращает объекты localeInfo с локалью (например, 'en-US') и displayName ('English (United States)'). Используйте это, чтобы проверить значение локали перед вызовом update-mailbox-settings для изменения предпочтительного языка пользователя.

Получает список локалей и языков, которые поддерживаются для пользователя, как настроено на почтовом сервере пользователя. При настройке клиента Outlook пользователь выбирает предпочтительный язык из этого поддерживаемого списка. Затем можно получить предпочтительный язык, получив настройки почтового ящика пользователя. 💡 ПОДСКАЗКА: Перечисляет локали и языки, которые почтовый сервер пользователя поддерживает для интерфейса Outlook и отображения сообщений. Возвращает объекты localeInfo с локалью (например, 'en-US') и displayName ('English (United States)'). Используйте это, чтобы проверить значение локали перед вызовом update-mailbox-settings для изменения предпочтительного языка пользователя.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • 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

  • excludeResponseboolean

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

list-supported-time-zonesтолько чтениевнешний мир

Получает список часовых поясов, которые поддерживаются для пользователя, согласно настройкам его почтового сервера. Можно явно указать, что часовые пояса должны быть возвращены в формате часовых поясов Windows или в формате часовых поясов Internet Assigned Numbers Authority (IANA) (также известном как часовые пояса Olson). По умолчанию используется формат Windows. При настройке клиента Outlook пользователь выбирает предпочтительный часовой пояс из этого поддерживаемого списка. Впоследствии можно получить предпочтительный часовой пояс, получив настройки почтового ящика пользователя. 💡 СОВЕТ: Выводит список часовых поясов, которые поддерживает сервер почтового ящика пользователя. Параметр пути TimeZoneStandard должен быть одним из: Windows (по умолчанию — названия часовых поясов Windows, например 'Pacific Standard Time') или Iana (названия IANA/Olson, например 'America/Los_Angeles'). Обратите внимание на PascalCase — это регистрозависимые перечисления, а не строки в нижнем регистре. Возвращает объекты timeZoneInformation с полями alias и displayName. Используйте результат для проверки или поиска значения перед вызовом update-mailbox-settings для изменения предпочтительного часового пояса пользователя — формат должен совпадать с тем, что ожидает сервер.

Получает список часовых поясов, которые поддерживаются для пользователя, согласно настройкам его почтового сервера. Можно явно указать, что часовые пояса должны быть возвращены в формате часовых поясов Windows или в формате часовых поясов Internet Assigned Numbers Authority (IANA) (также известном как часовые пояса Olson). По умолчанию используется формат Windows. При настройке клиента Outlook пользователь выбирает предпочтительный часовой пояс из этого поддерживаемого списка. Впоследствии можно получить предпочтительный часовой пояс, получив настройки почтового ящика пользователя. 💡 СОВЕТ: Выводит список часовых поясов, которые поддерживает сервер почтового ящика пользователя. Параметр пути TimeZoneStandard должен быть одним из: Windows (по умолчанию — названия часовых поясов Windows, например 'Pacific Standard Time') или Iana (названия IANA/Olson, например 'America/Los_Angeles'). Обратите внимание на PascalCase — это регистрозависимые перечисления, а не строки в нижнем регистре. Возвращает объекты timeZoneInformation с полями alias и displayName. Используйте результат для проверки или поиска значения перед вызовом update-mailbox-settings для изменения предпочтительного часового пояса пользователя — формат должен совпадать с тем, что ожидает сервер.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

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

    Path parameter: TimeZoneStandard

  • 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

  • excludeResponseboolean

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

list-todo-linked-resourcesтолько чтениевнешний мир

Получает информацию об одном или нескольких элементах в партнёрском приложении, на основе которых была создана указанная задача. Информация представлена в объекте linkedResource для каждого элемента. Он включает внешний ID элемента в партнёрском приложении и, если применимо, глубокую ссылку на этот элемент в приложении. 💡 ПОДСКАЗКА: Перечисляет ресурсы, связанные с задачей To Do (письма, URL и т.д.). Каждый связанный ресурс имеет displayName, webUrl, applicationName и externalId.

Получает информацию об одном или нескольких элементах в партнёрском приложении, на основе которых была создана указанная задача. Информация представлена в объекте linkedResource для каждого элемента. Он включает внешний ID элемента в партнёрском приложении и, если применимо, глубокую ссылку на этот элемент в приложении. 💡 ПОДСКАЗКА: Перечисляет ресурсы, связанные с задачей To Do (письма, URL и т.д.). Каждый связанный ресурс имеет displayName, webUrl, applicationName и externalId.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: todoTaskListId

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

    Path parameter: todoTaskId

  • 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

  • excludeResponseboolean

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

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

Получает список объектов todoTaskList и их свойства. 💡 СОВЕТ: Перечисляет все списки задач To Do. Возвращает todoTaskList-id, необходимый для всех операций с задачами. Список по умолчанию обычно называется 'Tasks'. ПРИМЕЧАНИЕ: $select НЕ поддерживается этой конечной точкой - не передавайте параметр select, Graph вернёт 400.

Получает список объектов todoTaskList и их свойства. 💡 СОВЕТ: Перечисляет все списки задач To Do. Возвращает todoTaskList-id, необходимый для всех операций с задачами. Список по умолчанию обычно называется 'Tasks'. ПРИМЕЧАНИЕ: $select НЕ поддерживается этой конечной точкой - не передавайте параметр select, Graph вернёт 400.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

  • 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

  • excludeResponseboolean

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

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'.

Получает ресурсы 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'.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • selectstring

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

  • expandstring[]

    Expand related entities

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

    Path parameter: todoTaskListId

  • 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

  • excludeResponseboolean

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

login

Аутентифицирует с учётной записью Microsoft

Аутентифицирует с учётной записью Microsoft

Параметры

  • forceboolean

    Force a new login even if already logged in

logout

Выйти из учетной записи Microsoft

Выйти из учетной записи Microsoft

Параметры

Без параметров.

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

Вызывает действие merge. 💡 СОВЕТ: Объединяет ячейки в указанном диапазоне в одну ячейку. Body: { across: false } объединяет весь диапазон в одну ячейку; { across: true } объединяет каждую строку отдельно. Полезно для создания стилизованных заголовков, баннерных строк и макетов отчётов.

Вызывает действие merge. 💡 СОВЕТ: Объединяет ячейки в указанном диапазоне в одну ячейку. Body: { across: false } объединяет весь диапазон в одну ячейку; { across: true } объединяет каждую строку отдельно. Полезно для создания стилизованных заголовков, баннерных строк и макетов отчётов.

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

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

    Path parameter: workbookWorksheetId

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

    Path parameter: address

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Перемещает сообщение в другую папку в пределах почтового ящика указанного пользователя. Это создаёт новую копию сообщения в целевой папке и удаляет исходное сообщение. 💡 ПОДСКАЗКА: destinationId принимает идентификатор папки или общеизвестное имя (inbox, drafts, sentitems, deleteditems, junkemail, archive).

Перемещает сообщение в другую папку в пределах почтового ящика указанного пользователя. Это создаёт новую копию сообщения в целевой папке и удаляет исходное сообщение. 💡 ПОДСКАЗКА: destinationId принимает идентификатор папки или общеизвестное имя (inbox, drafts, sentitems, deleteditems, junkemail, archive).

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

move-rename-onedrive-itemвнешний мир

Обновляет навигационное свойство items в drives 💡 СОВЕТ: Переместить и/или переименовать файл или папку. Чтобы переместить, укажите parentReference с идентификатором целевой папки. Чтобы переименовать, укажите новое имя. Оба действия можно выполнить в одном запросе.

Обновляет навигационное свойство items в drives 💡 СОВЕТ: Переместить и/или переименовать файл или папку. Чтобы переместить, укажите parentReference с идентификатором целевой папки. Чтобы переименовать, укажите новое имя. Оба действия можно выполнить в одном запросе.

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

parse-teams-urlтолько чтение

Преобразует любой формат URL собрания Teams (короткий /meet/, полный /meetup-join/ или recap с ?threadId=) в стандартный joinWebUrl. Используйте этот инструмент перед list-online-meetings, когда пользователь предоставляет recap или короткий 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 часов), чтобы избежать истечения срока подписки.

Повторно авторизует подписку при получении вызова reauthorizationRequired. 💡 СОВЕТ: Повторно авторизует подписку после получения уведомления о жизненном цикле 'reauthorizationRequired' от Microsoft Graph. Тело запроса не требуется. Должен быть вызван в течение окна reauthorizationRequiredDateTime (обычно 48 часов), чтобы избежать истечения срока подписки.

Параметры

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

    Path parameter: subscriptionId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

remove-account

Удаляет учётную запись Microsoft из кеша. Принимает адрес электронной почты (например, user@outlook.com) или идентификатор учётной записи. Используйте list-accounts, чтобы узнать доступные учётные записи.

Удаляет учётную запись 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: - В теле запроса передаются соответствующие заголовки Internet Message и содержимое MIME, закодированные в base64. - В содержимое MIME добавляются все вложения и свойства S/MIME. Этот метод сохраняет сообщение в папке Sent Items. Альтернативно создается черновик ответа всем получателям сообщения, который можно отправить позже. 💡 СОВЕТ: Ответ всем с сохранением полного HTML-форматирования. Поле 'comment' - это текст вашего ответа.

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

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

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

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

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

search-onedrive-filesтолько чтениевнешний мир

Ищет в иерархии элементов элементы, соответствующие запросу. Вы можете искать в иерархии папок, на всем диске или в файлах, доступных текущему пользователю. 💡 СОВЕТ: Ищет файлы на диске по имени или содержимому. Параметр q ищет в именах файлов, метаданных и содержимом файлов. Возвращает подходящие driveItems с id, name, webUrl, size, lastModifiedDateTime. Сначала используйте list-drives, чтобы получить drive-id.

Ищет в иерархии элементов элементы, соответствующие запросу. Вы можете искать в иерархии папок, на всем диске или в файлах, доступных текущему пользователю. 💡 СОВЕТ: Ищет файлы на диске по имени или содержимому. Параметр q ищет в именах файлов, метаданных и содержимом файлов. Возвращает подходящие driveItems с id, name, webUrl, size, lastModifiedDateTime. Сначала используйте list-drives, чтобы получить drive-id.

Параметры

  • 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.

  • skipnumber

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

  • searchstring

    KQL search query — wrap value in double quotes. Cannot combine with $filter.

  • filterstring

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

  • countboolean

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

  • selectstring

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

  • orderbystring

    Sort expression, e.g. receivedDateTime desc

  • expandstring[]

    Expand related entities

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

    Path parameter: driveId

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

    Path parameter: q

  • 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

  • excludeResponseboolean

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

select-account

Выбирает учётную запись Microsoft по умолчанию. Принимает адрес электронной почты (например, user@outlook.com) или идентификатор учётной записи. Используйте list-accounts, чтобы найти доступные учётные записи.

Выбирает учётную запись Microsoft по умолчанию. Принимает адрес электронной почты (например, user@outlook.com) или идентификатор учётной записи. Используйте list-accounts, чтобы найти доступные учётные записи.

Параметры

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

    Email address or account ID of the account to select

send-draft-messageвнешний мир

Отправляет существующее черновик сообщения. Черновик может быть новым черновиком, черновиком ответа, ответа всем или пересылки. Этот метод сохраняет сообщение в папке «Отправленные». Кроме того, отправляет новое сообщение за одну операцию. 💡 ПОДСКАЗКА: Тело запроса не требуется — достаточно вызвать с идентификатором сообщения. Черновик должен существовать в папке «Черновики».

Отправляет существующее черновик сообщения. Черновик может быть новым черновиком, черновиком ответа, ответа всем или пересылки. Этот метод сохраняет сообщение в папке «Отправленные». Кроме того, отправляет новое сообщение за одну операцию. 💡 ПОДСКАЗКА: Тело запроса не требуется — достаточно вызвать с идентификатором сообщения. Черновик должен существовать в папке «Черновики».

Параметры

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

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

send-mailвнешний мир

Отправляет сообщение, указанное в теле запроса, в формате JSON или MIME. При использовании JSON можно прикрепить файл в том же вызове sendMail. При использовании MIME этот метод сохраняет сообщение в папке "Отправленные". Либо создайте черновик сообщения для отправки позже. Чтобы узнать о действиях на бэкенде перед доставкой письма получателям, см. здесь. 💡 TIP: CRITICAL: Не пытайтесь угадать email-адреса получателей. Используйте инструмент list-users, чтобы найти email-адреса получателей.

Отправляет сообщение, указанное в теле запроса, в формате JSON или MIME. При использовании JSON можно прикрепить файл в том же вызове sendMail. При использовании MIME этот метод сохраняет сообщение в папке "Отправленные". Либо создайте черновик сообщения для отправки позже. Чтобы узнать о действиях на бэкенде перед доставкой письма получателям, см. здесь. 💡 TIP: CRITICAL: Не пытайтесь угадать email-адреса получателей. Используйте инструмент list-users, чтобы найти email-адреса получателей.

Параметры

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

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

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

Отправляет приглашение к совместному использованию для driveItem. Приглашение к совместному использованию предоставляет разрешения получателям и, опционально, отправляет им электронное письмо с уведомлением о том, что элемент был опубликован. 💡 СОВЕТ: Предоставляет доступ к файлу или папке конкретным пользователям. Тело: { recipients: [{ email: 'user@example.com' }], roles: ['read'], sendInvitation: true, message: 'Please review this file.' }. Роли: 'read', 'write', 'owner'. Установите requireSignIn в true, чтобы требовать аутентификацию.

Отправляет приглашение к совместному использованию для driveItem. Приглашение к совместному использованию предоставляет разрешения получателям и, опционально, отправляет им электронное письмо с уведомлением о том, что элемент был опубликован. 💡 СОВЕТ: Предоставляет доступ к файлу или папке конкретным пользователям. Тело: { recipients: [{ email: 'user@example.com' }], roles: ['read'], sendInvitation: true, message: 'Please review this file.' }. Роли: 'read', 'write', 'owner'. Установите requireSignIn в true, чтобы требовать аутентификацию.

Параметры

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

    Path parameter: driveId

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

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

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

  • 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.

snooze-calendar-event-reminderвнешний мир

Переносит напоминание о событии в календаре пользователя на новое время. 💡 ПОДСКАЗКА: Переносит сработавшее напоминание о событии. Тело: { NewReminderTime: { dateTime (ISO 8601), timeZone (IANA или Windows, например 'Pacific Standard Time') } }. Напоминание сработает снова в новое время.

Переносит напоминание о событии в календаре пользователя на новое время. 💡 ПОДСКАЗКА: Переносит сработавшее напоминание о событии. Тело: { NewReminderTime: { dateTime (ISO 8601), timeZone (IANA или Windows, например 'Pacific Standard Time') } }. Напоминание сработает снова в новое время.

Параметры

  • bodyobjectобязательный
  • eventIdstringобязательный

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

sort-excel-rangeвнешний мир

Обновляет свойство навигации sort в drives

Обновляет свойство навигации sort в drives

Параметры

  • bodyobjectобязательный
  • driveIdstringобязательный

    Path parameter: driveId

  • driveItemIdstringобязательный

    Path parameter: driveItemId

  • workbookWorksheetIdstringобязательный

    Path parameter: workbookWorksheetId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

tentatively-accept-calendar-eventвнешний мир

Предварительно принимает указанное событие в календаре пользователя. Если событие допускает предложения нового времени, при предварительном ответе на событие приглашённый может предложить альтернативное время, указав параметр proposedNewTime. Дополнительную информацию о том, как предложить время и как получить и принять новое предложение времени, см. в разделе Propose new meeting times. 💡 СОВЕТ: Предварительно принимает приглашение на встречу. Необязательное тело запроса: { sendResponse: true, comment: 'Возможно, я смогу присутствовать.' }. Используйте proposedNewTime, чтобы предложить альтернативу: { proposedNewTime: { start: { dateTime, timeZone }, end: { dateTime, timeZone } } }.

Предварительно принимает указанное событие в календаре пользователя. Если событие допускает предложения нового времени, при предварительном ответе на событие приглашённый может предложить альтернативное время, указав параметр proposedNewTime. Дополнительную информацию о том, как предложить время и как получить и принять новое предложение времени, см. в разделе Propose new meeting times. 💡 СОВЕТ: Предварительно принимает приглашение на встречу. Необязательное тело запроса: { sendResponse: true, comment: 'Возможно, я смогу присутствовать.' }. Используйте proposedNewTime, чтобы предложить альтернативу: { proposedNewTime: { start: { dateTime, timeZone }, end: { dateTime, timeZone } } }.

Параметры

  • bodyobjectобязательный
  • eventIdstringобязательный

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

unmerge-excel-rangeвнешний мир

Вызвать действие unmerge 💡 СОВЕТ: Разъединяет любые объединённые ячейки в указанном диапазоне, возвращая их к отдельным ячейкам. Тело запроса не требуется. Обратное действие к merge-excel-range.

Вызвать действие unmerge 💡 СОВЕТ: Разъединяет любые объединённые ячейки в указанном диапазоне, возвращая их к отдельным ячейкам. Тело запроса не требуется. Обратное действие к merge-excel-range.

Параметры

  • driveIdstringобязательный

    Path parameter: driveId

  • driveItemIdstringобязательный

    Path parameter: driveItemId

  • workbookWorksheetIdstringобязательный

    Path parameter: workbookWorksheetId

  • addressstringобязательный

    Path parameter: address

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-calendarвнешний мир

Обновляет навигационное свойство calendars в me 💡 СОВЕТ: Обновляет свойства календаря. Тело: { name: 'New Name', color: 'lightBlue' }. Нельзя обновить имя календаря по умолчанию.

Обновляет навигационное свойство calendars в me 💡 СОВЕТ: Обновляет свойства календаря. Тело: { name: 'New Name', color: 'lightBlue' }. Нельзя обновить имя календаря по умолчанию.

Параметры

  • bodyobjectобязательный
  • calendarIdstringобязательный

    Path parameter: calendarId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-calendar-eventвнешний мир

Обновляет свойства объекта события. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей. ПРЕДУПРЕЖДЕНИЕ: Установка участников заменяет весь список участников - включите всех участников, а не только новых.

Обновляет свойства объекта события. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей. ПРЕДУПРЕЖДЕНИЕ: Установка участников заменяет весь список участников - включите всех участников, а не только новых.

Параметры

  • bodyobjectобязательный
  • eventIdstringобязательный

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-contact-folderвнешний мир

Обновляет свойства объекта папки контактов (contactfolder). 💡 СОВЕТ: Обновляет папку контактов. Тело запроса: { displayName?: 'Новое имя', parentFolderId?: '<id>' } - оба поля displayName (переименование) и parentFolderId (перемещение) доступны для записи. Папку 'Контакты' по умолчанию, возможно, нельзя переименовать. Получите идентификатор папки через list-contact-folders.

Обновляет свойства объекта папки контактов (contactfolder). 💡 СОВЕТ: Обновляет папку контактов. Тело запроса: { displayName?: 'Новое имя', parentFolderId?: '<id>' } - оба поля displayName (переименование) и parentFolderId (перемещение) доступны для записи. Папку 'Контакты' по умолчанию, возможно, нельзя переименовать. Получите идентификатор папки через list-contact-folders.

Параметры

  • bodyobjectобязательный
  • contactFolderIdstringобязательный

    Path parameter: contactFolderId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-excel-rangeвнешний мир

Устанавливает значения ячеек, формулы или числовой формат для любого диапазона — НЕ требует, чтобы лист был формальной таблицей Excel. Body: { values: [['v1','v2','v3']] } для одной строки или [['a','b'],['c','d']] для нескольких строк. Используйте это для добавления (укажите адрес следующей пустой строки, например 'A172:H172'), обновления (укажите одну ячейку, например 'H42') или вставки в начало (прочитайте существующие данные, объедините, запишите обратно). Количество значений во внутренних массивах должно совпадать с количеством столбцов в адресе. 💡 СОВЕТ: Устанавливает значения ячеек, формулы или числовой формат для любого диапазона — НЕ требует, чтобы лист был формальной таблицей Excel. Body: { values: [['v1','v2','v3']] } для одной строки или [['a','b'],['c','d']] для нескольких строк. Используйте это для добавления (укажите адрес следующей пустой строки, например 'A172:H172'), обновления (укажите одну ячейку, например 'H42') или вставки в начало (прочитайте существующие данные, объедините, запишите обратно). Количество значений во внутренних массивах должно совпадать с количеством столбцов в адресе.

Устанавливает значения ячеек, формулы или числовой формат для любого диапазона — НЕ требует, чтобы лист был формальной таблицей Excel. Body: { values: [['v1','v2','v3']] } для одной строки или [['a','b'],['c','d']] для нескольких строк. Используйте это для добавления (укажите адрес следующей пустой строки, например 'A172:H172'), обновления (укажите одну ячейку, например 'H42') или вставки в начало (прочитайте существующие данные, объедините, запишите обратно). Количество значений во внутренних массивах должно совпадать с количеством столбцов в адресе. 💡 СОВЕТ: Устанавливает значения ячеек, формулы или числовой формат для любого диапазона — НЕ требует, чтобы лист был формальной таблицей Excel. Body: { values: [['v1','v2','v3']] } для одной строки или [['a','b'],['c','d']] для нескольких строк. Используйте это для добавления (укажите адрес следующей пустой строки, например 'A172:H172'), обновления (укажите одну ячейку, например 'H42') или вставки в начало (прочитайте существующие данные, объедините, запишите обратно). Количество значений во внутренних массивах должно совпадать с количеством столбцов в адресе.

Параметры

  • bodyobjectобязательный
  • driveIdstringобязательный

    Path parameter: drive-id

  • driveItemIdstringобязательный

    Path parameter: driveItem-id

  • workbookWorksheetIdstringобязательный

    Path parameter: workbookWorksheet-id

  • addressstringобязательный

    Path parameter: address

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-excel-table-rowвнешний мир

Обновляет одну строку в структурированной таблице Excel по индексу строки, отсчитываемому от нуля. Тело: { values: [[...]] } с одним внутренним массивом, соответствующим количеству столбцов. 💡 СОВЕТ: Обновляет одну строку в структурированной таблице Excel по индексу строки, отсчитываемому от нуля. Тело: { values: [[...]] } с одним внутренним массивом, соответствующим количеству столбцов.

Обновляет одну строку в структурированной таблице Excel по индексу строки, отсчитываемому от нуля. Тело: { values: [[...]] } с одним внутренним массивом, соответствующим количеству столбцов. 💡 СОВЕТ: Обновляет одну строку в структурированной таблице Excel по индексу строки, отсчитываемому от нуля. Тело: { values: [[...]] } с одним внутренним массивом, соответствующим количеству столбцов.

Параметры

  • bodyobjectобязательный
  • driveIdstringобязательный

    Path parameter: drive-id

  • driveItemIdstringобязательный

    Path parameter: driveItem-id

  • workbookTableIdstringобязательный

    Path parameter: workbookTable-id

  • indexstringобязательный

    Path parameter: index

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-focused-inbox-overrideвнешний мир

Измените поле classifyAs переопределения, как указано. Вы не можете использовать PATCH для изменения других полей в экземпляре inferenceClassificationOverride. Если для отправителя существует переопределение и отправитель изменил своё отображаемое имя, вы можете использовать POST для принудительного обновления поля name в существующем переопределении. Если для отправителя существует переопределение и отправитель изменил свой SMTP-адрес, удаление существующего переопределения и создание нового с новым SMTP-адресом - единственный способ 'обновить' переопределение для этого отправителя. 💡 СОВЕТ: Обновляет поле classifyAs существующего переопределения. Тело: { classifyAs: 'focused' } или { classifyAs: 'other' }. Согласно Graph API, PATCH не может изменить senderEmailAddress - чтобы изменить SMTP-адрес, удалите и создайте переопределение заново. Чтобы переименовать только отображаемое имя, отправьте POST с новым переопределением с тем же SMTP-адресом (он перезапишет имя).

Измените поле classifyAs переопределения, как указано. Вы не можете использовать PATCH для изменения других полей в экземпляре inferenceClassificationOverride. Если для отправителя существует переопределение и отправитель изменил своё отображаемое имя, вы можете использовать POST для принудительного обновления поля name в существующем переопределении. Если для отправителя существует переопределение и отправитель изменил свой SMTP-адрес, удаление существующего переопределения и создание нового с новым SMTP-адресом - единственный способ 'обновить' переопределение для этого отправителя. 💡 СОВЕТ: Обновляет поле classifyAs существующего переопределения. Тело: { classifyAs: 'focused' } или { classifyAs: 'other' }. Согласно Graph API, PATCH не может изменить senderEmailAddress - чтобы изменить SMTP-адрес, удалите и создайте переопределение заново. Чтобы переименовать только отображаемое имя, отправьте POST с новым переопределением с тем же SMTP-адресом (он перезапишет имя).

Параметры

  • bodyobjectобязательный
  • inferenceClassificationOverrideIdstringобязательный

    Path parameter: inferenceClassificationOverrideId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-mailbox-settingsвнешний мир

Включает, настраивает или отключает один или несколько из следующих параметров в составе mailboxSettings пользователя: при обновлении предпочтительного формата даты или времени для пользователя указывайте его в формате короткой даты или короткого времени соответственно. При обновлении предпочтительного часового пояса для пользователя указывайте его в формате часового пояса Windows или IANA (также известного как часовой пояс Olson). Вы также можете дополнительно настроить часовой пояс, как показано в примере 2 ниже. 💡 ПОДСКАЗКА: Обновляет настройки почтового ящика. Типичное применение: настройка автоответа (автоматических ответов). Пример тела запроса: { 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.

Включает, настраивает или отключает один или несколько из следующих параметров в составе mailboxSettings пользователя: при обновлении предпочтительного формата даты или времени для пользователя указывайте его в формате короткой даты или короткого времени соответственно. При обновлении предпочтительного часового пояса для пользователя указывайте его в формате часового пояса Windows или IANA (также известного как часовой пояс Olson). Вы также можете дополнительно настроить часовой пояс, как показано в примере 2 ниже. 💡 ПОДСКАЗКА: Обновляет настройки почтового ящика. Типичное применение: настройка автоответа (автоматических ответов). Пример тела запроса: { 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обязательный
  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-mail-folderвнешний мир

Обновляет свойства объекта mailfolder. 💡 Совет: Переименовывает почтовую папку, обновляя её displayName. Используйте list-mail-folders, чтобы найти ID папки.

Обновляет свойства объекта mailfolder. 💡 Совет: Переименовывает почтовую папку, обновляя её displayName. Используйте list-mail-folders, чтобы найти ID папки.

Параметры

  • bodyobjectобязательный
  • mailFolderIdstringобязательный

    Path parameter: mailFolderId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-mail-messageвнешний мир

Обновляет свойства объекта eventMessage.

Обновляет свойства объекта eventMessage.

Параметры

  • bodyobjectобязательный
  • messageIdstringобязательный

    Path parameter: messageId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-mail-ruleвнешний мир

Изменяет записываемые свойства объекта messageRule и сохраняет изменения. 💡 TIP: Обновляет существующее правило сообщений. Используйте идентификатор папки «Входящие» (получить его можно из list-mail-folders) для правил входящих сообщений. Отправляйте только те свойства, которые нужно изменить. Типичное использование: { isEnabled: false } для отключения правила или обновления условий/действий.

Изменяет записываемые свойства объекта messageRule и сохраняет изменения. 💡 TIP: Обновляет существующее правило сообщений. Используйте идентификатор папки «Входящие» (получить его можно из list-mail-folders) для правил входящих сообщений. Отправляйте только те свойства, которые нужно изменить. Типичное использование: { isEnabled: false } для отключения правила или обновления условий/действий.

Параметры

  • bodyobjectобязательный
  • mailFolderIdstringобязательный

    Path parameter: mailFolderId

  • messageRuleIdstringобязательный

    Path parameter: messageRuleId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-my-calendar-permissionвнешний мир

Обновляет свойство навигации calendarPermissions в me 💡 СОВЕТ: Изменяет роль (уровень разрешений), предоставленную существующему получателю общего доступа или делегату. Тело: { role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' }. Только свойство role доступно для записи. Чтобы изменить адрес электронной почты получателя или другие свойства, удалите и создайте заново с помощью delete-my-calendar-permission + create-my-calendar-permission. Получите идентификатор разрешения через list-my-calendar-permissions.

Обновляет свойство навигации calendarPermissions в me 💡 СОВЕТ: Изменяет роль (уровень разрешений), предоставленную существующему получателю общего доступа или делегату. Тело: { role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' }. Только свойство role доступно для записи. Чтобы изменить адрес электронной почты получателя или другие свойства, удалите и создайте заново с помощью delete-my-calendar-permission + create-my-calendar-permission. Получите идентификатор разрешения через list-my-calendar-permissions.

Параметры

  • bodyobjectобязательный
  • calendarPermissionIdstringобязательный

    Path parameter: calendarPermissionId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-outlook-contactвнешний мир

Обновляет свойства объекта контакта. 💡 Совет: массив emailAddresses заменяется полностью — включите все адреса, а не только новые.

Обновляет свойства объекта контакта. 💡 Совет: массив emailAddresses заменяется полностью — включите все адреса, а не только новые.

Параметры

  • bodyobjectобязательный
  • contactIdstringобязательный

    Path parameter: contactId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-planner-bucketвнешний мир

Обновляет свойства объекта plannerbucket. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match с ETag из get-planner-bucket (используйте includeHeaders=true).

Обновляет свойства объекта plannerbucket. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match с ETag из get-planner-bucket (используйте includeHeaders=true).

Параметры

  • bodyobjectобязательный
  • If-Matchstringобязательный

    ETag value.

  • plannerBucketIdstringобязательный

    Path parameter: plannerBucketId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-planner-taskвнешний мир

Обновляет свойства объекта plannerTask. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match со значением @odata.etag задачи, иначе возвращается 412 Precondition Failed. Получите ETag из get-planner-task с параметром includeHeaders=true. Значения приоритета: 0=Срочный, 1=Важный, 3=Средний, 5=Низкий, 9=не задан.

Обновляет свойства объекта plannerTask. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match со значением @odata.etag задачи, иначе возвращается 412 Precondition Failed. Получите ETag из get-planner-task с параметром includeHeaders=true. Значения приоритета: 0=Срочный, 1=Важный, 3=Средний, 5=Низкий, 9=не задан.

Параметры

  • bodyobjectобязательный
  • If-Matchstringобязательный

    ETag value.

  • plannerTaskIdstringобязательный

    Path parameter: plannerTaskId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-planner-task-detailsвнешний мир

Обновите свойства объекта plannerTaskDetails. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match с ETag из get-planner-task-details (используйте includeHeaders=true). Элементы контрольного списка используют ключи GUID: {"checklist": {"<guid>": {"title": "...", "isChecked": false}}}.

Обновите свойства объекта plannerTaskDetails. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match с ETag из get-planner-task-details (используйте includeHeaders=true). Элементы контрольного списка используют ключи GUID: {"checklist": {"<guid>": {"title": "...", "isChecked": false}}}.

Параметры

  • bodyobjectобязательный
  • If-Matchstringобязательный

    ETag value.

  • plannerTaskIdstringобязательный

    Path parameter: plannerTaskId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-specific-calendar-eventвнешний мир

Обновляет свойство навигации events в me 💡 СОВЕТ: КРИТИЧЕСКИ: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей. ПРЕДУПРЕЖДЕНИЕ: Установка attendees заменяет весь список участников: включите всех участников, а не только новых.

Обновляет свойство навигации events в me 💡 СОВЕТ: КРИТИЧЕСКИ: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей. ПРЕДУПРЕЖДЕНИЕ: Установка attendees заменяет весь список участников: включите всех участников, а не только новых.

Параметры

  • bodyobjectобязательный
  • calendarIdstringобязательный

    Path parameter: calendarId

  • eventIdstringобязательный

    Path parameter: eventId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-subscriptionвнешний мир

Продлевает подписку, увеличивая её срок действия. Таблица в разделе Permissions перечисляет ресурсы, поддерживающие подписку на уведомления об изменениях. Подписки истекают через разное время в зависимости от типа ресурса. Чтобы не пропустить уведомления об изменениях, приложение должно продлевать подписки задолго до их срока истечения. См. subscription для максимальной длительности подписки для каждого типа ресурса. 💡 TIP: Продлевает подписку webhook, увеличивая срок её действия. Тело: { expirationDateTime (ISO 8601, новый срок истечения) }. Вызовите до текущего expirationDateTime, чтобы не пропустить уведомления. Максимальное продление зависит от типа ресурса — проверьте документацию Microsoft Graph по ограничениям подписок.

Продлевает подписку, увеличивая её срок действия. Таблица в разделе Permissions перечисляет ресурсы, поддерживающие подписку на уведомления об изменениях. Подписки истекают через разное время в зависимости от типа ресурса. Чтобы не пропустить уведомления об изменениях, приложение должно продлевать подписки задолго до их срока истечения. См. subscription для максимальной длительности подписки для каждого типа ресурса. 💡 TIP: Продлевает подписку webhook, увеличивая срок её действия. Тело: { expirationDateTime (ISO 8601, новый срок истечения) }. Вызовите до текущего expirationDateTime, чтобы не пропустить уведомления. Максимальное продление зависит от типа ресурса — проверьте документацию Microsoft Graph по ограничениям подписок.

Параметры

  • bodyobjectобязательный
  • subscriptionIdstringобязательный

    Path parameter: subscriptionId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-todo-taskвнешний мир

Обновляет свойства объекта todoTask.

Обновляет свойства объекта todoTask.

Параметры

  • bodyobjectобязательный
  • todoTaskListIdstringобязательный

    Path parameter: todoTaskListId

  • todoTaskIdstringобязательный

    Path parameter: todoTaskId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

update-todo-task-listвнешний мир

Обновляет свойства объекта todoTaskList. 💡 СОВЕТ: Переименовывает список задач Microsoft To Do. Body: { displayName: 'New name' }. Только displayName доступен для записи. Встроенные списки (Помеченные сообщения, список задач по умолчанию) нельзя переименовать, API возвращает ошибку. Получите идентификаторы списков через list-todo-task-lists.

Обновляет свойства объекта todoTaskList. 💡 СОВЕТ: Переименовывает список задач Microsoft To Do. Body: { displayName: 'New name' }. Только displayName доступен для записи. Встроенные списки (Помеченные сообщения, список задач по умолчанию) нельзя переименовать, API возвращает ошибку. Получите идентификаторы списков через list-todo-task-lists.

Параметры

  • bodyobjectобязательный
  • todoTaskListIdstringобязательный

    Path parameter: todoTaskListId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

upload-file-contentвнешний мир

Поток содержимого, если элемент представляет файл. 💡 ПОДСКАЗКА: тело — это строка байтов файла, закодированная в base64; сервер декодирует её перед PUT. Максимум 4 МБ встроенного содержимого (для размеров более 4 МБ используйте create-upload-session). Для новых файлов используйте формат пути: /items/root:/path/to/file.txt:/content. Перезаписывает существующие файлы без предупреждения.

Поток содержимого, если элемент представляет файл. 💡 ПОДСКАЗКА: тело — это строка байтов файла, закодированная в base64; сервер декодирует её перед PUT. Максимум 4 МБ встроенного содержимого (для размеров более 4 МБ используйте create-upload-session). Для новых файлов используйте формат пути: /items/root:/path/to/file.txt:/content. Перезаписывает существующие файлы без предупреждения.

Параметры

  • bodystringобязательный

    Base64-encoded file content. The server decodes it and PUTs the raw bytes to Microsoft Graph.

  • driveIdstringобязательный

    Path parameter: driveId

  • driveItemIdstringобязательный

    Path parameter: driveItemId

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

upload-my-profile-photoвнешний мир

Обновляет фотографию для указанного контакта, группы, команды или пользователя в арендаторе. Размер фотографии, которую можно загрузить, ограничен 4 МБ. Для этой операции можно использовать PATCH или PUT. 💡 СОВЕТ: Загружает новую фотографию профиля для вошедшего в систему пользователя. Тело запроса — строка в кодировке base64 с байтами изображения (сервер декодирует их перед PUT). Фотография должна быть в формате JPEG, не более 4 МБ. Microsoft 365 автоматически создаёт уменьшенные HD-варианты (48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, 648x648). Для рабочих или учебных учётных записей разрешение ProfilePhoto.ReadWrite.All — более точная альтернатива. Используйте download-bytes с target=/me/photo/$value, чтобы получить текущую фотографию.

Обновляет фотографию для указанного контакта, группы, команды или пользователя в арендаторе. Размер фотографии, которую можно загрузить, ограничен 4 МБ. Для этой операции можно использовать PATCH или PUT. 💡 СОВЕТ: Загружает новую фотографию профиля для вошедшего в систему пользователя. Тело запроса — строка в кодировке base64 с байтами изображения (сервер декодирует их перед PUT). Фотография должна быть в формате JPEG, не более 4 МБ. 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.

  • includeHeadersboolean

    Include response headers (including ETag) in the response metadata

  • excludeResponseboolean

    Exclude the full response body and only return success or failure indication

  • 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.

verify-login

Проверяет текущий статус аутентификации Microsoft

Проверяет текущий статус аутентификации Microsoft

Параметры

Без параметров.

Другие проверенные MCP-сервера

snyk/studio-mcp

snyk/studio-mcp

официальный

MCP-сервер Snyk интегрирует сканирование безопасности в AI-инструменты. Запускает SCA, SAST, IaC-проверки и возвращает уязвимости. Полезен для DevSecOps-пайплайнов. Управляется через `snyk mcp`.

Go53
jae-jae/fetcher-mcp

jae-jae/fetcher-mcp

MCP сервер для извлечения веб-контента через Playwright. Работает с динамическими сайтами, поддерживает JavaScript, умное выделение текста и пакетную загрузку. Идеален для сбора данных и разработки.

TypeScript1065
redis/mcp-redis-cloud

redis/mcp-redis-cloud

официальный

MCP сервер для Redis Cloud API: управляйте подписками, базами данных и задачами на естественном языке через Claude Desktop, Cursor или любой MCP клиент без необходимости писать код.

TypeScript40
Vultr MCP

Vultr MCP

официальный

Сервер Vultr MCP позволяет AI-агентам управлять облачными ресурсами через естественный язык. Инструменты генерируются из OpenAPI, поддерживаются STDIO и HTTP, аутентификация по API ключу и OAuth. Подходит для DevOps.

Python1
sooperset/mcp-atlassian

sooperset/mcp-atlassian

MCP сервер для Atlassian (Confluence и Jira, Cloud и Server/Data Center). AI-агенты используют 72 инструмента: поиск, создание, обновление задач и страниц, комментарии и статусы, ускоряя разработку.

Python5583
eyaltoledano/claude-task-master

eyaltoledano/claude-task-master

Taskmaster — система управления задачами для AI-разработки, подключаемая через MCP к Cursor, Claude Code и другим редакторам. Разбивает PRD на задачи, отслеживает прогресс и управляет разработкой п...

JavaScript27867
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин