Google Drive
Google Drive connector to search, read, and manage files and folders.
Tools
Ask an agent for what you need in plain language — it picks the right tool itself. You can also limit which of these an agent may use, and require your approval before any of them runs.
Search Google Drive for files and folders by name, content, folder, or type.
| Parameter | Type | Description |
|---|---|---|
| query | string | Text to match against file names and full-text content. |
| parentFolderId | string | Restrict results to direct children of this folder ID. |
| mimeType | string | Restrict results to a specific MIME type (e.g. "application/vnd.google-apps.folder"). |
| pageSize | integer | — |
Read the text content of a Google Drive file. Google Docs, Sheets, and Slides are exported to text. Binary files should be saved with downloadFile instead.
| Parameter | Type | Description |
|---|---|---|
| fileIdrequired | string | The Drive file ID to read. |
Download a Google Drive file into agent file storage.
| Parameter | Type | Description |
|---|---|---|
| fileIdrequired | string | The Drive file ID to download. |
| destinationPath | string | Destination path in agent storage (e.g. "/google-drive/report.pdf"). Defaults to "/google-drive/<file name>". Google Workspace files get an exported extension. |
Upload a file from agent storage to Google Drive.
| Parameter | Type | Description |
|---|---|---|
| filePathrequired | string | Absolute path to the file in agent storage (e.g. "/drive/report.pdf"). |
| name | string | Name for the uploaded file in Drive. Defaults to the source file name. |
| parentFolderId | string | ID of the Drive folder to upload into. Defaults to the root. |
Create a new folder in Google Drive.
| Parameter | Type | Description |
|---|---|---|
| namerequired | string | Name of the new folder. |
| parentFolderId | string | ID of the parent folder. Defaults to the root. |
Move a Google Drive file to another folder and/or rename it.
| Parameter | Type | Description |
|---|---|---|
| fileIdrequired | string | The Drive file ID to move or rename. |
| addParentFolderId | string | Folder ID to move the file into. |
| removeParentFolderId | string | Current parent folder ID to remove the file from. |
| name | string | New name for the file (rename). |
Triggers
Triggers start an agent automatically when something happens in the connected account. See triggers and schedules.
New File in Folder
googleDriveNewFileTriggers when a new file is added to a Google Drive folder.
Filters
| Parameter | Type | Description |
|---|---|---|
| folderIdrequired | string | — |
| folderName | string | — |
| namePattern | string | — |
| mimeType | string | — |
Permissions
You choose what to grant on the provider's consent screen. A tool is only available to your agents if you granted the permission it needs, so granting less simply means fewer tools.
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/drive.readonly