composio-gmail

# Composio · Gmail Toolkit slug: **`gmail`**. Read the [[composio]] hub first for the call model (`agent-swarm x composio …`, user_id, connected accounts, the 4302 gotcha). Tool `arguments` go inside the request body; `user_id` defaults to `"me"` (the authorized account) — you usually don't need to set it. ```bash # Direct execute (reliable path — pin the ACTIVE ca_… from the hub Recipe B) agent-swarm x composio POST /tools/execute/<SLUG> \ --body '{"user_id":"t@desplega.ai","connected_account_id":"ca_…","arguments":{ … }}' ``` ## Headline tools | Slug | What | Key args | |---|---|---| | `GMAIL_FETCH_EMAILS` | List/search emails | `query`, `max_results` (def **1** — set it!), `include_payload` (def true), `verbose` (def true), `ids_only`, `label_ids`, `page_token` | | `GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID` | Full single message | `message_id`, `include_payload` | | `GMAIL_FETCH_MESSAGE_BY_THREAD_ID` | All messages in a thread | `thread_id` | | `GMAIL_LIST_THREADS` | List threads | `query`, `max_results`, `page_token` | | `GMAIL_SEND_EMAIL` | Send | `recipient_email`, `subject`, `body`, `is_html` (def false), `cc`, `bcc`, `extra_recipients`, `attachment` | | `GMAIL_REPLY_TO_THREAD` | Reply in-thread | `thread_id`, `message_body`, `recipient_email` | | `GMAIL_CREATE_EMAIL_DRAFT` / `GMAIL_SEND_DRAFT` | Draft then send | `body`, `subject`, `recipient_email` / `draft_id` | | `GMAIL_GET_PROFILE` | Whose mailbox is this? | — | | `GMAIL_LIST_LABELS` / `GMAIL_CREATE_LABEL` / `GMAIL...