Google Drive
Arcade.dev LLM tools for Google Drive
Arcade.dev provides a toolkit for integrating with Google Drive, enabling seamless file management and user authentication. This toolkit allows developers to efficiently manage and interact with files and folders in Google Drive through a variety of LLM tools that streamline operations.
Capabilities
- Create, move, rename, and manage files and folders in Google Drive.
- Upload, download, and share files securely with granular permissions.
- Search for files and retrieve the complete file tree structure.
- Generate a Google File Picker URL for user-driven file selection.
OAuth Provider: Google Scopes: https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile
Available tools(11)
| Tool name | Description | Secrets | |
|---|---|---|---|
Create a new folder in Google Drive.
By default, parent folder paths are resolved in My Drive. For shared drives, use folder IDs
or provide shared_drive_id. | |||
Download a blob file (non-workspace file) from Google Drive as base64 encoded content.
For small files (under ~5MB raw), returns the file content directly in the response as base64.
For large files, returns metadata with requires_chunked_download=True - use download_file_chunk
to retrieve the file in parts.
By default, paths are resolved in My Drive. For shared drives, use file IDs or provide
shared_drive_id. | |||
Download a specific byte range of a file from Google Drive.
Use this for large files that require chunked download (when download_file returns
requires_chunked_download=True). Call repeatedly with increasing start_byte values
to retrieve the complete file.
Returns the chunk content as base64, along with progress information including
whether this is the final chunk. | |||
Generate a Google File Picker URL for user-driven file selection and authorization.
This tool generates a URL that directs the end-user to a Google File Picker interface where
where they can select or upload Google Drive files. Users can grant permission to access their
Drive files, providing a secure and authorized way to interact with their files.
This is particularly useful when prior tools (e.g., those accessing or modifying
Google Docs, Google Sheets, etc.) encountered failures due to file non-existence
(Requested entity was not found) or permission errors. Once the user completes the file
picker flow, the prior tool can be retried.
Suggest this tool to users when they are surprised or confused that the file they are
searching for or attempting to access cannot be found. | |||
Get the file/folder tree structure of the user's entire Google Drive.
Very inefficient for large drives. Use with caution. | |||
Move a file or folder to a different folder within the same Google Drive.
Can move to a folder (keeping name), or move and rename in one operation. By default, paths
are resolved in My Drive. For shared drives, use file IDs or provide shared_drive_id. | |||
Rename a file or folder in Google Drive.
By default, paths are resolved in My Drive. For files in shared drives, either use the file ID
directly or provide the shared_drive_id parameter. | |||
Search for files in Google Drive.
The provided 'query' should only contain the search terms.
The tool will construct the full search query for you. | |||
Share a file or folder in Google Drive with specific people by granting them permissions.
If a user already has permission on the file, their role will be updated to the new role.
By default, paths are resolved in My Drive. For shared drives, use file IDs or provide
shared_drive_id. | |||
Upload a file to Google Drive from a URL.
Fetches the file content from the provided URL and uploads it to Google Drive.
Supports files of any size - uses resumable upload internally for large files.
CANNOT upload Google Workspace files (Google Docs, Sheets, Slides)
CANNOT upload files larger than 25MB | |||
Get comprehensive user profile and Google Drive environment information.
This tool provides detailed information about the authenticated user including
their name, email, profile picture, Google Drive storage information, the shared
drives (and their IDs) the user has access to, and other
important profile details from Google services. |
Selected tools
No tools selected.
Click "Show all tools" to add tools.
Requirements
Select tools to see requirements
GoogleDrive.CreateFolder
Create a new folder in Google Drive. By default, parent folder paths are resolved in My Drive. For shared drives, use folder IDs or provide shared_drive_id.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
folder_name | string | Required | The name of the new folder to create |
parent_folder_path_or_id | string | Optional | The parent folder path like folder/subfolder or folder ID where to create. If None, creates at the root of My Drive. If providing a path, it will be resolved within My Drive by default. Do not include the folder to create in this path. Defaults to None. |
shared_drive_id | string | Optional | If creating in a shared drive and using a parent folder path, provide the shared drive ID. Not needed when using folder IDs or creating in My Drive. Defaults to None. |
Requirements
Output
json— Created folder information including ID, name, web view link, and location pathGoogleDrive.DownloadFile
Download a blob file (non-workspace file) from Google Drive as base64 encoded content. For small files (under ~5MB raw), returns the file content directly in the response as base64. For large files, returns metadata with requires_chunked_download=True - use download_file_chunk to retrieve the file in parts. By default, paths are resolved in My Drive. For shared drives, use file IDs or provide shared_drive_id.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
file_path_or_id | string | Required | The file path like folder/subfolder/filename or the file ID of the file to download Folders NOT supported. If providing a path, it will be resolved within 'My Drive' by default. |
shared_drive_id | string | Optional | If the file is in a shared drive and using a path, provide the shared drive ID. Not needed when using file IDs. Defaults to None (uses 'My Drive'). |
Requirements
Output
json— For small files (<5MB): file content (base64 encoded) and metadata. For large files: metadata with requires_chunked_download=True and instructions.GoogleDrive.DownloadFileChunk
Download a specific byte range of a file from Google Drive. Use this for large files that require chunked download (when download_file returns requires_chunked_download=True). Call repeatedly with increasing start_byte values to retrieve the complete file. Returns the chunk content as base64, along with progress information including whether this is the final chunk.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
file_path_or_id | string | Required | The file path like folder/subfolder/filename or the file ID to download a chunk from. If providing a path, it will be resolved within 'My Drive' by default. |
start_byte | integer | Required | The starting byte position for this chunk (0-indexed). |
chunk_size | integer | Optional | The size of the chunk to download in bytes. Max 5MB (5242880). Defaults to 5MB (5242880). |
shared_drive_id | string | Optional | If the file is in a shared drive and using a path, provide the shared drive ID. Not needed when using file IDs. Defaults to None (uses 'My Drive'). |
Requirements
Output
json— Chunk content (base64 encoded), byte range info, and progress detailsGoogleDrive.GenerateGoogleFilePickerUrl
Generate a Google File Picker URL for user-driven file selection and authorization. This tool generates a URL that directs the end-user to a Google File Picker interface where where they can select or upload Google Drive files. Users can grant permission to access their Drive files, providing a secure and authorized way to interact with their files. This is particularly useful when prior tools (e.g., those accessing or modifying Google Docs, Google Sheets, etc.) encountered failures due to file non-existence (Requested entity was not found) or permission errors. Once the user completes the file picker flow, the prior tool can be retried. Suggest this tool to users when they are surprised or confused that the file they are searching for or attempting to access cannot be found.
Parameters
No parameters required.
Requirements
Output
json— Google File Picker URL for user file selection and permission grantingGoogleDrive.GetFileTreeStructure
Get the file/folder tree structure of the user's entire Google Drive. Very inefficient for large drives. Use with caution.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
include_shared_drives | boolean | Optional | Whether to include shared drives in the file tree structure. Defaults to False. |
restrict_to_shared_drive_id | string | Optional | If provided, only include files from this shared drive in the file tree structure. Defaults to None, which will include files and folders from all drives. |
include_organization_domain_documents | boolean | Optional | Whether to include documents from the organization's domain. This is applicable to admin users who have permissions to view organization-wide documents in a Google Workspace account. Defaults to False. |
order_by | array<string> | Optional | Sort order. Defaults to listing the most recently modified documents firstcreatedTimecreatedTime descfolderfolder descmodifiedByMeTimemodifiedByMeTime descmodifiedTimemodifiedTime descnamename descname_naturalname_natural descquotaBytesUsedquotaBytesUsed descrecencyrecency descsharedWithMeTimesharedWithMeTime descstarredstarred descviewedByMeTimeviewedByMeTime desc |
limit | integer | Optional | The number of files and folders to list. Defaults to None, which will list all files and folders. |
Requirements
Output
json— A dictionary containing the file/folder tree structure in the user's Google DriveGoogleDrive.MoveFile
Move a file or folder to a different folder within the same Google Drive. Can move to a folder (keeping name), or move and rename in one operation. By default, paths are resolved in My Drive. For shared drives, use file IDs or provide shared_drive_id.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
source_file_path_or_id | string | Required | The source file path like folder/subfolder/filename or the file ID of the file to move. If providing a path, it will be resolved within 'My Drive' by default. |
destination_folder_path_or_id | string | Optional | The path to the file's parent folder (exclude the file to be moved) or parent folder ID to move the file into. If None, moves to the root of the drive. Defaults to None. |
new_filename | string | Optional | Optional new name for the file after moving. If None, keeps the original name. Defaults to None. |
shared_drive_id | string | Optional | If working with paths in a shared drive, provide the shared drive ID. Not needed when using IDs. Defaults to None (uses My Drive). |
Requirements
Output
json— Confirmation with the file's ID, name, and new locationGoogleDrive.RenameFile
Rename a file or folder in Google Drive. By default, paths are resolved in My Drive. For files in shared drives, either use the file ID directly or provide the shared_drive_id parameter.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
file_path_or_id | string | Required | The path like folder/subfolder/filename or the file ID to rename. If providing a path, it will be resolved within 'My Drive' by default. |
new_filename | string | Required | The new name for the file |
shared_drive_id | string | Optional | If the file is in a shared drive and you're using a path (not ID), provide the shared drive ID to resolve the path within that drive. Not needed when using file IDs. Defaults to None (searches 'My Drive'). |
Requirements
Output
json— Confirmation with the file's new name, ID, and web view linkGoogleDrive.SearchFiles
Search for files in Google Drive. The provided 'query' should only contain the search terms. The tool will construct the full search query for you.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
query | string | Required | The exact search query to send to the Google Drive API to find files in Google Drive. The tool will construct the query for you. Will search for filenames and file contents that match the provided query. |
folder_path_or_id | string | Optional | Search only within this specific folder. Provide either a path like folder/subfolder or a folder ID. If None, searches across all accessible locations. Defaults to None. |
shared_drive_id | string | Optional | If provided, search only within this shared drive. Defaults to None (searches My Drive and optionally all shared drives). |
include_shared_drives | boolean | Optional | If True and shared_drive_id is not set, include all shared drives in search. Defaults to False (My Drive only). |
include_organization_domain_documents | boolean | Optional | Whether to include documents from the organization's domain. This is applicable to admin users who have permissions to view organization-wide documents in a Google Workspace account. Defaults to False. |
order_by | array<string> | Optional | Sort order for search results. Defaults to listing the most recently modified documents first. If the query contains 'fullText', then the order_by will be ignored.createdTimecreatedTime descfolderfolder descmodifiedByMeTimemodifiedByMeTime descmodifiedTimemodifiedTime descnamename descname_naturalname_natural descquotaBytesUsedquotaBytesUsed descrecencyrecency descsharedWithMeTimesharedWithMeTime descstarredstarred descviewedByMeTimeviewedByMeTime desc |
limit | integer | Optional | The maximum number of search results to return. Defaults to 50. |
file_types | array<string> | Optional | Filter by specific file types. Defaults to None, which includes all file types.spreadsheetslidesdocumentdrawingformfolderimagevideoaudioscriptsitespdf |
Requirements
Output
json— Search results containing matching files from Google Drive with metadata and file informationGoogleDrive.UploadFile
Upload a file to Google Drive from a URL. Fetches the file content from the provided URL and uploads it to Google Drive. Supports files of any size - uses resumable upload internally for large files. CANNOT upload Google Workspace files (Google Docs, Sheets, Slides) CANNOT upload files larger than 25MB
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
file_name | string | Required | The name for the uploaded file |
source_url | string | Required | The public download URL to fetch the file content from. The tool will download from this URL and upload to Google Drive |
mime_type | string | Optional | The file type. If not provided, will be inferred from the URL or Content-Type header. Supported: text (txt, csv, json, html, md), pdf, images (png, jpeg, gif). Defaults to None (auto-detect).text/plaintext/csvapplication/jsontext/htmltext/markdownapplication/pdfimage/pngimage/jpegimage/gifimage/webpimage/svg+xml |
destination_folder_path_or_id | string | Optional | The folder path like folder/subfolder or folder ID where to upload. If None, uploads to the root of 'My Drive'. If providing a path, it will be resolved within 'My Drive' by default. Defaults to None. |
shared_drive_id | string | Optional | If uploading to a folder in a shared drive using a path, provide the shared drive ID. Not needed when using folder IDs or uploading to My Drive. Defaults to None ('My Drive') |
Requirements
Output
json— Uploaded file information including ID, name, web view link, and locationGoogleDrive.WhoAmI
Get comprehensive user profile and Google Drive environment information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Google Drive storage information, the shared drives (and their IDs) the user has access to, and other important profile details from Google services.
Parameters
No parameters required.
Requirements
Output
json— Get comprehensive user profile and Google Drive environment information.