💬Communication
Gmail
Search, read, and triage Gmail — send mail, draft and reply, manage labels, trash messages, and pull attachment text.
| Category | 💬 Communication |
| Connection | ⚡ OAuth 2.0 one-click |
| Actions | 36 total — 13 read, 23 write |
🔌ConnectFind it in the catalogue
🔐AuthorizeOne-click OAuth
✨Use actionsChat · agents · workflows
How Gmail fits into Your Office AI
Actions
Once connected, Gmail exposes the following actions. The AI can call them with #-mentions in chat, an agent can be granted a subset as tools, and a workflow can run them in an integration-action node.
| Action | Type | What it does | Proxy |
|---|---|---|---|
Create Draftcreate-draft | Write | Create a draft message without sending. | Yes |
Create Filtercreate-filter | Write | Create a mailbox filter with match criteria and label actions. | Yes |
Create Labelcreate-label | Write | Create a new user label with visibility settings. | Yes |
Delete Draftdelete-draft | Write | Delete an existing draft by draft ID | Yes |
Delete Filterdelete-filter | Write | Delete a mailbox filter by filter ID | Yes |
Delete Labeldelete-label | Write | Delete a user-created label | Yes |
Delete Messagedelete-message | Write | Permanently delete a Gmail message by ID. | Yes |
Delete Threaddelete-thread | Write | Permanently delete a Gmail thread and its messages. | Yes |
Get Attachmentget-attachment | Read | Fetch the bytes of a single Gmail attachment by message + attachment id. Returns base64url-encoded data plus the reported size. Pair with the binary knowledge upload tool to land an xlsx/csv/pdf attachment as a parsed KnowledgeDocument. | Yes |
Get Attachment Textget-attachment-text | Read | Download a Gmail attachment and convert it to text/markdown. | Yes |
Get Filterget-filter | Read | Retrieve a mailbox filter by filter ID. | Yes |
Get Messageget-message | Read | Fetch a single message with headers and body. | Yes |
Get Threadget-thread | Read | Retrieve a Gmail thread and its messages. | Yes |
Get Vacation Settingsget-vacation-settings | Read | Retrieve the mailbox vacation responder settings. | Yes |
List Draftslist-drafts | Read | List drafts in the mailbox with pagination support. | Yes |
List Labelslist-labels | Read | List all labels in the mailbox. | Yes |
List Messageslist-messages | Read | List recent messages in the inbox. | Yes |
List Send As Aliaseslist-send-as-aliases | Read | List send-as aliases available for the mailbox. | Yes |
List Threadslist-threads | Read | List conversation threads. | Yes |
List Watch Historylist-watch-history | Read | List mailbox history records after a given history ID | Yes |
Modify Labelsmodify-labels | Write | Add or remove labels on a message (archive, star, mark read, etc.). | Yes |
Modify Threadmodify-thread | Write | Add and remove labels across a Gmail thread. | Yes |
Replyreply-message | Write | Reply to a thread. | Yes |
Search Messagessearch-messages | Read | Search Gmail messages by query string. | Yes |
Send Draftsend-draft | Write | Send an existing draft message | Yes |
Send Messagesend-message | Write | Send an email. | Yes |
Trash Messagetrash-message | Write | Move a message to trash. | Yes |
Trash Threadtrash-thread | Write | Move a Gmail thread to trash. | Yes |
Untrash Messageuntrash-message | Write | Restore a trashed Gmail message to the mailbox. | Yes |
Untrash Threaduntrash-thread | Write | Restore a trashed Gmail thread to the mailbox. | Yes |
Update Draftupdate-draft | Write | Replace an existing draft with new MIME content. | Yes |
Update Imap Settingsupdate-imap-settings | Write | Update IMAP enablement and visibility settings. | Yes |
Update Labelupdate-label | Write | Update a user-created label's name or visibility settings. | Yes |
Update Language Settingsupdate-language-settings | Write | Update the mailbox display language | Yes |
Update Pop Settingsupdate-pop-settings | Write | Update POP access settings for the mailbox | Yes |
Update Vacation Settingsupdate-vacation-settings | Write | Update the mailbox vacation responder configuration. | Yes |
Write actions are confirmation-gated
Actions tagged Write create, update, or delete data. In chat and agent paths they pause for your confirmation before running; workflows treat their deterministic wiring as implicit consent. Agent tools covers how to scope which actions an agent may use.
Spend & quota
Gmail is governed per organization: an admin sets a monetary spend cap and a monthly call quota. A quota of 0 disables the integration — it never means unlimited. See the Integrations overview for the full governance model.