Gmail

Gmail lets your agents send, read, and manage emails through your Google account, supporting full message and thread operations, drafts, labels, and contact lookup.

Setup

In Agent Studio, go to Tools → Gmail → Connect
Sign in with your Google account and authorize access
Review the requested permissions and click Allow

Composio vs ACI: Which provider to use?

This tool is available through two providers. Both connect to the same underlying service but differ in action coverage and auth handling.

	Composio	ACI
Provider source	Composio	ACI
Auth type	oauth2	oauth2
Best for	Broad action coverage, workflow automation	Targeted integrations, API-level operations

Choose Composio when you need the widest selection of actions and deep workflow automation. Choose ACI when you need direct API-level control or a specific action not covered by Composio.

Available actions: Composio

Action	Description
`GMAIL_ADD_LABEL_TO_EMAIL`	Adds or removes specified labels from a Gmail message.
`GMAIL_CREATE_EMAIL_DRAFT`	Creates a Gmail draft with support for to/cc/bcc, subject, plain or HTML body, attachments, and thread replies.
`GMAIL_CREATE_LABEL`	Creates a new label with a unique name in the user’s Gmail account.
`GMAIL_DELETE_DRAFT`	Permanently deletes a specific Gmail draft by its ID.
`GMAIL_DELETE_MESSAGE`	Permanently deletes a specific email message from a Gmail mailbox.
`GMAIL_FETCH_EMAILS`	Fetches a list of email messages from a Gmail account with support for filtering, pagination, and full content retrieval.
`GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID`	Fetches a specific email message by its ID.
`GMAIL_FETCH_MESSAGE_BY_THREAD_ID`	Retrieves all messages in a Gmail thread using the thread ID.
`GMAIL_GET_ATTACHMENT`	Retrieves a specific attachment by ID from a Gmail message.
`GMAIL_GET_CONTACTS`	Fetches contacts from the authenticated Google account, with support for field selection and pagination.
`GMAIL_GET_PEOPLE`	Retrieves details for a specific person or lists other contacts from the Google People API.
`GMAIL_GET_PROFILE`	Retrieves key Gmail profile information including email address and message/thread totals.
`GMAIL_LIST_DRAFTS`	Retrieves a paginated list of email drafts from the user’s Gmail account.
`GMAIL_LIST_LABELS`	Retrieves a list of all system and user-created labels in the Gmail account.
`GMAIL_LIST_THREADS`	Retrieves a list of email threads from a Gmail account with filtering and pagination support.
`GMAIL_MODIFY_THREAD_LABELS`	Adds or removes labels from all messages in a Gmail thread.
`GMAIL_MOVE_TO_TRASH`	Moves an email message to the trash.
`GMAIL_PATCH_LABEL`	Updates the display name, color, or visibility settings of an existing Gmail label.
`GMAIL_REMOVE_LABEL`	Permanently deletes a user-created Gmail label by its ID.
`GMAIL_REPLY_TO_THREAD`	Sends a reply within a specific Gmail thread, with support for attachments.
`GMAIL_SEARCH_PEOPLE`	Searches contacts by matching a query against names, emails, phone numbers, and organizations.
`GMAIL_SEND_DRAFT`	Sends an existing draft to the recipients defined in its headers.
`GMAIL_SEND_EMAIL`	Sends an email via the Gmail API, supporting HTML body, attachments, and multiple recipients.

Available actions: ACI

Action	Description
`GMAIL__SEND_EMAIL`	Sends an email on behalf of the authenticated user.
`GMAIL__MESSAGES_LIST`	Lists messages in the user’s mailbox, with optional filtering by query and label.
`GMAIL__MESSAGES_GET`	Retrieves the full content of a specific message by its ID.
`GMAIL__MESSAGES_TRASH`	Moves a specific message to the trash.
`GMAIL__MESSAGES_UNTRASH`	Removes a specific message from the trash.
`GMAIL__MESSAGES_MODIFY`	Adds or removes labels on a specific message.
`GMAIL__LABELS_LIST`	Lists all labels in the user’s mailbox.
`GMAIL__LABELS_GET`	Retrieves a specific label by its ID.
`GMAIL__LABELS_CREATE`	Creates a new label in the user’s Gmail account.
`GMAIL__LABELS_UPDATE`	Updates the name, color, or visibility of an existing label.
`GMAIL__LABELS_DELETE`	Deletes the specified label.
`GMAIL__DRAFTS_LIST`	Lists all drafts in the user’s mailbox.
`GMAIL__DRAFTS_CREATE`	Creates an email draft on behalf of the user.
`GMAIL__DRAFTS_GET`	Retrieves a specific draft by its ID.
`GMAIL__DRAFTS_UPDATE`	Updates the content of an existing draft.
`GMAIL__DRAFTS_DELETE`	Permanently deletes a specific draft.
`GMAIL__DRAFTS_SEND`	Sends an existing draft by its ID.
`GMAIL__THREADS_LIST`	Lists email threads in the user’s mailbox with optional filtering.
`GMAIL__THREADS_GET`	Retrieves all messages in a specific thread.
`GMAIL__THREADS_MODIFY`	Adds or removes labels applied to an entire thread.
`GMAIL__THREADS_TRASH`	Moves a specific thread to the trash.
`GMAIL__THREADS_UNTRASH`	Removes a specific thread from the trash.
`GMAIL__THREADS_DELETE`	Immediately and permanently deletes a specific thread.

Adding to an agent

Open your agent in Agent Studio → Agent Builder
Go to Tools and enable Gmail
Select only the actions your agent needs
Set auth mode: Shared (agent acts on one account) or Per-user (each end-user connects their own account)

Example use cases

Automated customer support responses An agent monitors the inbox for incoming support emails using GMAIL_FETCH_EMAILS, categorizes them by topic, and sends replies using GMAIL_SEND_EMAIL, reducing response time without manual intervention. Email digest and summarization An agent fetches unread threads each morning with GMAIL_LIST_THREADS, reads the full content of each with GMAIL_FETCH_MESSAGE_BY_THREAD_ID, and sends a summarized digest to a team Slack channel or back to the user’s inbox. Automated follow-up drafts An agent detects unanswered emails older than 48 hours using GMAIL_FETCH_EMAILS with a date filter, creates follow-up drafts with GMAIL_CREATE_EMAIL_DRAFT, and applies a custom label via GMAIL_ADD_LABEL_TO_EMAIL to track pending responses.

Models & LLM Providers

Tools

Data

Protocols

Setup

Composio vs ACI: Which provider to use?

Available actions: Composio

Available actions: ACI

Adding to an agent

Example use cases

​Setup

​Composio vs ACI: Which provider to use?

​Available actions: Composio

​Available actions: ACI

​Adding to an agent

​Example use cases

Setup

Composio vs ACI: Which provider to use?

Available actions: Composio

Available actions: ACI

Adding to an agent

Example use cases