Connect Google Workspace
Index Google Drive documents, and optionally Gmail, using your own Google OAuth client.
The Google Workspace connector reads Drive (My Drive, shared with me, and shared drives) and can retain Google Docs and Slides content. Gmail is a separate, off-by-default opt-in. The connector performs no write operation in your Google account.
Today the connection uses an OAuth client you own: a workspace admin supplies a Google Cloud OAuth client ID and secret during setup, so consent runs against your own client. A verified Orcha-owned Google app is in progress and will remove this step.
Add the connector
- In Google Cloud, create a Web application OAuth client (the Connectors page shows the exact redirect URI to register) and enable the Drive, Docs, and Slides APIs. Enable the Gmail API only if you will include Gmail.
- Open Connectors, choose Google Workspace, and enter the client ID and secret. They are stored encrypted.
- Approve Google's consent screen. Orcha catalogs Drive: folder hierarchy, file names, types, and revisions, without storing bodies.
Choose what gets indexed
Drive starts in Index names only mode; set rules per folder to retain Docs and Slides content. Google Sheets and other file types are cataloged with a disclosed skip reason and never retained. Delta syncs use Drive's change feed, so unchanged files are never re-downloaded.
Gmail is excluded until you opt in during connection setup. When enabled, retention is per label only, over a bounded recent window; whole-mailbox indexing is rejected by design.
Use it
Indexed documents come back from search cited to the exact file and revision, with a link into Drive or Gmail. This works from the Orcha app, the REST API, and AI assistants connected over MCP.
Remove it
- Pause stops syncing while keeping indexed content searchable.
- Revoke invalidates Orcha's Google credential and deactivates the sources; indexed content is kept until you disconnect or reconnect.
- Disconnect purges indexed documents, search chunks, cached content, and sync state from your workspace.
- From Google: remove access under myaccount.google.com/connections. Then disconnect in Orcha to purge indexed content as well.