list_email_folders

macOS

用途

列出 Apple 邮件（Mail.app）账户的完整文件夹（邮箱）树，包括嵌套的子文件夹。用它来查找 move_email(target_mailbox=...) 和 list_emails(mailbox=...) 所需的确切文件夹名称。添加到 Mail.app 的 Outlook.com、Exchange、Gmail、iCloud 和 IMAP 账户均包含在内。对于未添加到 Mail.app、仅通过 Graph 访问的 Microsoft 365 邮箱，请改用 m365_list_emails。 传入 account=<name>（来自 list_email_accounts）可完整枚举单个账户；不传时会遍历每个账户，在 macOS 15+ 上可能较慢。邮件数量默认关闭（IMAP 上较慢）；传入 include_counts=true 可为每个文件夹添加未读/总数（当指定账户可从磁盘解析时取自 Mail 的本地索引，否则取自 Mail.app 自身的实时计数；两种情况都请参见响应中的 unread_count_note）。

必填输入

此平台的架构未声明必填输入，但仍可能存在可选选择器或运行时要求。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

• 仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

{
  "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 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{}