Google Workspace

Let Replicas create and edit Google Docs, Sheets, and Forms on your org’s behalf.

Replicas connects to Google so workspaces can create and edit Google Docs, Sheets, and Forms, plus share, rename, and move the files it creates.

The Google Workspace integration is rolling out behind the gdrive_integration feature flag. If you don’t see Google in your Settings page, contact your Replicas account team to have the flag enabled for your organization.

Setup

Two connection scopes are supported:

• Organization-level (admin-only). From Settings → Integrations, expand the Google row and click Connect. Every workspace in the org uses this account by default.
• Personal. From Account → Integrations, expand the Google row and click Connect. Personal credentials take precedence over the org credential when both are connected (same precedence as GitHub and GitLab).

We recommend creating a dedicated Workspace user like [e-mail] and connecting that account at the org level, so files Replicas creates are owned by a clearly identifiable identity instead of a real person’s account.

What Replicas can do

Through the integration, agents can:

• Docs. Create, read, and edit Google Docs (insert/replace text, formatting, headings, lists, tables, images, page breaks).
• Sheets. Create spreadsheets, read and write cell ranges, run formulas, format cells, add charts, manage tabs.
• Forms. Create forms with any question type, add branching and quiz logic, read submitted responses.
• Drive. Share, rename, move, and delete the files it has created.

In-workspace agents call these capabilities through the replicas-agent skill, so they do not need to know any Google API details.

Important limitation

Replicas uses Google’s drive.file OAuth scope, which only grants access to files Replicas itself created.

This means:

• Replicas cannot read or edit a Google Doc, Sheet, or Form that was created outside the integration, even if it has been shared with the connected Google account.
• Sharing an existing file with the connected [e-mail] account does not let Replicas access it.

If you need agents to operate on pre-existing Google content, ask them to create a new file mirroring it.

Disconnect

From Settings → Integrations (org-level) or Account → Integrations (personal), click Disconnect. The refresh token is revoked at Google and the credential is removed from Replicas.