update_permission
Update Permission
Change the role of an existing permission on a file or folder. Use **List Permissions** to find the permission ID.
update_permission
Change the role of an existing permission on a file or folder. Use **List Permissions** to find the permission ID.
export_file
Export a Google Workspace file (Docs, Sheets, Slides, Drawings) to a standard format such as PDF, DOCX, XLSX, CSV, or plain text. Only works with Google Workspace native formats — for regular files use the **Download File** tool.
delete_comment
Delete a comment from a file. This removes the comment permanently.
reply_to_comment
Add a reply to an existing comment thread on a file. Can also resolve or reopen the comment thread by setting the action field.
upload_file
Upload a file with content to Google Drive. Provide file content as plain text or base64-encoded string. The file will be created with the given name, metadata MIME type, and optional parent folder.
list_permissions
List all permissions (sharing settings) for a file or folder. Shows who has access and their role (owner, writer, commenter, reader).
create_comment
Add a comment to a file. Optionally quote specific content from the file that the comment relates to.
copy_file
Create a copy of an existing file in Google Drive. Optionally provide a new name and destination folder for the copy.
share_file
Share a file or folder with a user, group, domain, or make it accessible to anyone with a link. Assigns a specific role (reader, commenter, writer, or owner) to the grantee.
create_shared_drive
Create a new shared drive for team collaboration. Requires Google Workspace admin privileges.
list_shared_drives
List all shared drives the authenticated user has access to. Optionally filter by name query.
create_file
Create a new file or folder in Google Drive. To create a folder, set `mimeType` to `application/vnd.google-apps.folder`. To create a Google Doc, Sheet, or Slides, use the appropriate Google Workspace MIME type. Specify parent folder IDs to place the file in a specific location.
list_comments
List all comments on a file, including threaded replies. Shows comment content, author, timestamps, and resolution status.
remove_permission
Remove a permission (revoke access) from a file or folder. Use **List Permissions** to find the permission ID.
list_revisions
List the revision history of a file. Shows all saved versions with timestamps, who modified them, and file sizes.
download_file
Download a **non–Google Workspace** file from Drive as an attachment. For Docs, Sheets, or Slides, use **Export File** instead.
get_file
Retrieve detailed metadata for a specific file or folder by its ID. Returns comprehensive information including name, MIME type, size, ownership, timestamps, sharing status, and links.
update_file
Update a file or folder's metadata in Google Drive. Can rename, change description, star/unstar, trash/restore, or move between folders. To move a file, specify both `addParentIds` and `removeParentIds`.
search_files
Search for files and folders in Google Drive using queries. Supports filtering by name, MIME type, parent folder, ownership, modification date, shared status, and trashed state. Use the `query` field with Google Drive query syntax (e.g. `name contains 'report'`, `mimeType = 'application/pdf'`, `'folderId' in parents`). Results can be ordered and paginated.
delete_file
Permanently delete a file or folder from Google Drive. This action is irreversible. To move a file to trash instead (recoverable), use the **Update File** tool with `trashed: true`.
delete_shared_drive
Delete a shared drive. The shared drive must be empty before it can be deleted.
update_shared_drive
Update a shared drive's name or restrictions.
Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Apply and read custom labels on files. Monitor file and folder changes via push notifications or webhook subscriptions. Store app-specific data in a hidden per-user folder.
Common questions about connecting Google Drive to AI agents with Metorial.