Google Drive
Comprehensive Google Drive connector for managing files, folders, permissions, shared drives, and collaboration features.
What you can ask
- Find files shared with
external@partner.comin the last 7 days for a security review. - Move every file in
My Drive / Receiptsolder than 1 year into theArchive 2024folder. - List documents in the
Engineeringshared drive last modified in the past week.
Set up
Google Drive needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Google Drive. Click Enable, and choose which tools to allow.
- Create a Google Cloud project.
- Turn on the Google Drive API.
- Configure the OAuth consent screen.
- Create credentials, choose OAuth client ID, and set the type to Web application.
- Add the exact Redirect URI shown in the connector settings.
- Copy the client ID and client secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Google Drive login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (3)
Grant the scopes for the tools you plan to allow.
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.readonly
Tools
Google Drive offers 49 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (17)
View and search information without changing it.
| Tool | What it does |
|---|---|
download_file | Download the raw stored bytes of a regular (non-Workspace) file by file ID -- PDF, CSV, image, ZIP or Office. |
export_file | Convert and export a Google Workspace document (Docs, Sheets, Slides, Drawings) to a format such as PDF, DOCX, XLSX, or plain text. |
generate_file_ids | Pre-generate file IDs that can be passed as the id field to create_file or copy_file, making those writes retry-safe: a replay with the same ID returns the already-created file instead of creating a duplicate. |
get_comment | Get details of a specific comment |
get_drive | Get detailed information about a specific shared drive |
get_file | Get detailed metadata for a specific file or folder. |
get_permission | Get details of a specific permission for a file |
get_reply | Get a single reply in a comment thread on a Google Drive file by its ID. |
list_comments | List all comments and replies on a Google Drive file with pagination support |
list_drives | List all shared drives (Team Drives) accessible to the user |
list_files | List and search files and folders in Google Drive with advanced filtering options |
list_permissions | List all permissions (sharing settings) for a file or folder |
list_replies | List all replies to a specific comment with pagination and filtering options |
read_file_text | Read a Drive file's contents as text. file_id comes from search_files or list_files; a UUID is never a Drive ID. |
search_drives | Search shared drives with a Drive query, e.g. "name contains 'marketing'". |
search_files | Search for files using an advanced Google Drive query string. |
validate_credential | Validate Google Drive credentials. |
Write (9)
Create or send data.
| Tool | What it does |
|---|---|
batch_create_permissions | Share a file with multiple users/groups. |
copy_file | Create a copy of a file with an optional new name and location. |
create_comment | Add a new comment to a Google Drive file with optional text anchoring and rich formatting |
create_drive | Create a new shared drive for team collaboration. |
create_file | Create an empty file, folder, or shortcut in Google Drive; takes no content. |
create_permission | Share a file or folder with a user, group, or make it public |
create_reply | Add a reply to an existing comment thread on a Google Drive file. |
initiate_resumable_upload | Initiates a resumable upload and returns one-time usable pre-authorized session URI (valid 7 days) that the caller streams file chunks to via HTTP PUT with X-Goog-Upload-Offset, X-Goog-Upload-Command (upload/finalize), and X-Goog-Upload-Total-Size headers. |
upload_file | Create a file with content in Google Drive (text, CSV, HTML, or base64), optionally converted to a Google Doc, Sheet, or Slides file via target_mime_type. |
Delete or overwrite (23)
Remove or replace existing data.
| Tool | What it does |
|---|---|
batch_delete_permissions | Remove multiple permissions from a file at once |
delete_comment | Permanently delete a comment and all its replies from a Google Drive file |
delete_drive | Permanently delete a shared drive. |
delete_file | PERMANENT — bypasses the trash and cannot be undone. |
delete_permission | Remove a permission (stop sharing with a user or group) |
delete_reply | Permanently delete a specific reply from a comment thread |
empty_trash | Permanently delete all files in the trash |
hide_drive | Hide a shared drive from the user's view (does not delete) |
make_private | Remove public access from a file or folder |
make_public | Make a file or folder accessible to anyone with the link. |
reopen_comment | Reopen a resolved comment thread on a Google Drive file by posting a reply with action 'reopen' (the only way Drive can reopen a thread). |
resolve_comment | Resolve a comment thread on a Google Drive file by posting a reply with action 'resolve' (the only way Drive can resolve a thread). |
set_drive_restrictions | Set access restrictions on a shared drive (all six Drive.restrictions fields). |
transfer_ownership | Transfer ownership of a file to another user. |
trash_file | Move a file or folder to the trash, from where it can be restored with untrash_file or purged with empty_trash. |
unhide_drive | Restore a hidden shared drive to the user's view |
untrash_file | Restore a file or folder from the trash. |
update_comment | Update the text content of an existing comment on a Google Drive file. |
update_drive | Update shared drive settings including name, color, and restrictions |
update_file | Update file or folder metadata including name, description, parents, and properties |
update_file_content | Update the content of an existing file in Google Drive including Google Docs, Sheets, and other documents |
update_permission | Update an existing permission (change access level or expiration) |
update_reply | Update an existing reply to a comment |