Skip to content

mail_get_email

Get one email in full, including body, headers, and attachment metadata.

ParameterTypeRequiredDescription
email_idstringYesEmail ID to retrieve

A missing or non-string email_id returns JSON-RPC error -32602.

{
"tool": "mail_get_email",
"arguments": { "email_id": "em1" }
}

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. Denied requests redact the arguments and return only the reason code, so no message content leaves the browser. Read consent is rechecked when the helper responds, so revoking it mid-flight cancels the read. Full ordering: API Reference.