CipherSense Logo
DocsIntegrationsGoogle Workspace
google-workspace
Data Source

Google Workspace

Connect Gmail, Drive, Docs, Sheets, and Calendar using your own Google Cloud OAuth app

CipherSense Agents integrates with the full Google Workspace suite — Gmail, Drive, Docs, Sheets, and Calendar — through OAuth. You can connect instantly using the built-in shared OAuth app (supports up to 100 users), or bring your own Google Cloud OAuth credentials for unlimited users and full control over your data access. Your credentials are encrypted at rest and never shared.

Official documentation

Setup

1

Option A — Quick connect (shared OAuth app)

In CipherSense Agents: Project > Integrations > Add Integration > select any Google product. Select the products you want to integrate, then click Connect with Google. You will see an 'unverified app' warning from Google — click Advanced > Go to app to proceed. This is expected and safe.

2

Option B — Bring your own Google Cloud OAuth app (recommended for teams)

Create your own OAuth app. In the Add Integration modal, expand 'Use my own Google Cloud OAuth app', paste your Client ID and Client Secret, then click Connect with Google.

3

Create a Google Cloud project and OAuth credentials

Go to console.cloud.google.com > APIs & Services > Credentials > Create Credentials > OAuth 2.0 Client ID. Choose Web Application. Under Authorised redirect URIs, add your CipherSense redirect URI (shown in the integration modal). Copy the Client ID and Client Secret.

4

Enable the Google APIs you need

In Google Cloud Console > APIs & Services > Library, enable: Gmail API, Google Drive API, Google Docs API, Google Sheets API, Google Calendar API. Only enable the ones you plan to use.

5

Google Sheets — find your Spreadsheet ID

The Spreadsheet ID appears in your sheet URL: docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit. Use this ID in the Google Sheets node to read rows, append data, or update cells.

6

Google Drive — list or fetch files

Add a Google Drive node and choose an operation: list files in a folder, get file content by ID, or search by query. Map the retrieved content to downstream Agent nodes.

7

Google Docs — read document content

Add a Google Docs node and provide the Document ID (found in the URL: docs.google.com/document/d/DOCUMENT_ID/edit). The node returns the full text content for use as agent context.

8

Google Calendar — fetch events

Add a Google Calendar node to list upcoming events or retrieve events from a specific calendar by Calendar ID. Useful for scheduling agents and availability workflows.

9

Google Gmail — read emails

Add a Google Gmail node to list inbox messages, fetch email content by ID, or search with Gmail query syntax (e.g. from:user@example.com is:unread). Useful for email-triggered processing workflows.

Connection Fields

Fields required when adding this integration in your Project › Integrations.

FieldRequiredDescription
OAuth Connection
Required
Authorise CipherSense Agents via Google OAuth. One connection covers all selected Google Workspace products.
OAuth Client ID (optional)
Optional
Your own Google Cloud OAuth 2.0 Client ID. Provide this to use your own Google Cloud app instead of the shared one. Removes the 100-user limit.
OAuth Client Secret (optional)
Optional
Your own Google Cloud OAuth 2.0 Client Secret. Required when providing a Client ID. Stored encrypted.

Common Use Cases

Log AI outputs to Google Sheets tracking dashboardsAnalyse documents from Google Drive and DocsRead Gmail for email triage and response automationFetch Calendar events for scheduling agentsProcess uploaded files and reports end-to-end

Ready to connect Google Workspace?

Add this integration from your project dashboard and wire it into a workflow.

Open Dashboard ← Back to Integrations