Gmail Integration
The Gmail integration lets AI agents read and send emails, search your inbox, and apply labels — fully scoped to the permissions you grant.
Connecting Gmail #
Go to Dashboard → Tools → Gmail and click Connect. Complete Google's OAuth flow. You can choose read-only or read+send permissions at consent time.
If you only need to read emails, choose the read-only scope. The
gmail_send tool only works with the read+write scope.Available Tools #
| Tool name | Description | Auth scope |
|---|---|---|
gmail_list_messages | List messages matching a query | read |
gmail_get_message | Read a full email (headers + body) | read |
gmail_search | Search the inbox using Gmail query syntax | read |
gmail_send | Send an email on behalf of the user | write |
gmail_add_label | Apply a label to a message | write |
Example — Search Inbox #
typescript
const result = await agentbridge.execute({
tool: 'gmail_search',
input: {
query: 'from:billing@stripe.com subject:invoice',
maxResults: 5,
},
});
Was this page helpful?