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 **Get Download URL** 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
Get a downloadable **non–Google Workspace** file from Drive, along with its browser download URL. 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.
update_comment
Update the text of an existing Google Drive comment. Provide replyId to update a reply in that comment thread instead.
get_about
Get information about the authenticated Google Drive user and the user's storage quota.
list_changes
Get a fresh Google Drive changes page token or list file and shared-drive changes after a previously returned token.
get_drive_app
Get details about one Google Drive app by ID, including the file types it opens, whether it is installed and authorized, and its open and create URL templates.
list_drive_labels
List the Google Drive label definitions (taxonomies) the user can see, including each label's fields and selection choices. Use the returned field query keys in a Drive search query to find files by label.
list_drive_apps
List the Google Drive apps installed for the authenticated user, such as editors and viewers that can open or create files. Optionally filter to apps that handle given file extensions or MIME types, and see which apps the user chose as defaults.
get_drive_label
Get one Google Drive label definition by ID or resource name, including its fields, selection choices, lifecycle state, and what the user can do with it.
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. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.
Common questions about connecting Google Drive to AI agents with Metorial.