list_email_folders

macOS

Назначение

Перечисляет полное дерево папок (почтовых ящиков) учетных записей Apple Mail (Mail.app), включая вложенные папки. Используйте его, чтобы узнать точные имена папок, ожидаемые move_email(target_mailbox=...) и list_emails(mailbox=...). Учитываются Outlook.com, Exchange, Gmail, iCloud и IMAP, добавленные в Mail.app. Для почтового ящика Microsoft 365, подключенного только через Graph и не добавленного в Mail.app, используйте m365_list_emails. Передайте account=<name> из list_email_accounts, чтобы полностью перечислить одну учетную запись; без этого будут просмотрены все учетные записи, что может быть медленно в macOS 15 и новее. Подсчет сообщений по умолчанию выключен, поскольку медленен для IMAP; передайте include_counts=true, чтобы добавить число непрочитанных и общее число сообщений в каждой папке (из локального индекса Mail, если названная учетная запись определяется с диска, либо из собственного актуального подсчета Mail.app в остальных случаях — в обоих случаях см. unread_count_note в ответе).

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

• Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

{
  "properties": {
    "account": {
      "description": "Mail.app account whose folder tree to list (from list_email_accounts). Defaults to every account.",
      "type": "string"
    },
    "include_counts": {
      "default": "false",
      "description": "Include the message count of each folder. Slower, because each folder has to be counted.",
      "type": "boolean"
    }
  },
  "type": "object"
}

Пример для документации

Пример документации для list_email_folders. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{}