Gmail

Apply labels to Gmail messages using label names rather than Gmail label IDs. This is the preferred labeling action for models because it avoids a separate label-id lookup step.

Archive one or more existing Gmail messages by removing Gmail's INBOX label. The messages remain in Gmail and can still be found later.

Add or remove Gmail labels on a batch of messages.

Read multiple Gmail messages in a single call. Each successful result includes the message body plus metadata such as sender/recipient fields, subject, snippet, labels, timestamp, and attachment metadata.

Read Gmail emails with personalization parsing.

Fetch multiple Gmail conversation threads in one call. Pass message ids by default, or pass id_type='thread' when the provided ids are thread ids. Responses are deduplicated by resolved thread_id, preserving the first occurrence, and exact duplicate input ids are coalesced before fetching.

Apply a label to every Gmail message matching a Gmail search query. This action performs the search and label batching server-side, so it is suitable for very large backfills without sending message IDs through the model context.

Create a Gmail draft without sending it. Use this when the user wants to review or manually send the message later in Gmail.

Create a Gmail label. If the label already exists, the existing label is returned instead of creating a duplicate.

Move one or more existing Gmail messages to Trash. This matches Gmail's delete behavior and does not permanently delete the messages.

Forward one or more existing Gmail messages. Each source message is sent as a separate forwarded email, with the original message inlined below any optional note in the forwarded body and the original attachments preserved on the new outbound email. The note is rendered from Markdown and inserted at the top of each forwarded message. When Gmail thread metadata is available, the sent forward is also kept associated with the original conversation in the sender's mailbox.

Return the current Gmail user's profile information.

Return the most recently received Gmail messages.

List Gmail drafts with summarized metadata so they can be reviewed or selected.

List Gmail labels with per-label counts. Use this for questions like how many emails are in the inbox or unread, because Gmail exposes those totals directly on labels without paging through messages.

Read a Gmail attachment by attachment ID or filename.

Read a Gmail attachment using personalization behavior.

Fetch a single Gmail message including its body.

Fetch an entire Gmail conversation thread. Pass a message id by default, or pass id_type='thread' when you already have a thread id. If max_messages is provided, return the N most recent messages in the thread; it defaults to 20.

Retrieve Gmail message IDs that match a search. Prefer list_labels for label counts.

Search Gmail for emails matching a query or label. Place Gmail search query first, followed by search operators (`after:, before:, from:, to:, subject:(words), has:attachment). Example: project update after:2025-01-01 from:alice@example.com`.

Search Gmail for email summaries using personalization behavior.

Send an existing Gmail draft as currently stored. Use this after the user has reviewed the draft or after you update it with update_draft.

Send an email from the authenticated Gmail account.

Update an existing Gmail draft in place. Omitted fields preserve the current draft content; pass an empty string only when the user explicitly wants to clear that field. Drafts with attachments are not editable through this action.