list_email_folders

电子邮件 · macOS

效果: 读取. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

列出 Apple Mail（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 可为每个文件夹添加未读数和总数。

必填输入

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

权限与确认

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

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

英文规范技术架构 — macOS

{
  "properties": {
    "account": {
      "type": "string"
    },
    "include_counts": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

文档示例

list_email_folders 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{}