Gmail Tools
Gmail is Google's email service, featuring spam protection, search functions, and seamless integration with other G Suite apps for productivity
Category
Pricing and payment
- Pricing
- Free in Loadout. Provider charges may apply when using a personally connected account.
- Unified payment
- Not currently supported. Connect a provider account when required.
Use Gmail Tools with AI agents
Aident Loadout lets Claude Code, Codex, Cursor, and other supported agents call Gmail Tools. Choose from 61 supported Actions. Review each execution in Audit. Connect Gmail Tools once through Aident Vault. Your agent can use the supported Actions without receiving the underlying credential.
Included Actions
- Gmail Add Label To EmailAdds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs).
- Gmail Batch Delete MessagesTool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene). Use GMAIL_MOVE_TO_TRASH instead when reversibility may be needed…
- Gmail Batch Modify MessagesModify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels. High-volume calls may return 429 rateLimitExceeded or 403 userRateLimitExceeded; a…
- Gmail Create Email DraftCreates a Gmail email draft. While all fields are optional per the Gmail API, practical validation requires at least one of recipient_email, cc, or bcc and at least one of subject or body. Supports To/Cc/Bcc recipients, subject, plain/HTML body (ensure `is_html=True` for HTML),…
- Gmail Create FilterTool to create a new Gmail filter with specified criteria and actions. Use when the user wants to automatically organize incoming messages based on sender, subject, size, or other criteria. Note: you can only create a maximum of 1,000 filters per account.
- Gmail Create LabelCreates a new label with a unique name in the specified user's Gmail account. Returns a labelId (e.g., 'Label_123') required for downstream tools like GMAIL_ADD_LABEL_TO_EMAIL, GMAIL_BATCH_MODIFY_MESSAGES, and GMAIL_MODIFY_THREAD_LABELS — those tools do not accept display names.
- Gmail Create Prompt PostSend a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No thread management or message persistence. Ideal for simple, single-turn interactions. Use when you need to send a single prompt and receive a response without maintaining conversation cont…
- Gmail Delete DraftPermanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling. Ensure the draft exists and the user has necessary permissions for the given `user_id`.
- Gmail Delete FilterTool to permanently delete a Gmail filter by its ID. Use when you need to remove an existing email filtering rule.
- Gmail Delete LabelPermanently DELETES a user-created Gmail label from the account (not from a message). WARNING: This action DELETES the label definition itself, removing it from all messages. System labels (INBOX, SENT, UNREAD, etc.) cannot be deleted. To add/remove labels from specific messages…
- Gmail Delete MessagePermanently deletes a specific email message by its ID from a Gmail mailbox; for `user_id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access.
- Gmail Delete ThreadTool to immediately and permanently delete a specified thread and all its messages. This operation cannot be undone. Use threads.trash instead for reversible deletion.
- Gmail Fetch EmailsFetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval. Results are NOT sorted by recency; sort by internalDate client-side. The messages field may be absent or empty (valid no-results state); always null-chec…
- Gmail Fetch Message By Message IdFetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`. Spam/trash messages are excluded unless upstream list/search calls used `include_spam_trash=true`. Use `internalDate` (milliseconds since epoch) rather…
- Gmail Fetch Message By Thread IdRetrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`. Returns a `messages` array; `thread_id` is not echoed in the response. Message order is not guaranteed — sort by `internalDate` to find oldest/newest. Ch…
- Gmail Forward MessageForward an existing Gmail message to specified recipients, preserving original body and attachments. Verify recipients and content before forwarding to avoid unintended exposure. Bulk forwarding may trigger 429/5xx rate limits; keep concurrency to 5–10 and apply backoff. Message…
- Gmail Get AttachmentRetrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs. Returns the downloaded file with its MIME type and filename. Attachments exceeding ~25 MB may be exposed as Google Drive links — use GOOGLEDRIVE_DOWNLOAD_F…
- Gmail Get Auto ForwardingTool to get the auto-forwarding setting for the specified account. Use when you need to retrieve the current auto-forwarding configuration including enabled status, forwarding email address, and message disposition.
- Gmail Get ContactsFetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination. Only covers saved contacts and 'Other Contacts'; email-header-only senders are out of scope. Contact records may have sparse data — handle missing fiel…
- Gmail Get DraftRetrieves a single Gmail draft by its ID. Use this to fetch and inspect draft content before sending via GMAIL_SEND_DRAFT. The format parameter controls the level of detail returned.
- Gmail Get FilterTool to retrieve a specific Gmail filter by its ID. Use when you need to inspect the criteria and actions of an existing filter.
- Gmail Get LabelGets details for a specified Gmail label. Use this to retrieve label information including name, type, visibility settings, message/thread counts, and color.
- Gmail Get Language SettingsTool to retrieve the language settings for a Gmail user. Use when you need to determine the display language preference for the authenticated user or a specific Gmail account.
- Gmail Get PeopleRetrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return. Scope is limited to the authenticated user's own contacts and 'Other Contacts' history only.
- Gmail Get ProfileRetrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user. messagesTotal counts individual emails; threadsTotal counts conversations; neither is per-label — use GMAIL_FETCH_EMAILS with label filters for label-specific counts.…
- Gmail Get Vacation SettingsTool to retrieve vacation responder settings for a Gmail user. Use when you need to check if out-of-office auto-replies are configured and view their content.
- Gmail Import MessageTool to import a message into the user's mailbox with standard email delivery scanning and classification. Use when you need to add an existing email to a Gmail account without sending it through SMTP. This method doesn't perform SPF checks, so it might not work for some spam me…
- Gmail Insert MessageTool to insert a message into the user's mailbox similar to IMAP APPEND. Use when you need to add an email directly to a mailbox bypassing most scanning and classification. This does not send a message.
- Gmail List Cse IdentitiesTool to list client-side encrypted identities for an authenticated user. Use when you need to retrieve CSE identity configurations including key pair associations.
- +32 Actions
Skills that use Gmail Tools
Related use cases
Research a market and email a sourced brief
Collect current primary evidence, synthesize a concise market brief, and send only the reviewed version.
Verify prospects before outreach
Check public company and role evidence before drafting a relevant email, while keeping sending behind approval.
Turn community demand into content briefs
Find recurring public questions, preserve their source context, and route a focused brief to the content owner.
