IntegrationsBuilt-in Providers

Gmail

Connect Gmail to your Appstrate agents.

Overview

Gmail is Google's email service, allowing your agents to read, send, and manage emails.

Authentication Mode

PropertyValue
Typeoauth2
HeaderAuthorization: Bearer <token>
Default scopesgmail.readonly, gmail.send

Available Scopes

ScopeDescription
gmail.readonlyRead-only access
gmail.sendSend messages
gmail.composeCompose and send drafts
gmail.modifyRead and write (no delete)
gmail.labelsManage labels
gmail.metadataRead metadata only
gmail.insertInsert messages
gmail.settings.basicManage basic settings
mail.google.com/Full mailbox access

Authorized URIs

The agent can access the following endpoints through the sidecar proxy:

  • https://gmail.googleapis.com/*
  • https://www.googleapis.com/gmail/*

Connect Gmail

  1. Create a Google Cloud project and enable the Gmail API
  2. Configure the OAuth consent screen
  3. Create OAuth 2.0 credentials (Client ID and Client Secret)
  4. Add the Appstrate redirect URI as an authorized redirect URI
  5. Enter the Client ID and Client Secret in the Gmail provider settings on Appstrate

Usage in an Agent

Once connected, the agent can call Gmail APIs through the sidecar proxy. Example prompt:

Every morning at 8am, read my unread emails received since last night.
For each email, write a 2-line summary.
Send me a recap email with the list of summaries.

On this page