Connect Google Workspace
Index Google Drive documents, and Gmail if you select it, with your own Google OAuth client.
The Google Workspace connector reads Drive. This includes My Drive, shared with me, and shared drives. The connector can keep the content of Google Docs and Slides. Gmail is a separate option, and it is off by default. The connector does no write operations in your Google account.
At this time, the connection uses an OAuth client that you own. During configuration, a workspace admin supplies a Google Cloud OAuth client ID and secret. Thus the consent step uses your own client. Orcha is in the process of getting a verified Orcha-owned Google app. When this app is available, this step will not be necessary.
Add the connector
- In Google Cloud, create a Web application OAuth client. The Connectors page shows the exact redirect URI to register.
- Enable the Drive, Docs, and Slides APIs.
- If you will include Gmail, enable the Gmail API. If not, do not enable it.
- Open Connectors and choose Google Workspace.
- Enter the client ID and secret. Orcha stores them in encrypted form.
- Approve the Google consent screen. Orcha makes a catalog of Drive. The catalog has the folder hierarchy, file names, types, and revisions. Orcha does not store file bodies.
Choose what gets indexed
Drive starts in Index names only mode. To keep Docs and Slides content, set rules for each folder. Orcha puts Google Sheets and other file types in the catalog with a skip reason. Orcha does not keep their content. Delta syncs use the Drive change feed. Thus Orcha does not download unchanged files again.
Orcha does not include Gmail until you select it during connection configuration. If you enable Gmail, you set retention for each label only. Retention applies to a limited window of recent mail. By design, Orcha does not accept indexing of the full mailbox.
Use it
Search returns indexed documents with a citation to the exact file and revision. Each result has a link into Drive or Gmail. You can search from the Orcha app, the REST API, and AI assistants that connect over MCP.
Remove it
- Pause stops the sync. Indexed content stays searchable.
- Revoke makes the Orcha Google credential invalid and deactivates the sources. Orcha keeps the indexed content until you disconnect or reconnect.
- Disconnect deletes 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 also delete the indexed content.