Skip to main content
Replicas connects to Google so workspaces can create and edit Google Docs, Sheets, and Forms, manage the files they create, and read Search Console data.
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 Organization → Integrations, click Connect on the Google row. Every workspace in the org uses this account by default.
  • Personal. From Personal → Integrations, click Connect on the Google row. 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 replicas@yourcompany.com 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.
  • Search Console. List accessible properties, query search performance, read sitemap status, and inspect URLs in Google’s index.
In-workspace agents call these capabilities through the replicas-agent skill, so they do not need to know any Google API details.

​
Drive 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 replicas@yourcompany.com 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. Search Console access is read-only and limited to properties available to the connected Google account. Accounts connected before Search Console support was enabled must reconnect once to grant the new permission.

​
Disconnect

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