Google Drive
Your Toolhouse AI Worker can connect to Googledrive using 89 specialized tools.
Auth Connection
This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.
Tools (89)
Googledrive Add File Sharing Preference
Googledrive Add File Sharing PreferenceIntegration name: GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE
DEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead; use GOOGLEDRIVE_UPDATE_PERMISSION to modify existing permissions (avoids duplicate entries). Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or 'anyone'. Bulk calls may trigger 403 rateLimitExceeded (~100 req/100s/user); use jittered exponential backoff.
Parameters
role
string
✅
"reader"
Permission role to grant. Accepted values: 'reader', 'commenter', 'writer', 'fileOrganizer', 'organizer', 'owner'. Invalid strings cause validation failures.
type
string
✅
"user"
Type of grantee for the permission. Using 'anyone' with 'writer' or 'owner' broadly exposes the document — confirm before applying. Admin policies may block 'anyone' or domain-wide sharing. For type='anyone' with role='reader', the link must be explicitly shared; files are not publicly searchable.
domain
string
"example.com"
Domain to grant permission to (e.g., 'example.com'). Required if 'type' is 'domain'.
file_id
string
✅
"1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
Unique identifier of the file to update sharing settings for. Must be an alphanumeric string containing only letters, numbers, hyphens, and underscores (no slashes, spaces, or other special characters). Use GOOGLEDRIVE_FIND_FILE or GOOGLEDRIVE_LIST_FILES to get valid file IDs from your Google Drive. For shared drive membership, supply the shared drive ID, not an individual document ID.
email_address
string
"user@example.com"
Email address of the user or group. Required if 'type' is 'user' or 'group'.
transfer_ownership
boolean
—
Whether to transfer ownership to the specified user. Required when role is 'owner'. Only a single user can be specified in the request when transferring ownership. Ownership transfer is difficult to reverse — obtain explicit confirmation before setting true.
Googledrive Add Parent
Googledrive Add ParentIntegration name: GOOGLEDRIVE_ADD_PARENT
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.
Parameters
id
string
✅
"1WKV9eNX4QggD5THTud3YMeN3Z7cP0CHf"
The ID of the parent folder to add. This is the folder that will become a parent of the file.
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the file to add a parent folder to.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Default is false.
supportsTeamDrives
boolean
—
Deprecated: Use supportsAllDrives instead.
enforceSingleParent
boolean
—
Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead.
Googledrive Add Property
Googledrive Add PropertyIntegration name: GOOGLEDRIVE_ADD_PROPERTY
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format values.
fields
string
—
Selector specifying which fields to include in a partial response.
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the file.
callback
string
—
JSONP callback function name.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
visibility
string
"PRIVATE"
Property visibility values.
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
property_key
string
✅
"test_property"
The key of this property.
property_value
string
✅
"test_value"
The value of this property.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
Googledrive Copy File
Googledrive Copy FileIntegration name: GOOGLEDRIVE_COPY_FILE
DEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. Duplicates an existing file (not folders) in Google Drive by file_id; copy lands in same folder as original — use GOOGLEDRIVE_MOVE_FILE afterward for precise placement. Copy receives a new file_id; update stored references accordingly. For shared drives, requires organizer/manager rights.
Parameters
file_id
string
✅
"1A2b3C4d5E6fG7h8I9j0KlMNOPqRstUVW"
The unique identifier for the file on Google Drive that you want to copy. This ID can be retrieved from the file's shareable link or via other Google Drive API calls. Pass only the raw ID, not a full URL. Name-based searches may return multiple files — confirm the correct file_id before calling.
new_title
string
"Copy of Quarterly Report"
The title to assign to the new copy of the file. If not provided, the copied file will have the same title as the original, prefixed with 'Copy of '.
Googledrive Copy File Advanced
Googledrive Copy File AdvancedIntegration name: GOOGLEDRIVE_COPY_FILE_ADVANCED
Creates 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 metadata.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
name
string
—
The name of the copied file. If not provided, the copied file will have the same name as the original, prefixed with 'Copy of '.
xgafv
string
—
V1 error format options.
fields
string
—
Selector specifying which fields to include in a partial response. Use comma-separated field paths.
fileId
string
✅
"1A2b3C4d5E6fG7h8I9j0KlMNOPqRstUVW"
The ID of the file to copy. This is the unique identifier for the file on Google Drive.
parents
array
—
The IDs of the parent folders which contain the file. If not specified as part of a copy request, the file inherits any discoverable parents of the source file.
starred
boolean
—
Whether the user has starred the file.
trashed
boolean
—
Whether the file has been trashed.
callback
string
—
JSONP callback parameter.
mimeType
string
—
The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
properties
object
—
A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
createdTime
string
—
The time at which the file was created (RFC 3339 date-time).
description
string
—
A short description of the copied file.
oauth_token
string
—
OAuth 2.0 token for the current user.
ocrLanguage
string
—
A language hint for OCR processing during image import (ISO 639-1 code).
prettyPrint
boolean
—
Returns response with indentations and line breaks for improved readability.
access_token
string
—
OAuth access token.
modifiedTime
string
—
The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime will also update modifiedByMeTime for the user.
appProperties
object
—
A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request with an OAuth 2 client ID.
includeLabels
string
—
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
folderColorRgb
string
—
The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the folderColorPalette field of the About resource.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
writersCanShare
boolean
—
Whether users with only writer permission can modify the file's permissions. Not populated for items in shared drives.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
supportsTeamDrives
boolean
—
Deprecated: Use supportsAllDrives instead.
enforceSingleParent
boolean
—
Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead.
keepRevisionForever
boolean
—
Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
ignoreDefaultVisibility
boolean
—
Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.
includePermissionsForView
string
—
Specifies which additional view's permissions to include in the response. Only 'published' is supported.
copyRequiresWriterPermission
boolean
—
Whether the options to copy, print, or download this file should be disabled for readers and commenters.
Googledrive Create Comment
Googledrive Create CommentIntegration name: GOOGLEDRIVE_CREATE_COMMENT
Tool 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-level comments.
Parameters
anchor
string
"{\"region\": {\"kind\": \"drive#commentRegion\", \"line\": 12, \"rev\": \"head\"}}"
A JSON string defining the region of the document to which the comment is anchored. Format: {"region": {"kind": "drive#commentRegion", "": , "rev": "head"}}. Supported classifiers: (1) "line" for text lines (e.g., "line": 12), (2) "page" for page numbers (e.g., "page": {"p": 0}), (3) "txt" for text ranges (e.g., "txt": {"o": 100, "l": 50}), (4) "rect" for rectangles in images (e.g., "rect": {"x": 10, "y": 20, "w": 100, "h": 50}), (5) "time" for video timestamps (e.g., "time": {"t": "00:01:30"}), (6) "matrix" for spreadsheet cells (e.g., "matrix": {"c": 2, "r": 5}). Note: On blob files, only unanchored comments are supported. Google Workspace editors may treat API-set anchors as unanchored.
content
string
✅
"This is a great document!"
The plain text content of the comment.
file_id
string
✅
"1a2b3c4d5e6f7g8h9i0j"
The ID of the file. The id field from GOOGLEDOCS_SEARCH_DOCUMENTS results can be used directly without conversion.
quoted_file_content_value
string
"This is the text to quote."
The quoted content itself.
quoted_file_content_mime_type
string
"text/plain"
The MIME type of the quoted content.
Googledrive Create Drive
Googledrive Create DriveIntegration name: GOOGLEDRIVE_CREATE_DRIVE
Tool to create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage.
Parameters
name
string
✅
"My New Shared Drive"
The name of this shared drive.
hidden
boolean
—
Whether the shared drive is hidden from default view.
themeId
string
"default"
The ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a drive.drives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
colorRgb
string
"#FF0000"
The color of this shared drive as an RGB hex string. It can only be set on a drive.drives.update request that does not set themeId.
requestId
string
"your-unique-request-id-123"
Optional. An ID for idempotent creation of a shared drive. If not provided, a UUID will be auto-generated. Each requestId can only be used ONCE to successfully create a drive. If retrying a request that succeeded previously with the same requestId, the existing drive will be returned.
backgroundImageFile
object
—
An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on drive.drives.update requests that don't set themeId. When specified, all fields of the backgroundImageFile must be set.
Googledrive Create File
Googledrive Create FileIntegration name: GOOGLEDRIVE_CREATE_FILE
Creates 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 file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default — set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in parents rather than GOOGLEDRIVE_CREATE_FOLDER.
Parameters
name
string
—
The name of the file. While optional, providing a meaningful name is strongly recommended. If not specified, Google Drive will create the file with name 'Untitled'.
fields
string
—
A comma-separated list of fields to include in the response.
parents
array
—
Google Drive folder ID (not folder name) where the file will be created. Must be a list with exactly one folder ID (e.g., ['1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs07X8ygaR']). Folder IDs are long alphanumeric strings, not human-readable names. Use GOOGLEDRIVE_FIND_FOLDER or GOOGLEDRIVE_LIST_FILES to look up folder IDs by name. If omitted, the file is created in My Drive root.
starred
boolean
—
Whether the user has starred the file.
mimeType
string
—
Common MIME types for Google Drive file creation.
description
string
—
A short description of the file.
file_to_upload
object
—
Optional file content to upload. FileUploadable object where 'name' is the filename (can override the 'name' parameter above). If provided, the file will be created with the actual content from this upload. If omitted, creates an empty file (for folders) or empty Google Workspace document. Use this when you need to upload actual file bytes (images, PDFs, documents, etc.).
Googledrive Create File From Text
Googledrive Create File From TextIntegration name: GOOGLEDRIVE_CREATE_FILE_FROM_TEXT
Creates 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, mimeType, name) at the top level — not nested under a file object. Created files are private by default; use a sharing tool afterward for collaborative access. Rapid successive calls may trigger 403 rateLimitExceeded or 429 userRateLimitExceeded; apply exponential backoff between retries. Does not support shared-drive targets in all cases.
Parameters
file_name
string
✅
"meeting_notes.txt"
Required. Desired name for the new file on Google Drive. Also accepts 'title' or 'name' as aliases.
mime_type
string
"text/plain"
MIME type for the new file, determining how Google Drive interprets its content. Must exactly match the content type — a mismatched value (e.g., text/plain for HTML) breaks Drive previews and downstream conversion.
parent_id
string
"1KMXpS5g9N04W44_1T7_IDN18V8x00AKE"
IMPORTANT: Must be a valid Google Drive folder ID that exists and you have access to. Do NOT pass folder names - only folder IDs work. If omitted, the file is created in the root of 'My Drive'. To get a folder ID from a folder name, use GOOGLEDRIVE_FIND_FOLDER first. Also accepts 'folder_id' or 'parent_folder_id' as aliases.
text_content
string
✅
—
Required. Plain text content to be written into the new file. Also accepts 'content', 'body', or 'text' as aliases. Only the documented aliases (content, body, text) are accepted; undocumented keys like file_content cause an 'Invalid request data' error. Must be UTF-8 encoded.
Googledrive Create Folder
Googledrive Create FolderIntegration name: GOOGLEDRIVE_CREATE_FOLDER
Creates 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 parent exists or find its ID. Google Drive permits duplicate folder names, so always store and reuse the folder ID returned by this action rather than relying on names for future lookups.
Parameters
name
string
✅
"Project Files"
Name for the new folder. This is a required field.
parent_id
string
"1A2b3C4d5E6fG7h8I9j0KlMNOPqRstUVW"
ID or exact name of an EXISTING parent folder. IMPORTANT: The parent folder MUST already exist - this action will NOT create parent folders automatically. If you need to create nested folders, first use GOOGLEDRIVE_FIND_FOLDER to verify the parent exists, or create it with a separate call. If a name is provided, the action searches for a folder with that exact name. If omitted, the folder is created in the Drive root. Must be non-trashed, accessible, and an actual folder (not a file) — shared drive root IDs are not valid. Use GOOGLEDRIVE_FIND_FOLDER to verify before calling.
Googledrive Create Permission
Googledrive Create PermissionIntegration name: GOOGLEDRIVE_CREATE_PERMISSION
Tool 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 operations on the same file are not supported; only the last update is applied.
Parameters
role
string
✅
"reader"
The role granted by this permission. Valid values are: owner, organizer, fileOrganizer, writer, commenter, reader.
type
string
✅
"user"
The type of the grantee. When creating a permission, if type is 'user' or 'group', you must provide an emailAddress. When type is 'domain', you must provide a domain. There isn't extra information required for 'anyone' type.
domain
string
"example.com"
The domain to which this permission refers. Required when type is 'domain'.
file_id
string
✅
"1Cw6BhxeaUWjjuXJNFniIE0aPxS6y3BZgwQtdmr43tAY"
The ID of the file or shared drive.
email_address
string
"user@example.com"
The email address of the user or group to which this permission refers. Required when type is 'user' or 'group'.
email_message
string
"Check out this document!"
A plain text custom message to include in the notification email.
expiration_time
string
"2024-12-31T23:59:59Z"
The time at which this permission will expire (RFC 3339 date-time). Expiration times can only be set on user and group permissions, must be in the future, and cannot be more than a year in the future.
transfer_ownership
boolean
—
Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.
supports_all_drives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
allow_file_discovery
boolean
—
Whether the permission allows the file to be discovered through search. This is only applicable for permissions of type 'domain' or 'anyone'.
move_to_new_owners_root
boolean
—
This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to true, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to false, parents are not changed.
send_notification_email
boolean
—
Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.
use_domain_admin_access
boolean
—
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
Googledrive Create Reply
Googledrive Create ReplyIntegration name: GOOGLEDRIVE_CREATE_REPLY
Tool to create a reply to a comment in Google Drive. Use when you need to respond to an existing comment on a file.
Parameters
action
string
"resolve"
The action the reply performed to the parent comment.
fields
string
"id,content"
Selector specifying which fields to include in a partial response.
content
string
✅
"Thanks for the feedback!"
The plain text content of the reply. HTML content is not supported.
file_id
string
✅
"1234567890abcdefghijklmnopqrstuvwxyz"
The ID of the file.
comment_id
string
✅
"0987654321zyxwutsrqponmlkjihgfedcba"
The ID of the comment.
Googledrive Create Shortcut To File
Googledrive Create Shortcut To FileIntegration name: GOOGLEDRIVE_CREATE_SHORTCUT_TO_FILE
Tool 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 file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE_MOVE_FILE after creation to place the shortcut in the desired location.
Parameters
name
string
✅
"My Shortcut to Important Document"
The name of the shortcut.
target_id
string
✅
"1_DRbC10_AYSg3tNA2c2P9H2a26n9_2VA"
The ID of the file or folder that this shortcut points to.
includeLabels
string
"labelId1,labelId2"
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
supportsAllDrives
boolean
true
Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if interacting with shared drives.
keepRevisionForever
boolean
false
Whether to set the 'keepForever' field in the new head revision.
ignoreDefaultVisibility
boolean
false
Whether to ignore the domain's default visibility settings for the created file.
includePermissionsForView
string
"published"
Enum for includePermissionsForView parameter.
Googledrive Create Team Drive
Googledrive Create Team DriveIntegration name: GOOGLEDRIVE_CREATE_TEAM_DRIVE
Tool to create a Team Drive. Deprecated: Use drives.create instead. Use when you need to create a Team Drive for collaboration.
Parameters
name
string
✅
"My New Team Drive"
The name of this Team Drive. This is a required field.
themeId
string
"default"
The ID of the theme from which the background image and color will be set. The set of possible teamDriveThemes can be retrieved from a drive.about.get response. When not specified on a drive.teamdrives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
colorRgb
string
"#FF0000"
The color of this Team Drive as an RGB hex string. It can only be set on a drive.teamdrives.update request that does not set themeId.
requestId
string
"your-unique-request-id-123"
Optional. An ID for idempotent creation of a Team Drive. If not provided, a UUID will be auto-generated. Each requestId can only be used ONCE to successfully create a Team Drive. If retrying a request that succeeded previously with the same requestId, the existing Team Drive will be returned or a 409 error will occur.
backgroundImageFile
object
—
An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on drive.teamdrives.update requests that don't set themeId. When specified, all fields of the backgroundImageFile must be set.
Googledrive Delete Child
Googledrive Delete ChildIntegration name: GOOGLEDRIVE_DELETE_CHILD
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format enum.
fields
string
—
Selector specifying which fields to include in a partial response.
childId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the child.
callback
string
—
JSONP
folderId
string
✅
"1WKV9eNX4QggD5THTud3YMeN3Z7cP0CHf"
The ID of the folder.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. "media", "multipart").
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. "raw", "multipart").
enforceSingleParent
boolean
—
Deprecated: If an item is not in a shared drive and its last parent is removed, the item is placed under its owner's root.
Googledrive Delete Comment
Googledrive Delete CommentIntegration name: GOOGLEDRIVE_DELETE_COMMENT
Permanently 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. Verify the exact comment content and comment_id before calling.
Parameters
file_id
string
✅
"1a2b3c4d5e6f7g8h9i0j"
The ID of the file.
comment_id
string
✅
"AAAByC37kko"
The ID of the comment. Comment IDs are different from file IDs and have a distinct format (e.g., 'AAAByC37kko'). You must obtain the comment ID from the LIST_COMMENTS or CREATE_COMMENT actions. Do NOT use the file ID here.
Googledrive Delete Drive
Googledrive Delete DriveIntegration name: GOOGLEDRIVE_DELETE_DRIVE
Tool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified).
Parameters
driveId
string
✅
"0AEMyflX29xHjUk9PVA"
The ID of the shared drive.
allowItemDeletion
boolean
true
Whether any items inside the shared drive should also be deleted. This option is only supported when useDomainAdminAccess is also set to true.
useDomainAdminAccess
boolean
true
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.
Googledrive Delete File
Googledrive Delete FileIntegration name: GOOGLEDRIVE_DELETE_FILE
DEPRECATED: Use GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION instead. Tool to permanently delete a file owned by the user without moving it to trash. Use when permanent deletion is required. If the file belongs to a shared drive, the user must be an organizer on the parent folder.
Parameters
fileId
string
✅
"1xiFp6uO3jRczGuFJ_LdaRVg3ene6lNq-"
The ID of the file to delete. This permanently removes the file without moving it to trash.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Set to true if the file might be in a shared drive.
enforceSingleParent
boolean
—
Deprecated parameter. If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item is placed under its owner's root.
Googledrive Delete Parent
Googledrive Delete ParentIntegration name: GOOGLEDRIVE_DELETE_PARENT
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format enum.
fields
string
—
Selector specifying which fields to include in a partial response.
fileId
string
✅
"1xygSVDktMDb4chxS3AQTMzABKWYdWtOB"
The ID of the file.
callback
string
—
JSONP
parentId
string
✅
"1IL1JRSfkm9B_L-guI7g-birKApFyD_Di"
The ID of the parent.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. "media", "multipart").
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. "raw", "multipart").
enforceSingleParent
boolean
—
Deprecated: If an item is not in a shared drive and its last parent is removed, the item is placed under its owner's root.
Googledrive Delete Permission
Googledrive Delete PermissionIntegration name: GOOGLEDRIVE_DELETE_PERMISSION
Deletes 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_PERMISSIONS to get valid permission IDs. To fully revoke public access, the type='anyone' (link-sharing) permission must be explicitly deleted; revoking other permissions leaves the file publicly accessible via link. Use when you need to revoke access for a specific user or group from a file.
Parameters
file_id
string
✅
"1a2b3c4d5e6f7g8h9i0j"
The ID of the file or shared drive.
permission_id
string
✅
"18394857362947583"
The unique ID of the permission to delete. IMPORTANT: You MUST first call GOOGLEDRIVE_LIST_PERMISSIONS with the file_id to retrieve valid permission IDs. Permission IDs are opaque identifiers assigned by Google (e.g., '18394857362947583', 'anyoneWithLink') and cannot be guessed. Do NOT use placeholder values like 'any' or '1234'.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
useDomainAdminAccess
boolean
—
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
Googledrive Delete Property
Googledrive Delete PropertyIntegration name: GOOGLEDRIVE_DELETE_PROPERTY
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format values.
fields
string
—
Selector specifying which fields to include in a partial response.
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the file.
callback
string
—
JSONP callback function name.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
visibility
string
—
The visibility of the property. If specified, only deletes the property if it has this visibility level.
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
propertyKey
string
✅
"test_delete_property"
The key of the property to delete.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
Googledrive Delete Reply
Googledrive Delete ReplyIntegration name: GOOGLEDRIVE_DELETE_REPLY
Tool 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_DELETE_COMMENT to remove the entire thread.
Parameters
file_id
string
✅
"1ZdR3L3Kek7szY1j11SQZ9A_00up1j2xG"
The ID of the file.
reply_id
string
✅
"AAAA_example_reply_id"
The ID of the reply. Confirm correct target using createdTime and author alongside reply_id, as multiple similar replies may exist on the same comment.
comment_id
string
✅
"AAAA_example_comment_id"
The ID of the comment.
Googledrive Delete Revision
Googledrive Delete RevisionIntegration name: GOOGLEDRIVE_DELETE_REVISION
Tool 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 revision.
Parameters
file_id
string
✅
"19GP5DRpUcmQHBVnk39RTB57twIWVEMjO"
The ID of the file.
revision_id
string
✅
"0B_vaZgd8EyufZ0xKU1BBemkvQnNBL0hESWdiY3VTWWQxNWRFPQ"
The ID of the revision to delete. You can obtain revision IDs by calling GOOGLEDRIVE_LIST_REVISIONS. Important: You can only delete revisions for files with binary content (images, videos, etc.), not Google Docs or Sheets. You cannot delete the last remaining revision of a file.
Googledrive Delete Team Drive
Googledrive Delete Team DriveIntegration name: GOOGLEDRIVE_DELETE_TEAM_DRIVE
Tool to permanently delete a Team Drive. Deprecated: Use drives.delete instead. Use when you need to remove a Team Drive using the legacy endpoint.
Parameters
teamDriveId
string
✅
"0AIHqBGLiYNb7Uk9PVA"
The ID of the Team Drive to delete.
Googledrive Download File
Googledrive Download FileIntegration name: GOOGLEDRIVE_DOWNLOAD_FILE
Downloads a file from Google Drive by its ID. For Google Workspace documents (Docs, Sheets, Slides), optionally exports to a specified mime_type. For other file types, downloads in their native format regardless of mime_type. Examples: Export a Google Doc to plain text: {"file_id": "1N2o5xQWmAbCdEfGhIJKlmnOPq", "mime_type": "text/plain"} Download a Google Sheet as CSV: {"file_id": "1ZyXwVuTsRqPoNmLkJiHgFeDcB", "mime_type": "text/csv"}
Parameters
fileId
string
✅
"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"
The unique identifier of the file to be downloaded from Google Drive. Must be a valid Google Drive file ID containing only alphanumeric characters, hyphens, and underscores. File paths with slashes (/) are not valid. This ID can typically be found in the file's URL in Google Drive or obtained from API calls that list files.
mime_type
string
"application/pdf"
ONLY for Google Workspace documents (Docs, Sheets, Slides, Drawings). Specifies the export format. Has NO effect on regular files (PDFs, images, videos, Office documents, etc.) - they are always downloaded in their native format. Google Forms and Maps cannot be downloaded as they do not support exports through the Drive API. If omitted for Google Workspace files, defaults to PDF. Different Workspace types support different formats. Use application/pdf for universal compatibility.
Googledrive Download File2
Googledrive Download File2Integration name: GOOGLEDRIVE_DOWNLOAD_FILE2
DEPRECATED: Use GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION instead. Tool to download file content as a long-running operation. Use when you need to download files from Google Drive. Operations are valid for 24 hours from the time of creation.
Parameters
file_id
string
✅
"1iau-j_ezb2Vcx1tZDMDdfpqlzxVzlscg"
The ID of the file to download
Googledrive Download File Operation
Googledrive Download File OperationIntegration name: GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION
Tool 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 valid for 24 hours from creation. Returns a response containing downloaded_file_content.s3url — a short-lived S3 URL; fetch the actual file bytes from that URL promptly after the call.
Parameters
file_id
string
✅
"1xAHUNyfubIa8K07EVv9_5Hc5EsgdIhUx-QNcrGJ_yQk"
The ID of the file to download. This is a required parameter. The file_id can be found in the file's Google Drive URL or obtained from API calls that list files.
mime_type
string
"application/pdf"
The MIME type for exporting Google Workspace documents (Google Docs, Sheets, Slides, etc.) to different formats. Only applicable to Google Workspace documents (not blob files like PDFs, images, videos). If provided for a non-Google Workspace file, this parameter will be ignored to prevent API errors. Common export formats: 'application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' (Word), 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' (Excel).
revision_id
string
"1"
The ID of the revision to download. If not specified, the current head revision will be downloaded. This field can only be set when downloading blob files, Google Docs, and Google Sheets.
Googledrive Edit File
Googledrive Edit FileIntegration name: GOOGLEDRIVE_EDIT_FILE
Updates 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, PDFs, images, etc.). It does NOT support editing Google Workspace native files (Google Docs, Sheets, Slides, etc.). For Google Workspace files, use the Google Docs API, Google Sheets API, or Google Slides API directly. Preserves the original file_id (unlike GOOGLEDRIVE_UPLOAD_FILE which creates a new ID).
Parameters
content
string
✅
—
New textual content to overwrite the existing file; will be UTF-8 encoded for upload. Overwrites the entire file body — partial edits are not possible, so reconstruct the full desired content before calling. Back up with GOOGLEDRIVE_COPY_FILE before irreversible edits.
file_id
string
✅
—
ID of the Google Drive file to update. Only works with files that have binary content (e.g., .txt, .json, .pdf, .jpg files uploaded to Drive). Does NOT support Google Workspace native files (Docs, Sheets, Slides) even if they appear as spreadsheets or documents - those must be edited via Google Docs/Sheets/Slides APIs. Use GOOGLEDRIVE_FIND_FILE to retrieve an existing file's ID; using an upload action instead would create a duplicate with a different ID.
mime_type
string
"text/plain"
MIME type of the content being uploaded. Must match the actual format of the content being uploaded (not the existing file type). Cannot be a Google Workspace MIME type (application/vnd.google-apps.*). Valid examples: text/plain, text/html, application/json, application/pdf, image/jpeg.
Googledrive Empty Trash
Googledrive Empty TrashIntegration name: GOOGLEDRIVE_EMPTY_TRASH
Tool 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 trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive's trash; omit to empty the user's root trash.
Parameters
driveId
string
"0ABmN4q4aF7dPUk9PVA"
If set, empties the trash of the provided shared drive. This parameter is ignored if the item is not in a shared drive.
enforceSingleParent
boolean
—
Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root. This parameter is ignored if the item is not in a shared drive.
Googledrive Export Google Workspace File
Googledrive Export Google Workspace FileIntegration name: GOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILE
Exports a Google Workspace document to the requested MIME type and returns exported file content. Use when you need to export Google Docs, Sheets, Slides, Drawings, or Apps Script files to a specific format. Note: The exported content is limited to 10MB by Google Drive API.
Parameters
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the Google Workspace file to export. Must be a valid file ID for a Google Docs, Sheets, Slides, Drawings, or Apps Script file.
mimeType
string
✅
"application/pdf"
The MIME type of the format requested for this export. Supported formats depend on the source file type: Google Docs -> DOCX, ODT, RTF, PDF, TXT, HTML (ZIP), EPUB, Markdown; Google Sheets -> XLSX, ODS, PDF, CSV, TSV, HTML (ZIP); Google Slides -> PPTX, ODP, PDF, TXT, JPG, PNG, SVG; Google Drawings -> PDF, JPG, PNG, SVG; Apps Script -> JSON.
Googledrive Find File
Googledrive Find FileIntegration name: GOOGLEDRIVE_FIND_FILE
The 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 types, permissions, custom properties, folder scoping, and more. Searches across My Drive and shared drives with full metadata support. Examples: - Find PDFs: q="mimeType = 'application/pdf'" - Find recent files: q="modifiedTime > '2024-01-01T00:00:00'" - Search by name: q="name contains 'report'" - Files in folder: folderId="abc123" or q="'FOLDER_ID' in parents"
Parameters
q
string
"name = 'Budget 2024'"
Query string to filter file results. Accepts both simple text searches and full Google Drive query syntax. Simple Text Search: Bare text (e.g., "SAM RFP") is auto-converted to fullText search. Bare email addresses are auto-converted to owner search. Full Query Syntax: 'field operator value' combined with 'and', 'or', 'not' Operators: =, !=, <, >, <=, >=, contains, in Common Fields: - name - File name (exact match with = or partial match with contains) - fullText - File content search - mimeType - File type (e.g., 'application/pdf', 'application/vnd.google-apps.folder') - modifiedTime, createdTime - Dates (RFC 3339: '2024-01-01T00:00:00') - parents - Folder IDs containing the file - owners, writers - User email addresses (MUST use 'in' operator, NOT colon syntax) - properties, appProperties - Custom metadata Boolean Filter Fields (sharedWithMe, trashed, starred): These fields require explicit = true or = false syntax: - sharedWithMe = true - Find files shared with you by others - sharedWithMe = false - Find files NOT shared with you (your own files) - trashed = true - Find files in trash - trashed = false - Exclude trashed files from results - starred = true - Find starred/favorited files - starred = false - Find non-starred files Combine with other conditions using 'and': - "sharedWithMe = true and name contains 'report'" - Find shared files with 'report' in name - "sharedWithMe = true and mimeType = 'application/pdf'" - Find shared PDF files - "starred = true and modifiedTime > '2024-01-01T00:00:00'" - Find recently modified starred files Query Complexity Limits: Queries with many OR clauses (typically >5-10) may fail with 'The query is too complex' error. Name Field Usage: Wildcards (*) are NOT supported. Use 'contains' operator for partial matching. User Email Searches: - CORRECT: "'user@example.com' in owners" or "'user@example.com' in writers" or "'user@example.com' in readers" - INCORRECT: "owner:user@example.com" (colon syntax is NOT supported and will cause errors) - Always use the 'in' operator with quoted email addresses for user-based searches Special Syntax: - Dates: RFC 3339 format (time zone defaults to UTC) - Apostrophes/quotes in values: Automatically escaped. You can write "name = 'Jan'26'" or "name = 'Valentine's Day'" without manual escaping. - Grouping: Use parentheses for OR: "(mimeType contains 'image/' or mimeType contains 'video/')" - Custom properties: "properties has { key='department' and value='sales' }" IMPORTANT - Root Folder ('My Drive'): 'My Drive' is NOT a searchable folder name. To work with the root folder, use the 'root' alias: folder_id='root' or "'root' in parents" in your query.
fields
string
"*"
Selector specifying which fields to include in a partial response. Use '*' for all fields. Default Behavior (Recommended for Discovery): When omitted, returns essential file discovery fields: id, name, mimeType, size, modifiedTime, createdTime, parents, webViewLink, trashed, starred. This lightweight default is optimized for file search/discovery use cases without verbose permission or capability metadata. Format: For file fields, use 'files(field1,field2,...)' format. For example: 'files(id,name,mimeType)'. Top-level response fields (kind, nextPageToken, incompleteSearch) can be used directly. Note: Bare field names like 'id,name,mimeType' will be automatically wrapped in 'files()' for convenience. The 'editors' field is not valid in Drive API v3; use 'permissions' instead for access control information.
spaces
string
"drive"
A comma-separated list of spaces to query. Supported values are 'drive', 'appDataFolder' and 'photos'.
corpora
string
"user"
Specifies which collections of files to search. Defaults to 'allDrives' (searches My Drive + all accessible shared drives). Values: - user - Search only user's personal My Drive - domain - Search all files shared within Google Workspace domain - drive - Search specific shared drive (requires 'driveId' parameter and 'includeItemsFromAllDrives' must be true) - allDrives - Search My Drive + all accessible shared drives (DEFAULT, requires 'includeItemsFromAllDrives' to be true) When to Use: - Personal files only: Use 'user' - Organization-wide: Use 'domain' - Specific shared drive: Use 'drive' with 'driveId' - Maximum coverage: Use 'allDrives' (auto-enables supportsAllDrives and includeItemsFromAllDrives)
driveId
string
—
ID of the shared drive to search. When provided, 'corpora' will automatically be set to 'drive' (mutually exclusive with corpora='allDrives'). Required if 'corpora' is 'drive'.
orderBy
string
"modifiedTime desc"
Comma-separated sort keys. Ascending by default; add 'desc' for descending. Cannot be used when query (q) contains fullText search terms. Valid Keys: - createdTime, modifiedTime, modifiedByMeTime - Dates - viewedByMeTime, sharedWithMeTime - Activity dates - name, name_natural - File name (natural: file1, file2, file10) - folder - Folder hierarchy - quotaBytesUsed - Storage size (NOTE: 'size' is NOT valid, use 'quotaBytesUsed') - starred - Starred status - recency - Recent activity (combines view time and modification time for relevance-based sorting) Important: 'size' is NOT a valid sort key. Use 'quotaBytesUsed' to sort by file size. Restriction: Sorting is not supported when the query contains fullText searches (e.g., "fullText contains 'keyword'"). Omit orderBy when using fullText queries.
pageSize
integer
10
The maximum number of files to return per page.
folder_id
string
"1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
ID of a specific folder to search within. This automatically adds "'folder_id' in parents" to the query. Can be combined with the 'q' parameter to further filter results within the folder. Use 'root' to search within the user's root folder (My Drive). Note: 'My Drive' is not a searchable folder name - use 'root' alias instead.
pageToken
string
—
The token for continuing a previous list request on the next page. IMPORTANT: This must be the exact opaque string from a previous response's 'nextPageToken' field - do not modify, truncate, URL-encode, or construct tokens manually. Invalid or corrupted tokens will result in API errors.
include_labels
string
"label_abc123"
A comma-separated list of label IDs to include in the labelInfo part of the response for each file. Empty strings are automatically treated as omitted.
pagetoken_dropped
boolean
—
Indicates whether the page token was dropped from the request.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. If 'includeItemsFromAllDrives' is true, this must also be true.
original_email_query
string
—
The original email query before transformation.
editors_field_removed
boolean
—
Indicates whether the editors field was removed from the request.
email_query_transformed
boolean
—
Indicates whether an email query was transformed into a search filter.
orderby_size_transformed
boolean
—
Indicates whether the orderBy size value was transformed.
original_bare_text_query
string
—
The original bare text query before transformation.
includeItemsFromAllDrives
boolean
—
Whether both My Drive and shared drive items should be included in results. Must be true when corpora is 'drive' or 'allDrives'. If true, 'supportsAllDrives' should also be true.
emailaddress_field_removed
boolean
—
Indicates whether the email address field was removed from the request.
original_invalid_pagetoken
string
—
The original invalid page token that was dropped.
bare_text_query_transformed
boolean
—
Indicates whether a bare text query was transformed into a search filter.
include_permissions_for_view
string
"published"
Specifies which additional view's permissions to include in the response. Must be either omitted entirely or set to 'published'. Empty strings are automatically treated as omitted.
Googledrive Find Folder
Googledrive Find FolderIntegration name: GOOGLEDRIVE_FIND_FOLDER
Tool to find a folder in Google Drive by its name and optionally a parent folder. Use when you need to locate a specific folder to perform further actions like creating files in it or listing its contents.
Parameters
starred
boolean
—
Set to true to search for folders that are starred, or false for those that are not.
name_exact
string
"Project Alpha"
The exact name of the folder to search for as a string. This search is case-sensitive. Do not pass numbers - convert to string if needed.
name_contains
string
"report"
A substring to search for within folder names as a string. This search is case-insensitive.
modified_after
string
"2023-08-01T00:00:00Z"
Search for folders modified after a specific date and time. The timestamp must be in RFC 3339 format (e.g., '2023-01-15T10:00:00Z' or '2023-01-15T10:00:00.000Z').
parent_folder_id
string
"1aBcDeFgHiJkLmNoPqRsTuVwXyZ"
The ID of the parent folder to search within. Only folders directly inside this parent folder will be returned. You can find parent folder IDs by first searching for the parent folder by name. Supports folders in both My Drive and Shared Drives.
name_not_contains
string
"archive"
A substring to exclude from folder names as a string. Folders with names containing this substring will not be returned. This search is case-insensitive.
full_text_contains
string
"confidential project details"
A string to search for within the folder's name or description (NOT the content of files inside the folder). This search is case-insensitive. Note: Google Drive's fullText search on folders only matches the folder's own metadata, not files contained within.
full_text_not_contains
string
"draft"
A string to exclude from the folder's name or description (NOT the content of files inside the folder). This search is case-insensitive. Note: Google Drive's fullText search on folders only matches the folder's own metadata, not files contained within.
Googledrive Generate Ids
Googledrive Generate IdsIntegration name: GOOGLEDRIVE_GENERATE_IDS
Generates 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.
Parameters
type
string
"files"
The type of items for which the IDs can be used. For example, 'files' or 'shortcuts'.
count
integer
10
The number of IDs to return. Value must be between 1 and 1000, inclusive.
space
string
"drive"
The space in which the IDs can be used. Supported values are 'drive' and 'appDataFolder'.
Googledrive Get About
Googledrive Get AboutIntegration name: GOOGLEDRIVE_GET_ABOUT
Tool 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 reflects My Drive (personal) storage only — it does not cover shared drives; use GOOGLEDRIVE_LIST_SHARED_DRIVES and GOOGLEDRIVE_GET_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately.
Parameters
fields
string
"*"
A comma-separated list of fields to include in the response. Use * to include all fields. Supported fields in Drive API v3: kind, user, storageQuota, importFormats, exportFormats, maxImportSizes, maxUploadSize, appInstalled, canCreateDrives, canCreateTeamDrives (deprecated), driveThemes, teamDriveThemes (deprecated), folderColorPalette. Note: rootFolderId was removed in v3 and is not supported. Note: storageQuota sub-fields (limit, usage, usageInDrive, usageInDriveTrash) are returned as strings representing bytes — convert to numeric types before arithmetic.
Googledrive Get App
Googledrive Get AppIntegration name: GOOGLEDRIVE_GET_APP
Tool to get information about a specific Drive app by ID. Use 'self' as the app ID to get information about the calling app.
Parameters
appId
string
✅
"self"
The ID of the app. Use 'self' to refer to the calling app.
Googledrive Get Change
Googledrive Get ChangeIntegration name: GOOGLEDRIVE_GET_CHANGE
Tool to get a specific change by ID from Google Drive v2 API. Deprecated: Use changes.getStartPageToken and changes.list to retrieve recent changes instead.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format.
fields
string
—
Selector specifying which fields to include in a partial response.
driveId
string
—
The shared drive from which the change will be returned.
callback
string
—
JSONP
changeId
string
✅
"50"
The ID of the change.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
teamDriveId
string
—
Deprecated: Use driveId instead.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
supportsTeamDrives
boolean
—
Deprecated: Use supportsAllDrives instead.
Googledrive Get Changes Start Page Token
Googledrive Get Changes Start Page TokenIntegration name: GOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKEN
Tool 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 requires a full rescan. The token is forward-looking: GOOGLEDRIVE_LIST_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE; use this tool only for incremental change-feed workflows.
Parameters
driveId
string
"0AB_CD1234EFG5HIJ6KLM7N8PQRST9UVWX"
The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive will be returned.
teamDriveId
string
"0AB_CD1234EFG5HIJ6KLM7N8PQRST9UVWX"
Deprecated: Use driveId instead.
supportsAllDrives
boolean
true
Whether the requesting application supports both My Drives and shared drives. Defaults to false.
supportsTeamDrives
boolean
true
Deprecated: Use supportsAllDrives instead.
Googledrive Get Child
Googledrive Get ChildIntegration name: GOOGLEDRIVE_GET_CHILD
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format options.
fields
string
—
Selector specifying which fields to include in a partial response.
childId
string
✅
"1iau-j_ezb2Vcx1tZDMDdfpqlzxVzlscg"
The ID of the child.
callback
string
—
JSONP callback parameter.
folderId
string
✅
"0APvaZgd8EyufUk9PVA"
The ID of the folder.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
Googledrive Get Comment
Googledrive Get CommentIntegration name: GOOGLEDRIVE_GET_COMMENT
Tool 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.
Parameters
fileId
string
✅
"1a2b3c4d5e6f7g8h9i0j"
The ID of the file.
commentId
string
✅
"11a22b33c44d55e66f77g88h99i00j"
The ID of the comment.
includeDeleted
boolean
—
Whether to return deleted comments. Deleted comments will not include their original content.
Googledrive Get Drive
Googledrive Get DriveIntegration name: GOOGLEDRIVE_GET_DRIVE
Tool 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 reflects overall user storage, not individual shared drive details. Permission changes may have a brief propagation delay before appearing in results.
Parameters
drive_id
string
✅
"0ABCA123456789"
The ID of the shared drive.
use_domain_admin_access
boolean
true
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.
Googledrive Get File Metadata
Googledrive Get File MetadataIntegration name: GOOGLEDRIVE_GET_FILE_METADATA
Tool to get a file's metadata by ID. Use to verify mimeType, parents, and trashed status before destructive operations (delete/move/export), or to confirm mimeType='application/vnd.google-apps.document' before calling GOOGLEDOCS_* tools (non-native files require GOOGLEDRIVE_DOWNLOAD_FILE). Only returns metadata visible to the connected account; public access requires GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE. High-frequency calls risk 403 rateLimitExceeded; apply exponential backoff.
Parameters
fields
string
—
Comma-separated list of fields to include in the response. Use this for partial responses to request only specific metadata fields. Common fields: id, name, mimeType, webViewLink, webContentLink, createdTime, modifiedTime, size, quotaBytesUsed, parents, owners, permissions. Use '' to return all available fields. Note: The deprecated v2 field 'alternateLink' is automatically migrated to 'webViewLink'. Example: 'id,name,mimeType,webViewLink,createdTime,modifiedTime'. Most fields (webViewLink, parents, owners, size, modifiedTime, etc.) are omitted by default — explicitly list required fields or use '' (increases latency). md5Checksum is null for native Google Workspace files (Docs/Sheets/Slides); use mimeType to classify items — folders use mimeType='application/vnd.google-apps.folder' and Workspace files return size=null. modifiedTime is RFC 3339 UTC format.
fileId
string
✅
"1a2b3c4d5e6f7g8h9i0j"
The Google Drive file ID (an opaque alphanumeric string like '1a2b3c4d5e6f7g8h9i0j'), NOT a file name. If you only have a file name, use GOOGLEDRIVE_FIND_FILE or GOOGLEDRIVE_LIST_FILES to get the file ID first.
includeLabels
string
—
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Defaults to true to ensure files in shared drives are accessible.
includePermissionsForView
string
—
Specifies which additional view's permissions to include in the response. Only 'published' is supported.
Googledrive Get File Property
Googledrive Get File PropertyIntegration name: GOOGLEDRIVE_GET_FILE_PROPERTY
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.
Parameters
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the file.
visibility
string
—
The visibility of the property. Allowed values are PRIVATE (default) and PUBLIC. Private properties can only be retrieved using an authenticated request.
propertyKey
string
✅
"test_key"
The key of the property.
Googledrive Get File V2
Googledrive Get File V2Integration name: GOOGLEDRIVE_GET_FILE_V2
DEPRECATED: Use GetFileMetadata instead. Tool to get a file's metadata or content by ID from Google Drive API v2. Use when you need file metadata with alt=json, or file content with alt=media.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format values.
fields
string
—
Selector specifying which fields to include in a partial response.
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID for the file in question. This is a required parameter and cannot be empty.
callback
string
—
JSONP callback function name.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
projection
string
—
Projection parameter values (deprecated).
revisionId
string
—
Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
includeLabels
string
—
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
acknowledgeAbuse
boolean
—
Whether the user is acknowledging the risk of downloading known malware or other abusive files.
updateViewedDate
boolean
—
Deprecated: Use files.update with modifiedDateBehavior=noChange, updateViewedDate=true and an empty request body.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
supportsTeamDrives
boolean
—
Deprecated: Use supportsAllDrives instead.
includePermissionsForView
string
—
Specifies which additional view's permissions to include in the response. Only 'published' is supported.
Googledrive Get Parent
Googledrive Get ParentIntegration name: GOOGLEDRIVE_GET_PARENT
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format options.
fields
string
—
Selector specifying which fields to include in a partial response.
fileId
string
✅
"1xygSVDktMDb4chxS3AQTMzABKWYdWtOB"
The ID of the file.
callback
string
—
JSONP callback parameter.
parentId
string
✅
"0APvaZgd8EyufUk9PVA"
The ID of the parent.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
Googledrive Get Permission
Googledrive Get PermissionIntegration name: GOOGLEDRIVE_GET_PERMISSION
Gets 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 appearing.
Parameters
fields
string
"id,emailAddress,displayName,role,permissionDetails"
Selector specifying which fields to include in a partial response. Use 'fields=*' to return all available fields for the permission resource.
file_id
string
✅
"1a2b3c4d5e6f7g8h9i0j"
The ID of the file.
permission_id
string
✅
"12345678901234567890"
The numeric ID of the permission. Note: The 'me' alias is NOT supported by the Google Drive permissions API. You must provide an actual numeric permission ID (e.g., '12345678901234567890'). Use the LIST_PERMISSIONS action to get permission IDs for a file.
supports_all_drives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
use_domain_admin_access
boolean
—
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
Googledrive Get Permission Id For Email
Googledrive Get Permission Id For EmailIntegration name: GOOGLEDRIVE_GET_PERMISSION_ID_FOR_EMAIL
Tool 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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
email
string
✅
"test@example.com"
The email address for which to return a permission ID
xgafv
string
—
V1 error format values.
fields
string
—
Selector specifying which fields to include in a partial response.
callback
string
—
JSONP callback parameter.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
Googledrive Get Reply
Googledrive Get ReplyIntegration name: GOOGLEDRIVE_GET_REPLY
Tool to get a specific reply to a comment on a file. Use when you need to retrieve the details of a particular reply.
Parameters
fileId
string
✅
"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"
The ID of the file.
replyId
string
✅
"CCCCCCDDDDDD"
The ID of the reply.
commentId
string
✅
"AAAAAABBBBBB"
The ID of the comment.
includeDeleted
boolean
—
Whether to return deleted replies. Deleted replies will not include their original content.
Googledrive Get Revision
Googledrive Get RevisionIntegration name: GOOGLEDRIVE_GET_REVISION
Tool 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 restore a revision.
Parameters
file_id
string
✅
"1ZdR3L3Kek7szY1G1-2VUX8cW6CnU0c4a"
The ID of the file.
revision_id
string
✅
"0B9B5CLMDv-N4Z2FhY0E5RUQzNVE"
The ID of the revision.
acknowledge_abuse
boolean
—
Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the alt parameter is set to media and the user is the owner of the file or an organizer of the shared drive in which the file resides.
Googledrive Get Team Drive
Googledrive Get Team DriveIntegration name: GOOGLEDRIVE_GET_TEAM_DRIVE
Tool to get metadata about a Team Drive by ID. Deprecated: Use the drives.get endpoint instead.
Parameters
teamDriveId
string
✅
"0AMndV9-YuXjwUk9PVA"
The ID of the Team Drive
useDomainAdminAccess
boolean
—
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.
Googledrive Google Drive Delete Folder Or File Action
Googledrive Google Drive Delete Folder Or File ActionIntegration name: GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION
Tool 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 removes all nested files and subfolders.
Parameters
fileId
string
✅
"1XyZAbcDefGhiJklMnoPqRsTuVwXyZAbcDef"
The ID of the file or folder to delete. This is a required field.
supportsAllDrives
boolean
—
Whether the application supports both My Drives and shared drives. If false or unspecified, the file is attempted to be deleted from the user's My Drive. If true, the item will be deleted from shared drives as well if necessary.
Googledrive Hide Drive
Googledrive Hide DriveIntegration name: GOOGLEDRIVE_HIDE_DRIVE
Tool 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.
Parameters
drive_id
string
✅
"0AEMgNk_8MPnAUk9PVA"
The ID of the shared drive.
Googledrive Insert Child
Googledrive Insert ChildIntegration name: GOOGLEDRIVE_INSERT_CHILD
Tool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder.
Parameters
id
string
✅
"19GP5DRpUcmQHBVnk39RTB57twIWVEMjO"
The ID of the child file to insert into the folder.
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format options.
fields
string
—
Selector specifying which fields to include in a partial response.
callback
string
—
JSONP callback parameter.
folderId
string
✅
"1IL1JRSfkm9B_L-guI7g-birKApFyD_Di"
The ID of the folder.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
supportsTeamDrives
boolean
—
Deprecated: Use supportsAllDrives instead.
enforceSingleParent
boolean
—
Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead.
Googledrive List Access Proposals
Googledrive List Access ProposalsIntegration name: GOOGLEDRIVE_LIST_ACCESS_PROPOSALS
Tool 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 error.
Parameters
fileId
string
✅
"1lu9-CzH7k2a_ktFQvt8xfYM1L0FVGJx6"
The ID of the file to list access proposals for
pageSize
integer
—
The number of results per page
pageToken
string
—
The continuation token on the list of access requests
Googledrive List Approvals
Googledrive List ApprovalsIntegration name: GOOGLEDRIVE_LIST_APPROVALS
Tool 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.
Parameters
fileId
string
✅
"1xAHUNyfubIa8K07EVv9_5Hc5EsgdIhUx-QNcrGJ_yQk"
The ID of the file to list approvals for
pageSize
integer
—
The maximum number of approvals to return per page
pageToken
string
—
A pagination token returned as 'nextPageToken' from a previous list approvals response. Must be an exact, unmodified token from a prior API call - do not construct, encode, or guess token values. Only provide this parameter when paginating through results.
Googledrive List Changes
Googledrive List ChangesIntegration name: GOOGLEDRIVE_LIST_CHANGES
Tool 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 as creations, deletions, or permission changes. The pageToken is optional - if not provided, the current start page token will be automatically fetched; an empty result is valid if no recent activity has occurred. Example usage: json { "pageToken": "22633", "pageSize": 100, "includeRemoved": true } Returns changes with timestamps, file IDs, and modification details. Paginate by following nextPageToken until it is absent — stopping early will silently omit changes. Save newStartPageToken to monitor future changes efficiently.
Parameters
spaces
string
"drive,appDataFolder"
A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
driveId
string
"0AB1CDEfghijklmNOP"
The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier. When driveId is provided, supportsAllDrives is automatically set to true.
pageSize
integer
100
The maximum number of changes to return per page.
pageToken
string
"22633"
The token for continuing a previous list request on the next page. Must be a valid token from a previous LIST_CHANGES response's 'nextPageToken' field or from the get_changes_start_page_token action. If not provided, the current start page token will be automatically fetched and used. Tokens can become stale — always use a fresh token from GOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKEN or the most recent prior response to avoid missed or duplicate changes. Paginate until nextPageToken is absent; stopping early silently omits changes.
includeLabels
string
"labelId1,labelId2"
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
includeRemoved
boolean
—
Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.
restrictToMyDrive
boolean
—
Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Must be true when driveId is specified (will be automatically set to true when driveId is provided).
includeCorpusRemovals
boolean
—
Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file. Note: When set to true, includeRemoved must also be true (will be automatically set).
includeItemsFromAllDrives
boolean
—
Whether both My Drive and shared drive items should be included in results. Must be true when driveId is specified (will be automatically set to true when driveId is provided).
includePermissionsForView
string
"published"
Specifies which additional view's permissions to include in the response.
Googledrive List Children V2
Googledrive List Children V2Integration name: GOOGLEDRIVE_LIST_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.
Parameters
q
string
—
Query string for searching children.
alt
string
—
Data format for response enum.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format enum.
fields
string
—
Selector specifying which fields to include in a partial response. This endpoint returns ChildReference objects, NOT full File objects. Valid ChildReference fields are: 'id' (child ID), 'selfLink' (link to this reference), 'kind' (resource type), 'childLink' (link to the child). File-level fields like 'title', 'modifiedDate', 'fileSize', 'alternateLink', 'mimeType' are NOT valid. Example: 'items(id,childLink),nextPageToken'
orderBy
string
—
A comma-separated list of sort keys. Valid keys are 'createdDate', 'folder', 'lastViewedByMeDate', 'modifiedByMeDate', 'modifiedDate', 'quotaBytesUsed', 'recency', 'sharedWithMeDate', 'starred', and 'title'. Each key sorts ascending by default, but may be reversed with the 'desc' modifier. Example usage: ?orderBy=folder,modifiedDate desc,title.
callback
string
—
JSONP callback parameter.
folderId
string
✅
"root"
The ID of the folder.
pageToken
string
—
Page token for children.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
maxResults
integer
—
Maximum number of children to return.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
Googledrive List Comments
Googledrive List CommentsIntegration name: GOOGLEDRIVE_LIST_COMMENTS
Tool 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 done client-side. Use commentId, createdTime, and author from results to uniquely identify comments before acting on them.
Parameters
fields
string
"*"
A comma-separated list of fields to include in the response. Use * to include all fields. Prefer selective field masks (e.g., 'comments(id,content,author)') over '*' to reduce payload size and latency.
fileId
string
✅
"1234567890abcdefghijklmnopqrstuvwxyz"
The ID of the file. Equivalent to the Google Docs document_id; pass it here under the fileId parameter name.
pageSize
integer
—
The maximum number of comments to return per page.
pageToken
string
—
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. Comments may be added or modified during pagination on active files; use startModifiedTime to bound the window if consistency is required.
includeDeleted
boolean
—
Whether to include deleted comments. Deleted comments will not include their original content.
startModifiedTime
string
—
The minimum value of 'modifiedTime' for the result comments (RFC 3339 date-time).
Googledrive List File Labels
Googledrive List File LabelsIntegration name: GOOGLEDRIVE_LIST_FILE_LABELS
Tool 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_id and field_id values required by other Drive label tools must be obtained from admin configuration.
Parameters
file_id
string
✅
"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"
The ID of the file.
page_token
string
—
Token to retrieve a specific page of results.
max_results
integer
—
The maximum number of labels to return per page. Default is 100.
Googledrive List File Properties
Googledrive List File PropertiesIntegration name: GOOGLEDRIVE_LIST_FILE_PROPERTIES
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format values.
fields
string
—
Selector specifying which fields to include in a partial response.
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the file. This is a required parameter and cannot be empty.
callback
string
—
JSONP callback function name.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
Googledrive List Files
Googledrive List FilesIntegration name: GOOGLEDRIVE_LIST_FILES
DEPRECATED: Use GOOGLEDRIVE_FIND_FILE instead. Tool to list a user's files and folders in Google Drive. Use this to search or browse for files and folders based on various criteria.
Parameters
q
string
"name contains 'report' and starred = true"
A query string for filtering the file results. Supports operators 'and', 'or', 'not'. VALID query terms: 'name' (contains, =, !=), 'fullText' (contains), 'mimeType' (contains, =, !=), 'modifiedTime' (<=, <, =, !=, >, >=), 'viewedByMeTime' (<=, <, =, !=, >, >=), 'trashed' (=, !=), 'starred' (=, !=), 'parents' (in), 'owners' (in), 'writers' (in), 'readers' (in), 'sharedWithMe' (=, !=), 'createdTime' (<=, <, =, !=, >, >=), 'properties' (has), 'appProperties' (has), 'visibility' (=, !=), 'shortcutDetails.targetId' (=, !=). IMPORTANT: 'id' is NOT a valid query term - you cannot search by file ID using this parameter. To get a specific file by ID, use the 'Get File Metadata' action instead. Example: "name contains 'important' and mimeType = 'application/vnd.google-apps.folder'".
fields
string
"id,name,mimeType"
Selector specifying which file fields to include in the response. Provide a comma-separated list of file field names (e.g., 'id,name,mimeType,webViewLink'). The action will automatically format this into the proper API format 'files(field1,field2,...)'. Common file fields include: id, name, description, mimeType, webViewLink, webContentLink, size, createdTime, modifiedTime, parents, owners, permissions. To also include the pagination token, add 'nextPageToken' to the list. NOTE: Google Drive API v2 field names are automatically converted to v3 equivalents (e.g., alternateLink→webViewLink, downloadUrl→webContentLink, title→name, createdDate→createdTime, modifiedDate→modifiedTime).
spaces
string
"drive,appDataFolder"
A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. 'drive' represents files in My Drive and shared drives, while 'appDataFolder' represents the application's private data folder.
corpora
string
"user"
Specifies the bodies of items (files/documents) to which the query applies. Supported values are 'user', 'domain', 'drive', and 'allDrives'. It's generally more efficient to use 'user' or 'drive' instead of 'allDrives'. Defaults to 'user'.
driveId
string
"0ABCA123456789"
The ID of the shared drive to search. This is used when corpora is set to 'drive'.
orderBy
string
"modifiedTime desc,name"
A comma-separated list of sort keys. Valid keys are: 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. IMPORTANT: Use 'quotaBytesUsed' to sort by file size (do NOT use 'size' - it is not a valid key). Each key sorts in ascending order by default, but can be reversed with the 'desc' modifier (e.g., 'modifiedTime desc').
folderId
string
"1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
ID of a specific folder to list files from. This is a convenience parameter that automatically adds "'folder_id' in parents" to the query. Cannot be used together with a custom 'q' parameter.
pageSize
integer
50
The maximum number of files to return per page. The value must be between 1 and 1000, inclusive. Defaults to 100.
pageToken
string
" nextPageTokenValue"
The token for continuing a previous list request on the next page. This MUST be set to the value of 'nextPageToken' from the previous response. Do not manually construct or modify pageToken values as they are opaque tokens generated by the API. If the token is rejected, pagination should be restarted from the first page.
includeLabels
string
"labelId1,labelId2"
A comma-separated list of label IDs to include in the labelInfo part of the response for each file.
supportsAllDrives
boolean
true
Whether the requesting application supports both My Drives and shared drives. Defaults to false. If true, then includeItemsFromAllDrives can be used to extend the search to all drives.
includeItemsFromAllDrives
boolean
true
Whether to include items from both My Drive and shared drives. This is relevant when corpora is 'user' or 'domain'. Defaults to false.
includePermissionsForView
string
"published"
Include additional permissions for a specific view. The only valid value is 'published', which includes permissions for files with published content. Omit this parameter if you don't need published view permissions.
Googledrive List Permissions
Googledrive List PermissionsIntegration name: GOOGLEDRIVE_LIST_PERMISSIONS
Tool to list a file's permissions. Use when you need to retrieve all permissions associated with a specific file or shared drive.
Parameters
fileId
string
✅
"1234567890abcdefghijklmnopqrstuvwxyz"
The ID of the file or shared drive. Must be a non-empty string.
pageSize
integer
—
The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned.
pageToken
string
—
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Default: false
useDomainAdminAccess
boolean
—
Issue the request as a domain administrator; if set to true, then theRequester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
includePermissionsForView
string
—
Specifies which additional view's permissions to include in the response. Only 'published' is supported.
Googledrive List Replies
Googledrive List RepliesIntegration name: GOOGLEDRIVE_LIST_REPLIES
Tool 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.
Parameters
fields
string
—
Selector specifying which fields to include in a partial response. Use '*' for all fields or e.g. 'replies(id,content),nextPageToken'
file_id
string
✅
"12345abcdef"
The ID of the file.
page_size
integer
—
The maximum number of replies to return per page.
comment_id
string
✅
"67890ghijkl"
The ID of the comment.
page_token
string
—
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
include_deleted
boolean
—
Whether to include deleted replies. Deleted replies will not include their original content.
Googledrive List Revisions
Googledrive List RevisionsIntegration name: GOOGLEDRIVE_LIST_REVISIONS
Tool 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 revisionIds; do not assume the last entry is the active version.
Parameters
fileId
string
✅
"1234567890abcdefghijklmnopqrstuvwxyz"
The ID of the file.
pageSize
integer
100
The maximum number of revisions to return per page.
pageToken
string
"abcdef123456"
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. Continue paginating until nextPageToken is absent; stopping early silently omits revisions.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Defaults to false. Must be set to true for shared drive files; omitting it causes fileId resolution failures on shared drives.
Googledrive List Shared Drives
Googledrive List Shared DrivesIntegration name: GOOGLEDRIVE_LIST_SHARED_DRIVES
Tool 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 drive does not guarantee access to its contents. Paginated calls may trigger 403 rateLimitExceeded or 429 tooManyRequests; apply exponential backoff when iterating many pages.
Parameters
q
string
—
Query string for searching shared drives using Google Drive query syntax (e.g., "name contains 'ProjectX'" or "createdTime > '2023-01-01T00:00:00'"). Query format: query_term operator values. Common query terms: name, createdTime, memberCount, organizerCount, hidden. Common operators: contains, =, >, <, >=, !=. String values must be enclosed in single quotes. Special characters (apostrophes, backslashes) must be escaped. Multiple terms can be combined with 'and'/'or' operators and parentheses for grouping.
pageSize
integer
—
Maximum number of shared drives to return per page. Maximum allowed value is 1000. Paginate by passing the returned nextPageToken back as pageToken until no nextPageToken is returned to avoid silently missing drives.
pageToken
string
—
Page token for shared drives.
useDomainAdminAccess
boolean
—
Issue the request as a domain administrator. If set to true, then all shared drives of the domain in which the requester is an administrator are returned.
Googledrive List Team Drives
Googledrive List Team DrivesIntegration name: GOOGLEDRIVE_LIST_TEAM_DRIVES
Tool to list Team Drives (deprecated, use List Shared Drives instead). Use when you need to retrieve Team Drives using the legacy endpoint.
Parameters
q
string
—
Query string for searching Team Drives.
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports.
xgafv
string
—
V1 error format values.
fields
string
—
Selector specifying which fields to include in a partial response.
callback
string
—
JSONP callback.
pageSize
integer
—
Maximum number of Team Drives to return per page.
pageToken
string
—
Page token for Team Drives.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
useDomainAdminAccess
boolean
—
Issue the request as a domain administrator; if set to true, then all Team Drives of the domain in which the requester is an administrator are returned.
Googledrive Modify File Labels
Googledrive Modify File LabelsIntegration name: GOOGLEDRIVE_MODIFY_FILE_LABELS
Modifies 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, updating, or removing them.
Parameters
kind
string
—
This is always drive#modifyLabelsRequest.
file_id
string
✅
—
The ID of the file.
label_modifications
array
✅
—
The list of modifications to apply to the labels on the file.
Googledrive Move File
Googledrive Move FileIntegration name: GOOGLEDRIVE_MOVE_FILE
Tool 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 ID); omitting remove_parents leaves the file in multiple folders. Useful for reorganizing files, including newly created Google Docs/Sheets that default to Drive root.
Parameters
file_id
string
✅
"1XyZ..."
The ID of the file to move. Must be a non-empty string.
add_parents
string
"1FmTIJYwTENUDXOKyNJp7OmcRBvP_6DmT"
The ID of the single destination folder (e.g., '1FmTIJYwTENUDXOKyNJp7OmcRBvP_6DmT'). Must be a valid Google Drive folder ID consisting of alphanumeric characters, hyphens, and underscores. Folder names are not accepted.
ocr_language
string
—
A language hint for OCR processing during image import (ISO 639-1 code).
include_labels
string
—
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
remove_parents
string
"folder_id_3,folder_id_4"
A comma-separated list of parent folder IDs to remove the file from. Use this to specify the source folder.
supports_all_drives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Set to true if moving files to or from a shared drive.
keep_revision_forever
boolean
—
Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive.
include_permissions_for_view
string
—
Specifies which additional view's permissions to include in the response. Only 'published' is supported.
use_content_as_indexable_text
boolean
—
Whether to use the uploaded content as indexable text.
Googledrive Parse File
Googledrive Parse FileIntegration name: GOOGLEDRIVE_PARSE_FILE
DEPRECATED: Exports Google Workspace files (max 10MB) to a specified format using mime_type, or downloads other file types; use GOOGLEDRIVE_DOWNLOAD_FILE instead.
Parameters
file_id
string
✅
—
The unique ID of the file stored in Google Drive that you want to export or download.
mime_type
string
"application/pdf"
Target MIME type for exporting Google Workspace files only. Supported exports by source type: Google Docs -> DOCX, ODT, RTF, PDF, TXT, ZIP (HTML), EPUB, MD; Google Sheets -> XLSX, ODS, PDF, ZIP (HTML), CSV, TSV; Google Slides -> PPTX, ODP, PDF, TXT, JPG, PNG, SVG; Google Drawings -> PDF, JPG, PNG, SVG; Apps Script -> JSON. If omitted, a default format is used: Docs->PDF, Sheets->XLSX, Slides->PDF, Drawings->PDF. For non-Workspace files (PDFs, images, text files, etc.), this parameter is ignored and the file is downloaded in its native format.
Googledrive Patch Permission
Googledrive Patch PermissionIntegration name: GOOGLEDRIVE_PATCH_PERMISSION
Tool 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 on the same file are not supported; only the last update is applied.
Parameters
role
string
"reader"
Permission roles that can be granted in Google Drive.
file_id
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID for the file or shared drive.
with_link
boolean
—
Whether the link is required for this permission. Set to true for 'anyone with the link' access (not publicly discoverable), or false for publicly discoverable access.
permission_id
string
✅
"anyone"
The ID for the permission. Use 'anyone' for public link permissions, or specific permission IDs for user/group/domain permissions. You can get permission IDs by calling GOOGLEDRIVE_LIST_PERMISSIONS.
expiration_date
string
"2024-12-31T23:59:59Z"
The time at which this permission will expire (RFC 3339 date-time). Can only be set on user and group permissions. The date must be in the future and cannot be more than a year in the future.
additional_roles
array
["commenter"]
Additional roles for this user. Only 'commenter' is currently allowed.
remove_expiration
boolean
—
Whether to remove the expiration date. Set to true to make the permission permanent.
transfer_ownership
boolean
—
Whether changing a role to 'owner' downgrades the current owners to writers. Does nothing if the specified role is not 'owner'. Required as an acknowledgement when transferring ownership.
supports_all_drives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
use_domain_admin_access
boolean
—
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
Googledrive Patch Property
Googledrive Patch PropertyIntegration name: GOOGLEDRIVE_PATCH_PROPERTY
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
value
string
"updatedValue"
The value of this property.
xgafv
string
—
V1 error format values.
fields
string
—
Selector specifying which fields to include in a partial response.
fileId
string
✅
"19GP5DRpUcmQHBVnk39RTB57twIWVEMjO"
The ID of the file.
callback
string
—
JSONP callback function name.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
visibility
string
"PRIVATE"
Property visibility values.
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
propertyKey
string
✅
"testPatchKey"
The key of the property to update.
access_token
string
—
OAuth access token.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
Googledrive Resumable Upload
Googledrive Resumable UploadIntegration name: GOOGLEDRIVE_RESUMABLE_UPLOAD
Tool to start and complete a Google Drive resumable upload session. Use for files larger than ~5 MB to avoid timeouts or size-limit failures. HTTP 308 means continue the session from the correct byte offset; HTTP 410 means the session expired and a full restart with a new session is required.
Parameters
file_id
string
—
Optional file ID if updating an existing file instead of creating a new one.
metadata
object
—
JSON metadata for the Drive File resource (e.g., {'name': 'photo.jpg', 'parents': ['folderId']}). To convert to a Google Docs MIME type, set metadata.mimeType to the target Docs type but send the real file MIME type as the upload content type — using the Docs MIME type as upload content type causes invalidContentType errors.
chunkSize
integer
262144
Chunk size in bytes; must be a multiple of 256 KB.
queryParams
object
—
Optional Drive query parameters.
file_to_upload
object
✅
—
File to upload to Google Drive via resumable upload.
folder_to_upload_to
string
—
Optional folder ID where NEW files should be uploaded. Only used during file creation, not updates. Will be added to metadata.parents. Must reference a valid, non-trashed folder ID; invalid or trashed IDs silently place files at root.
Googledrive Stop Watch Channel
Googledrive Stop Watch ChannelIntegration name: GOOGLEDRIVE_STOP_WATCH_CHANNEL
Tool 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 the original watch response — they cannot be retrieved after the fact.
Parameters
id
string
✅
"01234567-89ab-cdef-0123-456789abcdef"
The ID of the channel to stop.
kind
string
"api#channel"
Identifies this as a notification channel used to watch for changes to a resource.
token
string
"clientToken#0123456789"
An arbitrary string delivered to the target address with each notification delivered over this channel.
params
object
{"ttl":"24"}
Additional parameters controlling delivery channel behavior.
address
string
"https://example.com/notifications"
The address where notifications are delivered for this channel.
payload
boolean
true
A Boolean value to indicate whether payload is wanted.
expiration
string
"1426325213000"
Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds.
resourceId
string
✅
"0BwDAzcyS3R3CUlRMW0xVExQNk0"
The ID of the resource being watched.
channelType
string
"web_hook"
The type of delivery mechanism used for this channel.
resourceUri
string
"https://www.googleapis.com/drive/v3/files/0BwDAzcyS3R3CUlRMW0xVExQNk0"
A version-specific identifier for the watched resource.
Googledrive Trash File
Googledrive Trash FileIntegration name: GOOGLEDRIVE_TRASH_FILE
Tool 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 safer cleanup workflow.
Parameters
fields
string
"id,name,trashed,trashedTime"
Comma-separated list of fields to include in the response. Use to limit the amount of data returned. If omitted, returns basic file metadata.
file_id
string
✅
"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"
The ID of the file to trash.
supportsAllDrives
boolean
true
Whether the requesting application supports both My Drives and shared drives. Defaults to true.
Googledrive Unhide Drive
Googledrive Unhide DriveIntegration name: GOOGLEDRIVE_UNHIDE_DRIVE
Tool to unhide a shared drive. Use when you need to restore a shared drive to the default view.
Parameters
driveId
string
✅
"0AEMV2k3MjA19Uk9PVA"
The ID of the shared drive.
Googledrive Untrash File
Googledrive Untrash FileIntegration name: GOOGLEDRIVE_UNTRASH_FILE
Tool 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 trash — recovery is impossible after trash is emptied via GOOGLEDRIVE_EMPTY_TRASH or auto-purged by policy.
Parameters
file_id
string
✅
"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"
The ID of the file to untrash.
supportsAllDrives
boolean
true
Whether the requesting application supports both My Drives and shared drives.
Googledrive Update Comment
Googledrive Update CommentIntegration name: GOOGLEDRIVE_UPDATE_COMMENT
Tool 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 comment, use CREATE_REPLY with action='resolve' or action='reopen'.
Parameters
fields
string
"id,content,resolved"
Selector specifying which fields to include in a partial response. The API documentation states this is required. If not specified by the user, this action defaults to '*' to retrieve all fields, ensuring the API requirement is met. Example: 'id,content,resolved'.
content
string
"This is the updated comment content."
The plain text content of the comment. This field is used to update the comment's text. If not provided, the existing content will be retained unless 'resolved' is being updated.
file_id
string
✅
"1a2b3c4d5e6f7g8h9i0j"
The ID of the file.
resolved
boolean
true
NOTE: The 'resolved' field is READ-ONLY in the Google Drive API. To resolve or reopen a comment, use the CREATE_REPLY action with action='resolve' or action='reopen'. This parameter is kept for backwards compatibility but will be silently ignored by the API.
comment_id
string
✅
"11a22b33c44d55e66f77g88h99i00j"
The ID of the comment to update.
Googledrive Update Drive
Googledrive Update DriveIntegration name: GOOGLEDRIVE_UPDATE_DRIVE
Tool 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.
Parameters
name
string
—
The new name for the shared drive.
hidden
boolean
—
Whether the shared drive is hidden from the default view.
driveId
string
✅
—
The ID of the shared drive to update.
themeId
string
—
The ID of a theme to apply to the shared drive. Cannot be set if colorRgb or backgroundImageFile are set.
colorRgb
string
—
The color of this shared drive as an RGB hex string (e.g., "#FF0000"). Cannot be set if themeId is set.
restrictions
object
—
A set of restrictions to apply to the shared drive.
backgroundImageFile
object
—
An image file and cropping parameters for the shared drive's background. Cannot be set if themeId is set.
useDomainAdminAccess
boolean
—
If set to true, the request is issued as a domain administrator.
Googledrive Update File Metadata Patch
Googledrive Update File Metadata PatchIntegration name: GOOGLEDRIVE_UPDATE_FILE_METADATA_PATCH
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.
Parameters
ocr
boolean
—
Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
title
string
—
The title of the file. Used to change the name of the file.
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the file to update.
labels
object
—
A group of labels for the file. For example: {'starred': true, 'trashed': false, 'restricted': false, 'viewed': true}.
pinned
boolean
—
Whether to pin the new revision. A file can have a maximum of 200 pinned revisions.
mimeType
string
—
The MIME type of the file.
addParents
string
—
Comma-separated list of parent IDs to add.
properties
array
—
The list of properties.
description
string
—
A short description of the file.
newRevision
boolean
—
Whether a blob upload should create a new revision. If not set, a new revision is created.
ocrLanguage
string
—
If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
modifiedDate
string
—
Last time this file was modified by anyone (RFC 3339 date-time). Requires setModifiedDate=true.
includeLabels
string
—
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
indexableText
object
—
Indexable text attributes for the file (can be used to improve fulltext queries).
removeParents
string
—
Comma-separated list of parent IDs to remove.
setModifiedDate
boolean
—
Whether to set the modified date using the value supplied in the request body.
writersCanShare
boolean
—
Whether writers can share the document with other users.
updateViewedDate
boolean
—
Whether to update the view date after successfully updating the file.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Defaults to true.
timedTextLanguage
string
—
The language of the timed text.
timedTextTrackName
string
—
The timed text track name.
includePermissionsForView
string
—
Specifies which additional view's permissions to include in the response. Only 'published' is supported.
useContentAsIndexableText
boolean
—
Whether to use the content as indexable text.
Googledrive Update File Property
Googledrive Update File PropertyIntegration name: GOOGLEDRIVE_UPDATE_FILE_PROPERTY
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.
Parameters
alt
string
—
Data format for response.
key
string
—
API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafv
string
—
V1 error format values.
fields
string
—
Selector specifying which fields to include in a partial response.
fileId
string
✅
"1FT9IW4UpvEc4Ezxv8xS2jEda17MztBXzK7CMqfz-s98"
The ID of the file.
callback
string
—
JSONP callback function name.
quotaUser
string
—
Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadType
string
—
Legacy upload protocol for media (e.g. 'media', 'multipart').
visibility
string
—
Visibility options for the property.
oauth_token
string
—
OAuth 2.0 token for the current user.
prettyPrint
boolean
—
Returns response with indentations and line breaks.
propertyKey
string
✅
"test_property"
The key of the property.
access_token
string
—
OAuth access token.
property_value
string
"updated_test_value"
The value of this property.
upload_protocol
string
—
Upload protocol for media (e.g. 'raw', 'multipart').
property_visibility
string
—
Visibility options for the property.
Googledrive Update File Put
Googledrive Update File PutIntegration name: GOOGLEDRIVE_UPDATE_FILE_PUT
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 modify attributes of an existing file like its name, description, or parent folders. To move a file, supply add_parents and remove_parents together; omitting remove_parents creates multiple parents, omitting add_parents can orphan the file. Bulk updates may trigger 429 Too Many Requests; apply exponential backoff. Note: supports metadata updates only; file content updates are not yet implemented.
Parameters
name
string
"My Updated Document"
The name of the file. Google Drive does not enforce name uniqueness within a folder; duplicate names are allowed and can cause ambiguous results when searching by name.
fileId
string
✅
"1XyZ_6AbCdEfGhIjKlMnOpQrStUvWxYz0"
The ID of the file to update.
starred
boolean
—
Whether the user has starred the file.
mime_type
string
"application/vnd.google-apps.document"
The MIME type of the file. Google Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
add_parents
string
"1A2B3C4D5E6F7G8H9I0J"
Comma-separated list of folder IDs (not folder names) to add as parents. Folder IDs are alphanumeric strings typically 20+ characters long (e.g., '1A2B3C4D5E6F7G8H9I0J'). Folder names will not work and will cause a 'Parent folder not found' error. Moving a file requires pairing with remove_parents (source folder ID); omitting remove_parents results in multiple parents. Reparenting to a shared folder changes collaborator access to that folder's permissions.
description
string
"Updated version of the project proposal."
A short description of the file.
ocr_language
string
"en"
A language hint for OCR processing during image import (ISO 639-1 code).
remove_parents
string
"1A2B3C4D5E6F7G8H9I0J"
Comma-separated list of folder IDs (not folder names) to remove as parents. Folder IDs are alphanumeric strings typically 20+ characters long (e.g., '1A2B3C4D5E6F7G8H9I0J'). Folder names will not work and will cause a 'Parent folder not found' error.
writers_can_share
boolean
—
Whether writers can share the document with other users.
supports_all_drives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Defaults to true to ensure compatibility with shared drive files.
keep_revision_forever
boolean
—
Whether to set this revision of the file to be kept forever. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
use_domain_admin_access
boolean
—
Whether the requesting application is using domain-wide delegation to access content belonging to a user in a different domain. This is only applicable to files with binary content in Google Drive.
viewers_can_copy_content
boolean
—
Whether viewers are prevented from copying content of the file.
Googledrive Update File Revision Metadata
Googledrive Update File Revision MetadataIntegration name: GOOGLEDRIVE_UPDATE_FILE_REVISION_METADATA
Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). IMPORTANT: This action does NOT update file content. To update file content, use EDIT_FILE or UPDATE_FILE_PUT instead. This action requires BOTH file_id AND revision_id parameters. Use LIST_REVISIONS to get available revision IDs for a file. Valid parameters: file_id (required), revision_id (required), keep_forever, published, publish_auto, published_outside_domain. Invalid parameters (use other actions): file_contents, mime_type, content, name - these are NOT supported by this action.
Parameters
file_id
string
✅
"1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789"
Required. The ID of the file whose revision metadata you want to update. Use LIST_FILES or FIND_FILE to get the file ID.
published
boolean
—
Whether this revision is published. This is only applicable to Docs Editors files.
keepForever
boolean
—
Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive.
publishAuto
boolean
—
Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files.
revision_id
string
✅
"1"
Required. The ID of the revision to update. Use LIST_REVISIONS to get available revision IDs for a file.
publishedOutsideDomain
boolean
—
Whether this revision is published outside the domain. This is only applicable to Docs Editors files.
Googledrive Update Permission
Googledrive Update PermissionIntegration name: GOOGLEDRIVE_UPDATE_PERMISSION
Tool 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 editability with GOOGLEDRIVE_LIST_PERMISSIONS before updating.
Parameters
fileId
string
✅
"1234567890abcdefghijklmnopqrstuvwxyz"
The ID of the file or shared drive.
permission
object
✅
—
The permission resource to update. Only 'role' and 'expirationTime' can be updated. Role changes take effect immediately and can be difficult to reverse; confirm intent before applying.
permissionId
string
✅
"01234567890123456789"
The ID of the permission. For anyone-type permissions, use 'anyone' as the permission ID.
removeExpiration
boolean
—
Whether to remove the expiration date.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Must be set to true when operating on shared drives; omitting this causes the request to fail.
transferOwnership
boolean
—
Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect when set to true.
useDomainAdminAccess
boolean
—
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
enforceExpansiveAccess
boolean
—
Whether the request should enforce expansive access rules. This field is deprecated, it is recommended to use permissionDetails instead.
Googledrive Update Reply
Googledrive Update ReplyIntegration name: GOOGLEDRIVE_UPDATE_REPLY
Tool to update a reply to a comment on a Google Drive file. Use when you need to modify the content of an existing reply.
Parameters
fields
string
"id,content"
Selector specifying which fields to include in a partial response. If not provided, defaults to '*' to return all fields.
content
string
✅
"This is an updated reply."
The new plain text content of the reply.
file_id
string
✅
"1ZdR3L3Kek7szY1j11SQZ9A_00up1j3aA"
The ID of the file.
reply_id
string
✅
"ANmBhkFXXXXX"
The ID of the reply.
comment_id
string
✅
"AAAAAAMAAAAA"
The ID of the comment.
Googledrive Update Team Drive
Googledrive Update Team DriveIntegration name: GOOGLEDRIVE_UPDATE_TEAM_DRIVE
Tool to update a Team Drive's metadata. Deprecated: Use the drives.update endpoint instead. Use when you need to modify Team Drive properties.
Parameters
name
string
"Bug Reproduce Test Drive"
The name of this Team Drive.
themeId
string
—
The ID of the theme from which the background image and color will be set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
colorRgb
string
—
The color of this Team Drive as an RGB hex string. It can only be set on a drive.teamdrives.update request that does not set themeId.
teamDriveId
string
✅
"0AMndV9-YuXjwUk9PVA"
The ID of the Team Drive to update.
restrictions
object
—
A set of restrictions that apply to this Team Drive or items inside this Team Drive.
backgroundImageFile
object
—
An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on drive.teamdrives.update requests that don't set themeId.
useDomainAdminAccess
boolean
—
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.
Googledrive Upload File
Googledrive Upload FileIntegration name: GOOGLEDRIVE_UPLOAD_FILE
Uploads a file (max 5MB) to Google Drive, placing it in the specified folder or root if no valid folder ID is provided. Always creates a new file (never updates existing); use GOOGLEDRIVE_EDIT_FILE to update with a stable file_id. Uploaded files are private by default; configure sharing via GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE.
Parameters
file_to_upload
object
✅
—
File to upload to Google Drive (max 5MB). Must be a dict with fields: name (sanitized filename, no slashes or control characters), mimetype (accurate MIME type, e.g. application/pdf; incorrect values cause Drive to convert or misrender the file), and s3key (path from a previously staged Composio object — not an s3url, not a local path, not a fabricated key). When chaining with TEXT_TO_PDF_CONVERT_TEXT_TO_PDF, pass the returned s3key field, not s3url.
folder_to_upload_to
string
"1duXYCvYC5tIp5B_B1HWLq8LyDYXfMhPU"
Optional ID of the target Google Drive folder; can be obtained using 'Find Folder' or similar actions. Invalid or missing IDs silently fall back to Drive root with no error — resolve the correct folder ID first using GOOGLEDRIVE_FIND_FILE.
Googledrive Upload From Url
Googledrive Upload From UrlIntegration name: GOOGLEDRIVE_UPLOAD_FROM_URL
Tool 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 temporary storage.
Parameters
name
string
✅
"report.pdf"
Name for the file in Google Drive, including extension (e.g., 'report.pdf', 'image.png').
mime_type
string
"application/pdf"
Target MIME type for the file in Google Drive. If not specified, Drive auto-detects from content. Google Workspace MIME types (application/vnd.google-apps.*) trigger automatic conversion from compatible source formats: google-apps.document converts Word/ODT/HTML/RTF/TXT/PDF/images (OCR); google-apps.spreadsheet converts Excel/ODS/CSV/TSV; google-apps.presentation converts PowerPoint/ODP. Conversion requires the source content to be in a compatible format. Incompatible formats will cause upload errors.
source_url
string
✅
"https://example.com/document.pdf"
URL of the file to download and upload to Google Drive. Must be a publicly accessible URL or include necessary authentication in source_headers.
verify_ssl
boolean
—
Whether to verify SSL certificates when downloading from HTTPS URLs. Set to false to bypass SSL verification for URLs with certificate issues (expired certificates, hostname mismatches, self-signed certificates). Only disable for trusted sources.
source_headers
object
{"Authorization":"Bearer token123"}
Optional HTTP headers to include when downloading from source_url. Use for authentication tokens, signed URLs, or CDN-specific headers.
parent_folder_id
string
"1aBcDeFgHiJkLmNoPqRsTuVwXyZ"
ID of the parent folder in Google Drive. If not specified, the file will be uploaded to the root of My Drive.
supports_all_drives
boolean
—
Whether the request supports both My Drives and shared drives. Defaults to true for broader compatibility.
Googledrive Upload Update File
Googledrive Upload Update FileIntegration name: GOOGLEDRIVE_UPLOAD_UPDATE_FILE
Tool to update file content in Google Drive by uploading new binary content. Use when you need to replace the contents of an existing file with new file data.
Parameters
fileId
string
✅
"1iau-j_ezb2Vcx1tZDMDdfpqlzxVzlscg"
The ID of the file to update with new content.
addParents
string
"1A2B3C4D5E6F7G8H9I0J"
Comma-separated list of parent folder IDs to add.
uploadType
string
"media"
The type of upload request. 'media' for simple upload (content only), 'multipart' for metadata + content, 'resumable' for large files.
ocrLanguage
string
"en"
Language hint for OCR processing (ISO 639-1 code, e.g., 'en').
removeParents
string
"1A2B3C4D5E6F7G8H9I0J"
Comma-separated list of parent folder IDs to remove.
file_to_upload
object
✅
—
The file content to upload.
supportsAllDrives
boolean
—
Whether the app supports both My Drives and shared drives. Defaults to true.
keepRevisionForever
boolean
—
Whether to set the 'keepForever' field in the new head revision.
useContentAsIndexableText
boolean
—
Whether to use the uploaded content as indexable text for search.
Googledrive Watch Changes
Googledrive Watch ChangesIntegration name: GOOGLEDRIVE_WATCH_CHANGES
Tool 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. Notifications may be batched rather than per-change; design handlers to be idempotent and fetch all changes since the last known page_token on each notification.
Parameters
id
string
✅
"your-unique-channel-id-123"
A unique string that identifies this channel. UUIDs are recommended. Must be unique per active channel; reusing an ID can cause missed, delayed, or duplicate notifications.
type
string
✅
"web_hook"
The type of delivery mechanism for notifications.
token
string
"optional-arbitrary-string-for-verification"
An arbitrary string that will be delivered with each notification. Can be used for verification.
params
object
—
Optional parameters for the notification channel. Example: {"ttl": "3600"} for a 1-hour time-to-live (actual support depends on Google API).
spaces
string
"drive"
A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
address
string
✅
"https://example.com/notifications"
The URL where notifications are to be delivered. Must be a publicly reachable HTTPS URL with a valid SSL certificate; HTTP, localhost, and private network endpoints are rejected by the API.
drive_id
string
"0ABqLz1XZc1Z9Uk9PVA"
The shared drive from which changes will be returned. If specified, change IDs will be specific to the shared drive.
page_size
integer
—
The maximum number of changes to return per page.
expiration
integer
1678886400000
Timestamp in milliseconds since the epoch for when the channel should expire. If not set, channel may not expire or have a default expiration. Channels are invalidated after expiry; re-establish the watch with a new channel before or after expiration to avoid missed changes.
page_token
string
—
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method. Persist this token per channel so change processing can resume correctly after restarts or interruptions.
include_labels
string
"labelId1,labelId2"
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
include_removed
boolean
—
Whether to include changes indicating that items have been removed from the list of changes (e.g., by deletion or loss of access).
supports_all_drives
boolean
—
Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if driveId is used or if interactions with shared drives are expected.
restrict_to_my_drive
boolean
—
Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files like those in the Application Data folder or shared files not added to My Drive.
include_corpus_removals
boolean
—
Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes.
include_permissions_for_view
string
"published"
Specifies which additional view's permissions to include in the response.
include_items_from_all_drives
boolean
—
Whether both My Drive and shared drive items should be included in results.
Googledrive Watch File
Googledrive Watch FileIntegration name: GOOGLEDRIVE_WATCH_FILE
Tool 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.
Parameters
id
string
✅
"01234567-89ab-cdef-0123456789ab"
A UUID or similar unique string that identifies this notification channel (max 64 characters).
type
string
✅
"web_hook"
The type of delivery mechanism used for this channel.
token
string
"my-secret-token-12345"
An arbitrary string delivered to the target address with each notification for verification (max 256 characters).
fileId
string
✅
"1xAHUNyfubIa8K07EVv9_5Hc5EsgdIhUx-QNcrGJ_yQk"
The ID of the file to watch for changes.
params
object
{"ttl":"3600"}
Additional parameters controlling delivery channel behavior.
address
string
✅
"https://webhook.site/unique-id-here"
The HTTPS address where notifications are delivered for this channel. Must have a valid SSL certificate.
payload
boolean
true
Whether payload data should be included in notifications.
expiration
integer
1678886400000
Date and time of notification channel expiration as Unix timestamp in milliseconds. Default: 3600 seconds, max: 86400 seconds for files.
includeLabels
string
—
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
acknowledgeAbuse
boolean
—
Whether the user is acknowledging the risk of downloading known malware or other abusive files. Only applicable to file owner/organizer.
supportsAllDrives
boolean
—
Whether the requesting application supports both My Drives and shared drives.
supportsTeamDrives
boolean
—
Deprecated. Use supportsAllDrives instead.
includePermissionsForView
string
—
Specifies which additional view's permissions to include in the response.