Google Drive for AI agents
Agents read Google Drive at once. Changes and sends are held for a person's approval by default.
About Google Drive
Google Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices, with robust search and offline access
What an agent can do in Google Drive
Every Google Drive action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Google Drive without asking first. 36 actions.
- Download file via operationTool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are va
- Find fileThe comprehensive Google Drive search tool that handles all file and folder discovery needs. Use this for any file finding task - from simple name searches to complex queries with date filters, MIME t
- Generate File IDsGenerates a set of file IDs which can be provided in create or copy requests. Use when you need to pre-allocate IDs for new files or copies.
- Get aboutTool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats. Note: storageQuota
- Get Changes Start Page TokenTool to get the starting pageToken for listing future changes in Google Drive. Returns only a token — pass it to GOOGLEDRIVE_LIST_CHANGES to retrieve actual changes. Persist this token; losing it requ
- Get CommentTool to get a comment by ID. Use when you need to retrieve a specific comment from a Google Drive file and have both the file ID and comment ID.
- Get Shared DriveTool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. To discover drive_ids, use GOOGLEDRIVE_LIST_SHARED_DRIVES first; GOOGLEDRIVE_GET_ABOUT reflec
- Get File MetadataGets a Drive file's metadata by ID, optionally returning only the metadata selected by `fields`. Use `fields` such as `id,name,mimeType,parents,modifiedTime` when a compact partial response is needed;
- Get Property (v2)Tool to get a property by its key using Google Drive API v2. Use when you need to retrieve a specific custom property attached to a file.
- Get PermissionGets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. Newly created or updated permissions on shared drives may have a brief propagation delay before app
- Get RevisionTool to get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID. Returns metadata only — not file content. Use a separate download tool to retrieve file content or re
- List Access ProposalsTool to list pending access proposals on a file. Use when you need to retrieve access proposals for a specific file. Note: Only approvers can list access proposals; non-approvers will receive a 403 er
Show all 36
- List ApprovalsTool to list approvals on a file for workflow-based access control. Use when you need to retrieve all approvals associated with a specific file in Google Drive.
- List ChangesTool to list the changes for a user or shared drive. Use when a full incremental change feed is needed (for simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE instead). Tracks modifications such
- List CommentsTool to list all comments for a file in Google Drive. Results are paginated; iterate using nextPageToken until absent to retrieve all comments. Filtering by author, content, or other criteria must be
- List File LabelsTool to list the labels already applied to a file in Google Drive. An empty labels array is a valid response indicating no labels are applied, not an error. This tool shows only applied labels; label_
- List PermissionsTool to list a file's permissions. Use when you need to retrieve all permissions associated with a specific file or shared drive.
- List Replies to CommentTool to list replies to a comment in Google Drive. Use this when you need to retrieve all replies associated with a specific comment on a file.
- List File RevisionsTool to list a file's revision metadata (not content) in Google Drive. Drive may prune old revisions, so history may be incomplete for frequently edited files. Filter client-side for specific revision
- List Shared DrivesTool to list the user's shared drives. Use when you need to get a list of all shared drives accessible to the authenticated user. Results may differ from the web UI due to admin policies; listing a dr
- Read Spreadsheet ValuesRead values from one or more ranges in a Google spreadsheet.
- Find folderFinds one page of Google Drive folders by name and optional parent. Use nextPageToken with page_token to retrieve additional pages.
- Get AppTool to get information about a specific Drive app by ID. Use 'self' as the app ID to get information about the calling app.
- Get Child Reference (v2)Tool to get a specific child reference for a folder using Drive API v2. Use when you need to verify a specific file exists as a child of a folder.
- Get DocumentRetrieve a native Google Docs document's structured content and metadata by ID.
- Get Google FormRetrieve a Google Form's definition, questions, settings, and publishing state by ID.
- Get Parent Reference (v2)Tool to get a specific parent reference for a file using Drive API v2. Use when you need to retrieve information about a specific parent folder of a file.
- Get Permission ID for EmailTool to get the permission ID for an email address using the Drive API v2. Use when you need to convert an email address to its corresponding permission ID.
- Get Google Slides PresentationRetrieve a Google Slides presentation and its complete page structures by ID.
- Get Presentation Page ThumbnailGenerate one short-lived page thumbnail URL using an expensive Slides quota read.
- Get SpreadsheetRetrieve a Google Spreadsheet's structure, metadata, and selected grid data.
- Get Spreadsheet ValuesRead values from one range in a Google Spreadsheet.
- List Folder Children (v2)Tool to list a folder's children using Google Drive API v2. Use when you need to retrieve all files and folders within a specific folder.
- List Properties (v2 API)Tool to list a file's properties in Google Drive API v2. Use when you need to retrieve custom properties (key-value pairs) attached to a file.
- List Google Form ResponsesReturn one page of submissions for a Google Form.
- List Label DefinitionsLists available Google Drive labels, returning each label's ID and display name without requiring a file ID.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 50 actions.
- Batch Get Spreadsheet ValuesRead multiple explicit ranges from one Google Spreadsheet in one request.
- Create CommentTool to create a comment on a file in Google Drive. Returns a nested `data` object; extract `data.id` for the resulting comment identifier. Omit `anchor` and `quoted_file_content_*` for general file-l
- Create Shared DriveTool to create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage.
- Create File or FolderCreates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file_to_upload is provided, uploads the actual f
- Create a folderCreates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the pa
- Create PermissionTool to create a permission for a file or shared drive. Use when you need to share a file or folder with users, groups, domains, or make it publicly accessible. **Warning:** Concurrent permissions ope
- Create Permissions BatchCreates multiple permissions for files or shared drives in a single batch request. Use this action when you need to share multiple files with users, or share a single file with multiple users or group
- Create ReplyTool to create a reply to a comment in Google Drive. Use when you need to respond to an existing comment on a file.
- Create Shortcut to File/FolderTool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it. The shortcut receives its own distinct
- Delete CommentPermanently deletes a comment thread (and all its replies) from a Google Drive file — this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE_DELETE_REPLY instead.
- Delete Shared DriveTool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified).
- Delete PermissionDeletes a permission from a file by permission ID. Deletion is irreversible — confirm the target user, group, or permission type before executing. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMI
Show all 50
- Delete ReplyTool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread — use GOOGLEDRIVE_
- Empty TrashTool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. Recovery is impossible after execution — no Drive tool can restore items once tras
- Get ReplyTool to get a specific reply to a comment on a file. Use when you need to retrieve the details of a particular reply.
- Hide Shared DriveTool to hide a shared drive from the default view. Use when you want to remove a shared drive from the user's main Google Drive interface without deleting it.
- Modify File LabelsModifies the set of labels applied to a file. Returns a list of the labels that were added or modified. Use when you need to programmatically change labels on a Google Drive file, such as adding, upda
- Move FileTool to move a file from one folder to another in Google Drive. To truly move (not just copy the parent), always provide both `add_parents` (destination folder ID) and `remove_parents` (source folder
- Patch PermissionTool to update a permission using patch semantics. Use when you need to modify specific fields of an existing permission without affecting other fields. **Warning:** Concurrent permissions operations
- Stop Watch ChannelTool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch. Both `id` and `resourceId` must be saved from th
- Trash FileTool to move a file or folder to trash (soft delete). Use when you need to delete a file but want to allow recovery via UNTRASH_FILE. This action is distinct from permanent deletion and provides a saf
- Unhide Shared DriveTool to unhide a shared drive. Use when you need to restore a shared drive to the default view.
- Untrash FileTool to restore a file from the trash. Use when you need to recover a deleted file. This action updates the file's metadata to set the 'trashed' property to false. Only works while the file remains in
- Update CommentTool to update an existing comment on a Google Drive file. Use when you need to change the content of a comment. NOTE: The 'resolved' field is read-only in the Google Drive API. To resolve or reopen a
- Update Shared DriveTool to update the metadata for a shared drive. Use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive.
- Update File Metadata (PATCH v2)Tool to update file metadata using the Drive API v2 PATCH method. Use when you need to modify file properties like title, description, or labels using patch semantics.
- Update File (Metadata)Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 — only explicitly provided fields are updated, so omit fields you do not intend to overwrite. Use this tool to m
- Update File Revision MetadataUpdates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). IMPORTANT: This action does NOT update file content. To update file cont
- Update PermissionTool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive. Inherited or domain-managed permissions may not be editable; verify edi
- Update ReplyTool to update a reply to a comment on a Google Drive file. Use when you need to modify the content of an existing reply.
- Upload File from URL to DriveTool to fetch a file from a provided URL server-side and upload it into Google Drive. Use when you need to reliably persist externally hosted files into Drive without client-side downloads or temporar
- Watch Drive ChangesTool to subscribe to changes for a user or shared drive in Google Drive. Use when you need to monitor a Google Drive for modifications and receive notifications at a specified webhook URL. Notificatio
- Watch File for ChangesTool to subscribe to push notifications for changes to a specific file. Use when you need to monitor a file for modifications and receive real-time notifications at a webhook URL.
- Write Spreadsheet ValuesReplace values in one range of a Google spreadsheet.
- Insert File Parent (v2)Tool to add a parent folder for a file using Google Drive API v2. Use when you need to add a file to an additional folder.
- Insert Property (v2 API)Tool to add a property to a file, or update it if it already exists (v2 API). Use when you need to attach custom key-value metadata to a Google Drive file.
- Batch Update Spreadsheet ValuesWrite values to multiple Google Sheets ranges in one batch request.
- Clear Spreadsheet ValuesPermanently clear values from one range while preserving formatting, notes, and validation.
- Copy file with advanced optionsCreates a copy of a file and applies any requested updates with patch semantics. Use when you need to duplicate a file with advanced options like label inclusion, visibility settings, or custom metada
- Create a File from TextCreates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types. Returns flat metadata fields (`id`, `mi
- Delete Child (v2)Tool to remove a child from a folder using Google Drive API v2. Use when you need to remove a file from a specific folder.
- Delete Parent (v2)Tool to remove a parent from a file using Google Drive API v2. Use when you need to remove a file from a specific folder.
- Delete Property (v2 API)Tool to delete a property from a file using Google Drive API v2. Use when you need to remove custom key-value metadata from a file.
- Delete RevisionTool to permanently delete a file revision. Use when you need to remove a specific version of a binary file (images, videos, etc.). Cannot delete revisions for Google Docs/Sheets or the last remaining
- Edit FileUpdates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). IMPORTANT: This action only works with files that have binary content (text files,
- Delete folder or fileTool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. Note: This action is irreversible. Deleting a folder permanently remove
- Insert Child Into Folder (v2)Tool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder.
- Patch Property (v2 API)Tool to update a property on a file using PATCH semantics (v2 API). Use when you need to partially update custom key-value metadata attached to a Google Drive file.
- Update Property (v2 API)Tool to update a property on a file using Google Drive API v2. Use when you need to modify an existing custom property attached to a file.
- Update Spreadsheet ValuesWrite values to one exact Google Sheets range.
Changes wait in Needs you
Changes and sends in Google Drive are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Google Drive questions
Can an agent change data in Google Drive on its own?
Not by default. Changes and sends in Google Drive are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Google Drive?
This connector lists 36 read actions. Reads run at once, without waiting for approval.
How does Google Drive connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.