Google Drive
Connect Google Drive so agents can search, read, and organize files and documents.
Connecting Google Drive allows your agents to search for files, read documents, inspect spreadsheets, and save outputs directly into your drive folders.
Connect Google Drive
Connect Google Drive from the account integrations settings:
Open Settings and find Google Drive
Navigate to Settings > Integrations and find the Google Drive card.
Authorize with Google
Click Connect and select the Google account you want to connect. Review the requested permissions and approve access.
Attach Google Drive to your agent
Open your agent's settings, navigate to Integrations, and enable Google Drive. You can now prompt your agent to search files, read documents, and access shared team files.
Permissions and scope widening
When connecting Google Drive, Hyperagent requests permissions to search and read your files.
Scope tiers and the amber warning badge
Older connections may hold legacy narrow scopes (drive.file) that only grant access to files explicitly created by Hyperagent. When an agent searches for pre-existing documents or shared files, these restrictive permissions cause search queries to return empty results.
Hyperagent automatically inspects your granted OAuth scope tier:
- Amber status badge: If your connection holds legacy
drive.filepermissions, an amber status indicator appears on the Google Drive card in Settings > Integrations. - Widen permissions: Click the Widen permissions prompt on the connected account row. This initiates a quick re-authorization flow to upgrade your connection to full Drive search permissions without disconnecting your account.
Shared drive support
With upgraded permissions, agent file searches automatically index and search across both personal My Drive folders and organizational Shared Drives.