Integrations

Google Workspace integration

Connect Google Workspace to give Agents access to Gmail, Google Docs, and Google Sheets. Google Workspace is available as a set of Agent tools, not as Flow steps.

Connecting Google Workspace

Google Workspace is connected with a hosted OAuth flow. You approve access on Google’s consent screen, and Runtype stores and refreshes the credentials server-side. Tokens never pass through your browser, and you never need to re-paste an expired token.

  1. In Runtype, go to Settings → Integrations.
  2. Find Google Workspace and click Connect.
  3. Choose the features to enable (Gmail, Calendar, Docs, Sheets, Drive). Runtype requests only the scopes for the features you pick.
  4. Enter your Google Cloud OAuth client ID and client secret (see below), then click Connect Google.
  5. Approve the consent screen in the popup. The integration shows your connected Google account when it completes.

Creating the OAuth client

You currently connect with your own Google Cloud OAuth client:

  1. In the Google Cloud Console, create or select a project and enable the APIs for the features you want (Gmail API, Google Calendar API, Google Docs API, Google Sheets API).
  2. Configure the OAuth consent screen. On a Google Workspace domain, choose Internal to skip Google’s app verification. Otherwise choose External and add yourself under Test users.
  3. Create an OAuth 2.0 client of type Web application and add the redirect URI https://api.runtype.com/v1/oauth/google/callback.

External apps in Testing mode receive refresh tokens that expire after 7 days. Publish the app, or use an Internal app on a Google Workspace domain, for durable connections.

Automatic refresh and reconnection

Runtype refreshes the access token automatically before each use, so the connection stays live indefinitely. If Google revokes the grant (for example, you removed Runtype’s access in your Google account settings), the integration shows a Needs reconnection badge in Settings → Integrations. Click Reconnect and approve again to restore it.

Available tools

Once connected, the following tools are available to Agents:

Gmail

  • gmail_send — Send an email
  • gmail_search — Search for emails (supports Gmail search operators)
  • gmail_read — Read a specific email by ID
  • gmail_create_draft — Create an email draft

Google Docs

  • docs_create — Create a new Google Doc
  • docs_read — Read content from a Google Doc
  • docs_append — Append content to a Google Doc

Google Sheets

  • sheets_read — Read data from a Google Sheet (A1 notation ranges)
  • sheets_write — Write data to a Google Sheet
  • sheets_create — Create a new Google Sheet

Enable these tools when configuring an Agent.

Permissions and scopes

Runtype requests only the scopes for the features you enable when connecting:

  • Gmail: send, search, and read emails on your behalf
  • Calendar: read and manage calendar events
  • Docs: create, read, and append to documents
  • Sheets: read, write, and create spreadsheets
  • Drive: access files the integration creates

You can revoke access anytime in your Google Account settings. Google Workspace integration uses OAuth, so Runtype never stores your Google password.

Disconnecting Google

  1. Go to Settings → Integrations → Google Workspace and disconnect the integration.
  2. To fully revoke the grant, also remove Runtype in Google Account → Security → Third-party apps.

Next steps