Skip to main content
Connect Google Drive with a service account so workflows and Ravenna Agents can find files and manage who can open them. This connection is separate from the per-user sign-in that imports files into knowledge.

Connect a service account

1

Create a service account

In Google Cloud Console, create a service account in a project with the Google Drive API enabled. Download its JSON key file.
2

Connect in Ravenna

Go to Settings > Integrations, open Google Drive and choose Connect with Service Account. Enter the service account credentials from the JSON key file. Ravenna checks the credentials with Google before saving.
3

Share files with the service account

Share the folders and files Ravenna should work with to the service account’s email address. Ravenna only sees what is shared with it. To share or unshare a file, the service account needs Editor access to it.
One Google Drive service account connects per organization. Every workspace in the organization uses it.

Workflow actions

Add these actions from the Google Drive app in the workflow builder. Users accepts people and user groups. Ravenna expands groups to their members and uses each person’s email address.

Agent tools

Reference these tools in agent rules with @ mentions.

When someone asks for access to a team document, find it with @Search Google Drive Files using the document name, confirm the right file with the requester, then run @Share Google Drive File with their email and role reader.

How it works

File URLs

Share and unshare take the file’s link, such as https://docs.google.com/document/d/FILE_ID/edit or https://drive.google.com/file/d/FILE_ID/view. Ravenna reads the file ID from the /d/ part. A link without it fails with an invalid file URL error.
Search covers every file shared with the service account, including shared drives it belongs to. Trashed files are left out. When an agent search reaches its limit, the result says so and the agent can add filters to narrow it.
Unshare removes access granted directly on the file. People with no direct access are skipped. Access inherited from a shared folder and the file owner’s access stay in place.
Google emails each person a file is shared with unless you turn Send Notification Email off in the workflow action, or the agent sets send_notification to false.
Learn more about workflows and configuring agents
Last modified on November 20, 2026