Skip to main content

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.com in the last 7 days for a security review.
  • Move every file in My Drive / Receipts older than 1 year into the Archive 2024 folder.
  • List documents in the Engineering shared 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.

  1. Go to Organization > Connectors and find Google Drive. Click Enable, and choose which tools to allow.
  2. Create a Google Cloud project.
  3. Turn on the Google Drive API.
  4. Configure the OAuth consent screen.
  5. Create credentials, choose OAuth client ID, and set the type to Web application.
  6. Add the exact Redirect URI shown in the connector settings.
  7. Copy the client ID and client secret into the connector, then save it.
  8. 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/drive
  • https://www.googleapis.com/auth/drive.file
  • https://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.

ToolWhat it does
download_fileDownload the raw stored bytes of a regular (non-Workspace) file by file ID -- PDF, CSV, image, ZIP or Office.
export_fileConvert and export a Google Workspace document (Docs, Sheets, Slides, Drawings) to a format such as PDF, DOCX, XLSX, or plain text.
generate_file_idsPre-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_commentGet details of a specific comment
get_driveGet detailed information about a specific shared drive
get_fileGet detailed metadata for a specific file or folder.
get_permissionGet details of a specific permission for a file
get_replyGet a single reply in a comment thread on a Google Drive file by its ID.
list_commentsList all comments and replies on a Google Drive file with pagination support
list_drivesList all shared drives (Team Drives) accessible to the user
list_filesList and search files and folders in Google Drive with advanced filtering options
list_permissionsList all permissions (sharing settings) for a file or folder
list_repliesList all replies to a specific comment with pagination and filtering options
read_file_textRead a Drive file's contents as text. file_id comes from search_files or list_files; a UUID is never a Drive ID.
search_drivesSearch shared drives with a Drive query, e.g. "name contains 'marketing'".
search_filesSearch for files using an advanced Google Drive query string.
validate_credentialValidate Google Drive credentials.

Write (9)​

Create or send data.

ToolWhat it does
batch_create_permissionsShare a file with multiple users/groups.
copy_fileCreate a copy of a file with an optional new name and location.
create_commentAdd a new comment to a Google Drive file with optional text anchoring and rich formatting
create_driveCreate a new shared drive for team collaboration.
create_fileCreate an empty file, folder, or shortcut in Google Drive; takes no content.
create_permissionShare a file or folder with a user, group, or make it public
create_replyAdd a reply to an existing comment thread on a Google Drive file.
initiate_resumable_uploadInitiates 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_fileCreate 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.

ToolWhat it does
batch_delete_permissionsRemove multiple permissions from a file at once
delete_commentPermanently delete a comment and all its replies from a Google Drive file
delete_drivePermanently delete a shared drive.
delete_filePERMANENT — bypasses the trash and cannot be undone.
delete_permissionRemove a permission (stop sharing with a user or group)
delete_replyPermanently delete a specific reply from a comment thread
empty_trashPermanently delete all files in the trash
hide_driveHide a shared drive from the user's view (does not delete)
make_privateRemove public access from a file or folder
make_publicMake a file or folder accessible to anyone with the link.
reopen_commentReopen 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_commentResolve 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_restrictionsSet access restrictions on a shared drive (all six Drive.restrictions fields).
transfer_ownershipTransfer ownership of a file to another user.
trash_fileMove a file or folder to the trash, from where it can be restored with untrash_file or purged with empty_trash.
unhide_driveRestore a hidden shared drive to the user's view
untrash_fileRestore a file or folder from the trash.
update_commentUpdate the text content of an existing comment on a Google Drive file.
update_driveUpdate shared drive settings including name, color, and restrictions
update_fileUpdate file or folder metadata including name, description, parents, and properties
update_file_contentUpdate the content of an existing file in Google Drive including Google Docs, Sheets, and other documents
update_permissionUpdate an existing permission (change access level or expiration)
update_replyUpdate an existing reply to a comment
⌘J