Search, read, and triage Gmail — send mail, draft and reply, manage labels, trash messages, and pull attachment text. Every action runs through the Nango proxy.
| Category | 💬 Communication |
| Connection | ⚡ OAuth 2.0 one-click, handled by Nango |
| Actions | 12 total — 7 read, 5 write |
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 |
|---|---|---|---|
Search Messagessearch-messages | Read | Search Gmail messages by query string. | Yes |
List Messageslist-messages | Read | List recent messages in the inbox. | Yes |
Get Messageget-message | Read | Fetch a single message with headers and body. | Yes |
Get Attachment Textget-attachment-text | Read | Download a Gmail attachment and convert it to text/markdown. | Yes |
List Threadslist-threads | Read | List conversation threads. | Yes |
List Labelslist-labels | Read | List all labels in the mailbox. | Yes |
Send Messagesend-message | Write | Send an email. | Yes |
Create Draftcreate-draft | Write | Create a draft message without sending. | Yes |
Replyreply-message | Write | Reply to a thread. | Yes |
Modify Labelsmodify-labels | Write | Add or remove labels on a message (archive, star, mark read). | Yes |
Trash Messagetrash-message | Write | Move a message to trash. | Yes |
Get Attachmentget-attachment | Read | Fetch the bytes of a single Gmail attachment. | Yes |
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.
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.