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 your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Google Gmail from the integration list
- 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 agent revision
Using in Your Agent
- In an Agent Step, attach Google Gmail tools from the tools panel
- The agent uses your integration config for all Gmail API calls
- 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 |