read_email

macOS

用途

当用户需要读取 Mac 的 Apple Mail 中某封电子邮件的完整内容时使用此工具（邮件 ID 来自 list_emails/search_emails）。对于由 m365_list_emails 返回的 Microsoft 365 邮件 ID，请使用 m365_read_email。请传入 account=（如果已知，还应传入 mailbox=；二者均来自 list_emails/search_emails），以便查找仅针对一个账户，而不是扫描所有账户。请顺序调用，不要并行调用——并发调用会在 Mail.app 的 JXA 锁之后依次执行，后续调用将会超时。 性能：获取正文是主要的延迟来源（在较慢的 IMAP 上平均为 20s）。传入 include_body=false 可跳过正文，仅获取元数据（速度快）。传入 max_body_chars=N 可在去除 HTML 后将正文限制为 N 个字符（默认 30000；0=无限制）。获取耗时 >2s 时，响应包含 body_fetch_ms；跳过正文时包含 body_omitted=true；正文被截断时包含 body_truncated_at=N。 当正文未缓存在此 Mac 上时，read_email 会返回元数据以及 body_omitted=true 和 body_omit_reason="not_downloaded"（iCloud/IMAP 优化存储），而不会让 Mail 获取正文（该操作可能很慢并占用 Mail）。如果用户仍希望获取正文，请使用 force_download=true 重试，让 Mail 立即通过 IMAP 拉取正文并返回（最多等待约 60s）。默认关闭；当 Mail 处于冷却期时会被忽略。

必填输入

• message_id

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

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

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

{
  "properties": {
    "account": {
      "type": "string"
    },
    "force_download": {
      "default": "false",
      "type": "boolean"
    },
    "include_body": {
      "default": "true",
      "type": "boolean"
    },
    "mailbox": {
      "type": "string"
    },
    "max_body_chars": {
      "default": "30000",
      "minimum": 0,
      "type": "integer"
    },
    "message_id": {
      "type": "string"
    }
  },
  "required": [
    "message_id"
  ],
  "type": "object"
}

文档示例

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

{
  "message_id": "demo-message-001"
}