Gmail

Gmail connector — OAuth flow — uses your Google credential (create one under Credentials).

Auth: OAuth 2.0 (credential type google-oauth)

Slug: gmail

Setup: OAuth flow — uses your Google credential (create one under Credentials).

Access requested

OAuth scopes:

https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/userinfo.email
openid

Destructive operations (delete, overwrite) can be disabled per-agent: in the agent's Connectors tab, the "enabled operations" allowlist controls exactly which of the tools below an agent may call. Operations marked Destructive below are the ones to review first.

Tools (25)

Read (9)

Tool	Operation	Description
`gmail_list_messages`	List messages	Search and list emails by query.
`gmail_get_message`	Get message	Retrieve a single email by ID.
`gmail_list_threads`	List threads	List email conversation threads.
`gmail_get_thread`	Get thread	Retrieve all messages in a thread.
`gmail_list_labels`	List labels	List all Gmail labels.
`gmail_get_label`	Get label	Retrieve a single label by ID.
`gmail_list_drafts`	List drafts	List email drafts.
`gmail_get_attachment`	Get attachment	Download an email attachment by ID.
`gmail_list_history`	List history	List mailbox history changes since a given historyId.

Write (11)

Tool	Operation	Description
`gmail_reply_message`	Reply to message	Send a reply in an existing thread.
`gmail_forward_message`	Forward message	Forward an email to new recipients.
`gmail_modify_labels`	Modify labels	Add or remove labels on a message.
`gmail_trash_message`	Trash message	Move a message to Trash (reversible).
`gmail_untrash_message`	Untrash message	Restore a message from Trash.
`gmail_modify_thread_labels`	Modify thread labels	Add or remove labels on all messages in a thread.
`gmail_trash_thread`	Trash thread	Move an entire thread to Trash (reversible).
`gmail_create_label`	Create label	Create a new Gmail label.
`gmail_update_label`	Update label	Rename or update a Gmail label.
`gmail_create_draft`	Create draft	Compose an email draft without sending.
`gmail_update_draft`	Update draft	Update an existing email draft.

Destructive (5)

Tool	Operation	Description
`gmail_send_email`	Send email	Send an email from the connected mailbox (irreversible).
`gmail_send_draft`	Send draft	Send a saved draft (irreversible).
`gmail_delete_message`	Delete message	Permanently delete a message (bypasses Trash).
`gmail_delete_label`	Delete label	Permanently delete a Gmail label.
`gmail_delete_draft`	Delete draft	Permanently delete an email draft.