File Storage
📁 Google Drive integration
Access levels: Read-only · Read + write · Full access · Verified
File Storage
Access levels: Read-only · Read + write · Full access · Verified
Connect Google Drive once and every agent in your squad can work in it for you, with exactly as much access as you decide to give, and a receipt for every call it makes.
You can change an account's access level any time under Manage. It applies instantly, no re-authorization. If the connection ever expires, the card shows Reconnect; one click re-authorizes the same account with the same settings.
Multiple accounts: connect as many as you need (say, yours and a client's). One is primary. Agents use it unless a mission says otherwise.
The level you pick at connect time is enforced on our side for every agent call: an agent can never do more than the level allows, no matter what it's asked.
| Level | What it allows | |
|---|---|---|
| Read-only | Read and download all Drive files. Cannot upload, edit, or delete. | |
| Read + write | Read, upload, and edit files. | Recommended |
| Full access | See, edit, create, and delete any Drive file. |
On top of the connection's level, every agent can be individually allowed, scoped down, or denied for this app from the Integrations page. Deny an agent and it doesn't even see the connection.
The 89 tools agents use in Google Drive through Mission Control, and the lowest access level that includes each. Agents discover these themselves. You never have to name a tool; asking in plain language is enough.
| Tool | What it does | Access level |
|---|---|---|
Add file sharing preferenceGOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE | DEPRECATED: Use GOOGLEDRIVE_CREATE_PERMISSION instead; use GOOGLEDRIVE_UPDATE_PERMISSION to modify existing permissions (avoids duplicate entries). | Read + write, Full access |
Add parentGOOGLEDRIVE_ADD_PARENT | Add a parent folder for a file using Google Drive API v2. | Read + write, Full access |
Add propertyGOOGLEDRIVE_ADD_PROPERTY | Add a property to a file, or update it if it already exists (v2 API). | Read + write, Full access |
Copy fileGOOGLEDRIVE_COPY_FILE | DEPRECATED: Use GOOGLEDRIVE_COPY_FILE_ADVANCED instead. | Read + write, Full access |
Copy file advancedGOOGLEDRIVE_COPY_FILE_ADVANCED | Creates a copy of a file and applies any requested updates with patch semantics. | Read + write, Full access |
Create commentGOOGLEDRIVE_CREATE_COMMENT | Create a comment on a file in Google Drive. | Read + write, Full access |
Create driveGOOGLEDRIVE_CREATE_DRIVE | Create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage. | Read + write, Full access |
Create fileGOOGLEDRIVE_CREATE_FILE | Creates a new file or folder in Google Drive. | Read + write, Full access |
Create file from textGOOGLEDRIVE_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. | Read + write, Full access |
Create folderGOOGLEDRIVE_CREATE_FOLDER | Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. | Read + write, Full access |
Create permissionGOOGLEDRIVE_CREATE_PERMISSION | Create a permission for a file or shared drive. | Read + write, Full access |
Create replyGOOGLEDRIVE_CREATE_REPLY | Create a reply to a comment in Google Drive. | Read + write, Full access |
Create shortcut to fileGOOGLEDRIVE_CREATE_SHORTCUT_TO_FILE | Create a shortcut to a file or folder in Google Drive. | Read + write, Full access |
Create team driveGOOGLEDRIVE_CREATE_TEAM_DRIVE | Create a Team Drive. Deprecated: Use drives.create instead. Use when you need to create a Team Drive for collaboration. | Read + write, Full access |
Delete childGOOGLEDRIVE_DELETE_CHILD | Remove a child from a folder using Google Drive API v2. | Full access |
Delete commentGOOGLEDRIVE_DELETE_COMMENT | Permanently deletes a comment thread (and all its replies) from a Google Drive file, this action is irreversible. | Full access |
Delete driveGOOGLEDRIVE_DELETE_DRIVE | Permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified). | Full access |
Delete fileGOOGLEDRIVE_DELETE_FILE | DEPRECATED: Use GOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION instead. | Full access |
Delete parentGOOGLEDRIVE_DELETE_PARENT | Remove a parent from a file using Google Drive API v2. | Full access |
Delete permissionGOOGLEDRIVE_DELETE_PERMISSION | Deletes a permission from a file by permission ID. | Full access |
Delete propertyGOOGLEDRIVE_DELETE_PROPERTY | Delete a property from a file using Google Drive API v2. | Full access |
Delete replyGOOGLEDRIVE_DELETE_REPLY | 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… | Full access |
Delete revisionGOOGLEDRIVE_DELETE_REVISION | 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. | Full access |
Delete team driveGOOGLEDRIVE_DELETE_TEAM_DRIVE | Permanently delete a Team Drive. Deprecated: Use drives.delete instead. Use when you need to remove a Team Drive using the legacy endpoint. | Full access |
Download fileGOOGLEDRIVE_DOWNLOAD_FILE | Downloads a file from Google Drive by its ID. | Read + write, Full access |
Download file2GOOGLEDRIVE_DOWNLOAD_FILE2 | DEPRECATED: Use GOOGLEDRIVE_DOWNLOAD_FILE_OPERATION instead. | Read + write, Full access |
Download file operationGOOGLEDRIVE_DOWNLOAD_FILE_OPERATION | Download file content using long-running operations. | All levels |
Edit fileGOOGLEDRIVE_EDIT_FILE | Updates an existing Google Drive file with binary content by overwriting its entire content with new text (max 10MB). | Read + write, Full access |
Empty trashGOOGLEDRIVE_EMPTY_TRASH | Permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. | Full access |
Export google workspace fileGOOGLEDRIVE_EXPORT_GOOGLE_WORKSPACE_FILE | Exports a Google Workspace document to the requested MIME type and returns exported file content. | Read + write, Full access |
Find fileGOOGLEDRIVE_FIND_FILE | The comprehensive Google Drive search tool that handles all file and folder discovery needs. | Read + write, Full access |
Find folderGOOGLEDRIVE_FIND_FOLDER | Find a folder in Google Drive by its name and optionally a parent folder. | Read + write, Full access |
Generate idsGOOGLEDRIVE_GENERATE_IDS | Generates a set of file IDs which can be provided in create or copy requests. | Read + write, Full access |
Get aboutGOOGLEDRIVE_GET_ABOUT | Retrieve information about the user, the user's Drive, and system capabilities. | Read + write, Full access |
Get appGOOGLEDRIVE_GET_APP | Get information about a specific Drive app by ID. | Read + write, Full access |
Get changeGOOGLEDRIVE_GET_CHANGE | Get a specific change by ID from Google Drive v2 API. | Read + write, Full access |
Get changes start page tokenGOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKEN | Get the starting pageToken for listing future changes in Google Drive. | Read + write, Full access |
Get childGOOGLEDRIVE_GET_CHILD | Get a specific child reference for a folder using Drive API v2. | Read + write, Full access |
Get commentGOOGLEDRIVE_GET_COMMENT | 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. | Read + write, Full access |
Get driveGOOGLEDRIVE_GET_DRIVE | 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, no… | Read + write, Full access |
Get file metadataGOOGLEDRIVE_GET_FILE_METADATA | 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 G… | Read + write, Full access |
Get file propertyGOOGLEDRIVE_GET_FILE_PROPERTY | Get a property by its key using Google Drive API v2. | Read + write, Full access |
Get file v2GOOGLEDRIVE_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. | Read + write, Full access |
Get parentGOOGLEDRIVE_GET_PARENT | Get a specific parent reference for a file using Drive API v2. | Read + write, Full access |
Get permissionGOOGLEDRIVE_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. | Read + write, Full access |
Get permission id for emailGOOGLEDRIVE_GET_PERMISSION_ID_FOR_EMAIL | Get the permission ID for an email address using the Drive API v2. | Read + write, Full access |
Get replyGOOGLEDRIVE_GET_REPLY | Get a specific reply to a comment on a file. | Read + write, Full access |
Get revisionGOOGLEDRIVE_GET_REVISION | Get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID. | Read + write, Full access |
Get team driveGOOGLEDRIVE_GET_TEAM_DRIVE | Get metadata about a Team Drive by ID. Deprecated: Use the drives.get endpoint instead. | Read + write, Full access |
Google drive delete folder or file actionGOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTION | 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 subf… | Full access |
Hide driveGOOGLEDRIVE_HIDE_DRIVE | Hide a shared drive from the default view. | Read + write, Full access |
Insert childGOOGLEDRIVE_INSERT_CHILD | Insert a file into a folder using Drive API v2. | Read + write, Full access |
List access proposalsGOOGLEDRIVE_LIST_ACCESS_PROPOSALS | 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. | Read + write, Full access |
List approvalsGOOGLEDRIVE_LIST_APPROVALS | List approvals on a file for workflow-based access control. | Read + write, Full access |
List changesGOOGLEDRIVE_LIST_CHANGES | List the changes for a user or shared drive. | Read + write, Full access |
List children v2GOOGLEDRIVE_LIST_CHILDREN_V2 | List a folder's children using Google Drive API v2. | Read + write, Full access |
List commentsGOOGLEDRIVE_LIST_COMMENTS | List all comments for a file in Google Drive. | Read + write, Full access |
List filesGOOGLEDRIVE_LIST_FILES | DEPRECATED: Use GOOGLEDRIVE_FIND_FILE instead. | Read + write, Full access |
List file labelsGOOGLEDRIVE_LIST_FILE_LABELS | List the labels already applied to a file in Google Drive. | Read + write, Full access |
List file propertiesGOOGLEDRIVE_LIST_FILE_PROPERTIES | List a file's properties in Google Drive API v2. | Read + write, Full access |
List permissionsGOOGLEDRIVE_LIST_PERMISSIONS | List a file's permissions. Use when you need to retrieve all permissions associated with a specific file or shared drive. | Read + write, Full access |
List repliesGOOGLEDRIVE_LIST_REPLIES | List replies to a comment in Google Drive. | Read + write, Full access |
List revisionsGOOGLEDRIVE_LIST_REVISIONS | List a file's revision metadata (not content) in Google Drive. | Read + write, Full access |
List shared drivesGOOGLEDRIVE_LIST_SHARED_DRIVES | 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 acce… | Read + write, Full access |
List team drivesGOOGLEDRIVE_LIST_TEAM_DRIVES | List Team Drives (deprecated, use List Shared Drives instead). | Read + write, Full access |
Modify file labelsGOOGLEDRIVE_MODIFY_FILE_LABELS | Modifies the set of labels applied to a file. | Read + write, Full access |
Move fileGOOGLEDRIVE_MOVE_FILE | Move a file from one folder to another in Google Drive. | Read + write, Full access |
Parse fileGOOGLEDRIVE_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. | Read + write, Full access |
Patch permissionGOOGLEDRIVE_PATCH_PERMISSION | Update a permission using patch semantics. | Read + write, Full access |
Patch propertyGOOGLEDRIVE_PATCH_PROPERTY | Update a property on a file using PATCH semantics (v2 API). | Read + write, Full access |
Resumable uploadGOOGLEDRIVE_RESUMABLE_UPLOAD | Start and complete a Google Drive resumable upload session. | Read + write, Full access |
Stop watch channelGOOGLEDRIVE_STOP_WATCH_CHANNEL | Stop watching resources through a specified channel. | Full access |
Trash fileGOOGLEDRIVE_TRASH_FILE | Move a file or folder to trash (soft delete). | Read + write, Full access |
Unhide driveGOOGLEDRIVE_UNHIDE_DRIVE | Unhide a shared drive. Use when you need to restore a shared drive to the default view. | Read + write, Full access |
Untrash fileGOOGLEDRIVE_UNTRASH_FILE | 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 impossi… | Read + write, Full access |
Update commentGOOGLEDRIVE_UPDATE_COMMENT | Update an existing comment on a Google Drive file. | Read + write, Full access |
Update driveGOOGLEDRIVE_UPDATE_DRIVE | 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. | Read + write, Full access |
Update file metadata patchGOOGLEDRIVE_UPDATE_FILE_METADATA_PATCH | Update file metadata using the Drive API v2 PATCH method. | Read + write, Full access |
Update file propertyGOOGLEDRIVE_UPDATE_FILE_PROPERTY | Update a property on a file using Google Drive API v2. | Read + write, Full access |
Update file putGOOGLEDRIVE_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… | Read + write, Full access |
Update file revision metadataGOOGLEDRIVE_UPDATE_FILE_REVISION_METADATA | Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). | Read + write, Full access |
Update permissionGOOGLEDRIVE_UPDATE_PERMISSION | 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_L… | Read + write, Full access |
Update replyGOOGLEDRIVE_UPDATE_REPLY | Update a reply to a comment on a Google Drive file. | Read + write, Full access |
Update team driveGOOGLEDRIVE_UPDATE_TEAM_DRIVE | Update a Team Drive's metadata. Deprecated: Use the drives.update endpoint instead. Use when you need to modify Team Drive properties. | Read + write, Full access |
Upload fileGOOGLEDRIVE_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. | Read + write, Full access |
Upload from urlGOOGLEDRIVE_UPLOAD_FROM_URL | Fetch a file from a provided URL server-side and upload it into Google Drive. | Read + write, Full access |
Upload update fileGOOGLEDRIVE_UPLOAD_UPDATE_FILE | Update file content in Google Drive by uploading new binary content. | Read + write, Full access |
Watch changesGOOGLEDRIVE_WATCH_CHANGES | Subscribe to changes for a user or shared drive in Google Drive. | Read + write, Full access |
Watch fileGOOGLEDRIVE_WATCH_FILE | Subscribe to push notifications for changes to a specific file. | Read + write, Full access |
Just ask in plain language: “check Google Drive for …”, “create … in Google Drive”, “every Monday, … ”, and the agent finds the right tool, runs it, and reports back with a receipt in your Runs ledger. Anything outward-facing (sending, posting, publishing) that a mission didn't clearly authorize comes back to you as a ticket first.
| Agent says | What's happening | Fix |
|---|---|---|
| "Google Drive isn't connected" | No active connection (or this agent is denied) | Connect on the Integrations page; check the agent's per-app policy |
| "The connection has expired" | Google Drive ended the authorization (they all do periodically) | Click Reconnect on the account, same settings, one click |
| "I'm not allowed to do that" | The action is above the account's access level, or the agent is scoped down | Raise the level under Manage, or adjust that agent's policy |
| It did something unexpected | The ask was ambiguous (e.g. matched an existing item) | Be explicit, "create a NEW …", and give agents a working folder where relevant |