read_email

macOS

目的

Mac の Apple Mail にあるメールの全文をユーザーが求めている場合に使用します（message ID は list_emails/search_emails から取得）。m365_list_emails の Microsoft 365 message ID には m365_read_email を使用してください。すべてのアカウントを走査せず 1 つを対象にするため、list_emails/search_emails が返す account= を渡し、分かる場合は mailbox= も渡します。並列ではなく順番に呼び出してください。同時呼び出しは Mail.app の JXA ロックで直列化され、後続がタイムアウトします。 パフォーマンス: 本文取得が主な遅延要因です（遅い IMAP では平均 20 秒）。本文を省略して高速なメタデータだけを得るには include_body=false を渡します。HTML 除去後の本文を N 文字に制限するには max_body_chars=N を渡します（既定 30000、0=無制限）。取得に 2 秒超かかった場合は body_fetch_ms、省略時は body_omitted=true、切り詰め時は body_truncated_at=N が応答に含まれます。 本文がこの Mac にキャッシュされていない場合、Mail に取得させず、body_omitted=true と body_omit_reason="not_downloaded"（iCloud/IMAP の最適化ストレージ）を含むメタデータを返します。ユーザーが本文を必要とする場合は force_download=true で再試行し、Mail に IMAP 経由で本文を取得させて返します（最大約 60 秒待機）。既定では無効で、Mail のクールダウン中は無視されます。

必須入力

• message_id

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

• このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

{
  "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"
}