get_gmail_messages_content_batch
Fetch multiple Gmail messages in a single batch call using the Gmail batch API, with auto-chunking of 25 per request. Supports full content or metadata-only retrieval for faster triage.
Instructions
Fetch many Gmail messages in one batch, chunked internally.
Prefer this over calling get_gmail_message_content in a loop — uses the Gmail batch API (25 per request, auto-chunked) and falls back to sequential fetches if the batch call fails. Use format="metadata" when you only need headers for triage (cheaper + faster). Requires the gmail.readonly OAuth scope.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message_ids | Yes | List of Gmail message IDs from search_gmail_messages. No hard cap — the tool chunks into batches of 25 automatically. | |
| user_google_email | Yes | The user's Google email address (authenticated account). | |
| format | No | "full" (headers + body) or "metadata" (headers only, much faster for listing triage). | full |
| body_format | No | Body output format (only applies when format='full'). 'text' (default) returns plaintext (HTML converted to text as fallback). 'html' returns the raw HTML body as-is without conversion. 'raw' fetches the full raw MIME message and returns the base64url-decoded content. | text |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |