Google Drive
The Google Drive integration lets Helios agents search the Google Drive API and call any endpoint to upload, organize, and manage files and folders.
What your agents can do
Agents don't pick from a preset list of actions. They semantically search the entire Google Drive API and call whatever endpoint a task needs, using your connected credentials. There is no fixed set of file operations to choose from.
- Search and list files and folders across your Drive
- Read file content and metadata
- Create and upload new files and folders
- Organize, copy, and update files the agent created or you opened with Helios
- Read Google Meet recordings and photos (read-only)
- Manage the hidden app-data folder
Authentication
| Method | Type | Description |
|---|---|---|
| Helios Google app (recommended) | OAuth 2.0 | Per-user consent with pre-configured Drive scopes |
| BYO Google app | OAuth 2.0 | Bring your own Google OAuth app and credentials |
Helios Google app (recommended)
Connect in one click. Helios runs the Google OAuth redirect flow and asks each user for consent (access_type=offline, prompt=consent) so agents can act on your behalf, including when you're offline.
The Helios Google app requests scopes to:
- Read files and file metadata (
drive.readonly,drive.metadata,drive.metadata.readonly) - Create and manage files it opens with Helios (
drive.file) - Read Google Meet recordings and photos, read-only (
drive.meet.readonly,drive.photos.readonly) - Manage the hidden app-data folder and read installed-app metadata (
drive.appdata,drive.apps.readonly)
BYO Google app
Bring your own Google OAuth application when you need custom scopes or branding.
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the Google Drive API
- Configure the OAuth consent screen
- Create OAuth 2.0 credentials (client ID and client secret)
- Add the Helios redirect URI to your OAuth client
- In Helios, supply your client ID, client secret, an access token, a refresh token, and the Google account email
Learn more in the Google Drive API documentation.
Triggers
Google Drive does not currently emit event triggers into Helios. Use it from Chat, or from a Workflow driven by a schedule, webhook, or manual run.
Notes
Helios requests read access to your Drive plus write access to files it creates or you explicitly open with it (drive.file). It deliberately does not request the full drive or drive.scripts scopes, so agents cannot modify arbitrary existing files they did not create.
Last updated on
Google Docs
The Google Docs integration lets Helios agents search the Google Docs API and call any endpoint to create documents, edit content, and manage formatting.
Google Sheets
The Google Sheets integration lets Helios agents search the Google Sheets API and call any endpoint to create spreadsheets, read and write data, and manage formatting.