list_emails

电子邮件 · macOS

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

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

macOS

用途

当用户希望在这台 Mac 上查看或整理收件箱时使用此工具（Apple Mail；包括添加到 Mail.app 的任何账户：iCloud、Gmail、IMAP、Exchange）。它会列出邮件标头（主题、发件人、日期、未读状态）；调用 read_email(message_id) 获取完整正文。对于未添加到 Mail.app 的 Microsoft 365 邮箱，请使用 m365_list_emails。重要：在拥有 2 个或更多账户的机器上，调用时应传入 account=<name>（来自 list_email_accounts）。如果不传，且快速索引无法回答，list_emails 会返回账户列表，而不是扫描所有账户；一次调用扫描每个账户没有时间限制，也可能阻塞 Mail 的其他请求（#2268）。只有 1 个账户时不受影响。支持分页：使用 offset 翻页（例如 limit=20 时，offset=20 表示第 2 页）。每次调用的 limit 参数上限为 50（默认 20）；若要读取更多内容，请使用 offset 分页，而不要请求更大的 limit。

必填输入

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

权限与确认

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

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

英文规范技术架构 — macOS

{
  "properties": {
    "account": {
      "type": "string"
    },
    "limit": {
      "default": "20",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "offset": {
      "default": "0",
      "minimum": 0,
      "type": "integer"
    },
    "unread_only": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

文档示例

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

{
  "limit": 5
}