Google Gmail
Google Gmail integration for reading, searching, and sending emails
The Google Gmail integration lets your agents search emails, read message content, and send emails.
Prerequisites
This integration uses Google OAuth. No manual token creation is needed — users authorize access through the OAuth flow.
The OAuth credentials are shared across Google Drive, Google Calendar, and Google Gmail. Authorizing one gives your agent access to all three (within the requested scopes).
Setup
- Open Integrations from the sidebar
- Select Google Gmail from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "Gmail - Support Inbox")
- Click Connect to start the Google OAuth flow
- You'll be redirected to Google to authorize access to Gmail
- Save the config
Using in Your Agent
- Open your agent in Agent Studio. Under Model & capabilities → Tools, click Add tool and add the Google Gmail tools you need
- On a tool's card, choose your config under Set default credentials. It applies to every Google Gmail tool in the agent; click Override on one tool's card to give it a different config
- Tools are referenced as
google_gmail.google_gmail_search,google_gmail.google_gmail_send, etc.
Available Tools
| Tool | Description |
|---|---|
google_gmail_search | Search for emails using Gmail search syntax |
google_gmail_read | Read the content of a specific email |
google_gmail_send | Send an email |