Skip to main content
The Google Drive connector integrates Tess with Google Drive storage. Once connected, the AI can search files and folders, help organize content, and support document workflows inside chats and agents. Google Drive is part of the Tess Connectors ecosystem and uses OAuth authentication for Apps connectors.

​
Prerequisites

  • A Google account with access to the Drive files/folders you need.
  • Permission to authorize Google Drive OAuth scopes for that account.

​
How to connect

On some Apps connectors, the OAuth consent screen may show a third-party connection bridge name rather than Tess. That is normal—review the requested permissions and continue if they match what you expect.
1

Open the Connectors panel

In chat, click the + next to the message box and select Connectors. You can also manage connectors while editing an agent in Agent Studio.
PRINT: (Connectors panel with Google Drive highlighted and the Connect button visible)
2

Find Google Drive and click Connect

Under Apps, locate Google Drive and click Connect to start authentication.
PRINT: (Provider authorization / consent screen for Google Drive)
3

Authorize access

Sign in with the account you want to use and review the requested permissions before confirming.
4

Confirm it is active

Back in Tess, Google Drive should appear under Connected, ready for chats and agents.
PRINT: (Tess callback or Connectors list showing Google Drive as Connected with a success state)

​
What you can do

  • Search files and folders by name, type, or location
  • Summarize and locate documents relevant to a task
  • Create folders and organize files when the account has write access
  • Support sharing workflows within the permissions of the connected account
  • Work across My Drive and accessible shared drives

​
Example prompts

  1. Find the latest proposal PDF about Acme and summarize the commercial terms.
  2. List files modified in the last 7 days in the Marketing folder.
  3. Create a folder named ‘Q3 Launch’ and tell me where it was created.
  4. Locate the onboarding checklist and outline the missing steps.

​
Best practices

  • Prefer folder or file names that are unique enough to avoid ambiguity.
  • Ask before destructive actions like permanent deletes.
  • In agents, define whether Drive is for search-only or also file organization.

​
Troubleshooting

Reconnect Drive and confirm the Google account can grant the requested access. Workspace policies may block the app.
Reconnect Google Drive in Connectors after credential or admin policy changes.
Confirm the connected account can access that item (including shared drives).
Tess uses the permissions of the connected account. It does not expand access beyond what that account can already do.Connectors involve access to external systems. Only connect accounts that fit the usage context, and review permissions carefully.