mail_list_thread

List every email in a thread, given the Message-ID of any message in it. Results are sorted by date ascending.

Parameters

Parameter	Type	Required	Description
account_id	string	Yes	Account ID
message_id	string	Yes	Message-ID header value of any email in the thread

Missing or non-string values return JSON-RPC error -32602.

Example

{
  "tool": "mail_list_thread",
  "arguments": {
    "account_id": "acc1",
    "message_id": "<[email protected]>"
  }
}

Gates and denial reasons

Read tool. Requires Mail enabled, a ready helper, a non-deny global tool policy, and Allow AI to read Mail. Failures return JSON-RPC error -32008 with one of mail_feature_disabled, mail_helper_unavailable, mail_global_policy_denied, or mail_read_consent_required. Full ordering: API Reference.