Skip to Content
ResourcesIntegrationsProductivity & DocsGoogle Drive

Google Drive

Service domainCLOUD STORAGE
Google Drive icon
Arcade Optimized

Arcade.dev LLM tools for Google Drive

Author:Arcade
Version:5.3.0
Auth:User authorization via the Google auth provider
15tools

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(15)

15 of 15 tools
Operations
Behavior
Tool nameDescriptionSecrets
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.
List permissions on a Google Drive file or folder. Returns the individual people (and groups) with access and the current General access (link sharing) state. `general_access` is computed across the ENTIRE file regardless of filtering -- so "is this doc public?" is always answered authoritatively. When `roles` is provided, `people` and `total_people` reflect only collaborators whose role matches the filter. Truncated collaborators beyond `limit` are not returned; `has_more` indicates whether truncation occurred.
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.
Remove all user collaborators (and optionally groups) from a Google Drive file. The file owner and the calling user are always preserved. Groups are preserved by default because the Drive API cannot verify group membership -- pass include_groups=True to opt in. Inherited shared-drive permissions are never removable from the file level and are skipped. Use except_people to preserve additional people or groups by email or name. Ambiguous or unmatched except_people entries raise an error to avoid accidentally removing someone the caller meant to keep.
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.
Revoke access for specific people or groups on a Google Drive file. Identifies matches by email (exact, case-insensitive) or display name. When an input matches multiple people, the clear matches are still revoked and the ambiguous input is surfaced in the `ambiguous` response field with candidate details so the agent can re-prompt the user for just the uncertain ones. Inputs that don't match any collaborator are returned in `not_found`. Pending-owner matches (mid-ownership-transfer) are skipped and surfaced in `skipped_pending_owner` so the clean revokes in the batch still land. Owner permissions cannot be revoked -- transfer ownership first. When a grantee has both a direct and an inherited permission (e.g., shared-drive member also granted directly on the file), revoking the direct row leaves the inherited access intact. The inherited row is surfaced in `skipped_inherited` so callers don't assume the grantee is fully removed -- inherited access must be adjusted at the shared drive level.
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.
Change the 'General access' (link sharing) setting on a Google Drive file. Idempotent: calling with the same state as the current configuration is a no-op. When access is 'domain', the link is scoped to the caller's email domain -- NOT the file owner's domain. For cross-org collaboration (e.g., editing a file owned by another organization), confirm with the user which domain they intend before calling. Google will reject domain sharing for personal accounts (gmail.com, outlook.com, etc.) -- the tool translates that rejection into a friendly error. The response's `access` and `role` fields report the EFFECTIVE state after the transition, not the requested state. For files on shared drives, inherited link permissions cannot be changed from the file level -- if the request would have required removing an inherited permission, the effective state will reflect the inherited permission that remained. When `skipped_inherited` is non-empty, inspect it to understand why effective state may differ from what was requested.
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

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
Cloud storage
MCP behavior
No

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

No

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

ParameterTypeReq.Description
folder_namestringRequiredThe name of the new folder to create
parent_folder_path_or_idstringOptionalThe 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_idstringOptionalIf 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

No secrets required

Output

Type:jsonCreated folder information including ID, name, web view link, and location path
#

GoogleDrive.DownloadFile

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Cloud storage
MCP behavior
Yes

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

ParameterTypeReq.Description
file_path_or_idstringRequiredThe 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_idstringOptionalIf 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

No secrets required

Output

Type:jsonFor small files (<5MB): file content (base64 encoded) and metadata. For large files: metadata with requires_chunked_download=True and instructions.
#

GoogleDrive.DownloadFileChunk

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Cloud storage
MCP behavior
Yes

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

ParameterTypeReq.Description
file_path_or_idstringRequiredThe 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_byteintegerRequiredThe starting byte position for this chunk (0-indexed).
chunk_sizeintegerOptionalThe size of the chunk to download in bytes. Max 5MB (5242880). Defaults to 5MB (5242880).
shared_drive_idstringOptionalIf 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

No secrets required

Output

Type:jsonChunk content (base64 encoded), byte range info, and progress details
#

GoogleDrive.GenerateGoogleFilePickerUrl

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Cloud storage
MCP behavior
Yes

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

No secrets required

Output

Type:jsonGoogle File Picker URL for user file selection and permission granting
#

GoogleDrive.GetFileTreeStructure

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Cloud storage
MCP behavior
Yes

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

Get the file/folder tree structure of the user's entire Google Drive. Very inefficient for large drives. Use with caution.

Parameters

ParameterTypeReq.Description
include_shared_drivesbooleanOptionalWhether to include shared drives in the file tree structure. Defaults to False.
restrict_to_shared_drive_idstringOptionalIf 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_documentsbooleanOptionalWhether 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_byarray<string>OptionalSort order. Defaults to listing the most recently modified documents first
createdTimecreatedTime descfolderfolder descmodifiedByMeTimemodifiedByMeTime descmodifiedTimemodifiedTime descnamename descname_naturalname_natural descquotaBytesUsedquotaBytesUsed descrecencyrecency descsharedWithMeTimesharedWithMeTime descstarredstarred descviewedByMeTimeviewedByMeTime desc
limitintegerOptionalThe number of files and folders to list. Defaults to None, which will list all files and folders.

Requirements

No secrets required

Output

Type:jsonA dictionary containing the file/folder tree structure in the user's Google Drive
#

GoogleDrive.ListFilePermissions

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Cloud storage
MCP behavior
Yes

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

List permissions on a Google Drive file or folder. Returns the individual people (and groups) with access and the current General access (link sharing) state. `general_access` is computed across the ENTIRE file regardless of filtering -- so "is this doc public?" is always answered authoritatively. When `roles` is provided, `people` and `total_people` reflect only collaborators whose role matches the filter. Truncated collaborators beyond `limit` are not returned; `has_more` indicates whether truncation occurred.

Parameters

ParameterTypeReq.Description
file_path_or_idstringRequiredThe file path like folder/subfolder/filename or the file ID to inspect. If providing a path, it will be resolved within My Drive by default.
limitintegerOptionalMaximum number of user/group collaborators to include in the `people` list (1-500). Regardless of this cap, `general_access` reflects the entire file. Defaults to 100.
rolesarray<string>OptionalFilter the `people` list to those holding one of these roles. For 'who can write?' pass [owner, writer]; for 'who can comment?' pass [owner, writer, commenter]. When provided, `total_people` reflects the count MATCHING the filter (not the whole ACL). Defaults to None (no filter).
readercommenterwriterowner
shared_drive_idstringOptionalIf 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

No secrets required

Output

Type:jsonFile permissions including per-person grants and the current General access (link) state

No code example available for this tool.

#

GoogleDrive.MoveFile

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
Cloud storage
MCP behavior
No

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

ParameterTypeReq.Description
source_file_path_or_idstringRequiredThe 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_idstringOptionalThe 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_filenamestringOptionalOptional new name for the file after moving. If None, keeps the original name. Defaults to None.
shared_drive_idstringOptionalIf working with paths in a shared drive, provide the shared drive ID. Not needed when using IDs. Defaults to None (uses My Drive).

Requirements

No secrets required

Output

Type:jsonConfirmation with the file's ID, name, and new location
#

GoogleDrive.RemoveAllCollaborators

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Delete
Service domains
Cloud storage
MCP behavior
No

Reads data without modifying any state in the target system.

Yes

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

Remove all user collaborators (and optionally groups) from a Google Drive file. The file owner and the calling user are always preserved. Groups are preserved by default because the Drive API cannot verify group membership -- pass include_groups=True to opt in. Inherited shared-drive permissions are never removable from the file level and are skipped. Use except_people to preserve additional people or groups by email or name. Ambiguous or unmatched except_people entries raise an error to avoid accidentally removing someone the caller meant to keep.

Parameters

ParameterTypeReq.Description
file_path_or_idstringRequiredThe file path like folder/subfolder/filename or the file ID. If providing a path, it will be resolved within My Drive by default.
except_peoplearray<string>OptionalEmails or names of people (or groups) to preserve. The file owner and the caller are always preserved automatically. Defaults to None (remove everyone else).
include_groupsbooleanOptionalWhether to also remove group permissions. Defaults to False because the Drive API does not expose group membership -- the tool cannot verify the caller isn't a member of a group it's about to delete, so removing a group can lock the caller out even though the tool preserves their personal email. Opt in with True when you have independently confirmed group-removal is safe.
shared_drive_idstringOptionalIf 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

No secrets required

Output

Type:jsonSummary of removed and preserved permissions

No code example available for this tool.

#

GoogleDrive.RenameFile

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
Cloud storage
MCP behavior
No

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

ParameterTypeReq.Description
file_path_or_idstringRequiredThe 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_filenamestringRequiredThe new name for the file
shared_drive_idstringOptionalIf 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

No secrets required

Output

Type:jsonConfirmation with the file's new name, ID, and web view link
#

GoogleDrive.RevokeFileAccess

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Delete
Service domains
Cloud storage
MCP behavior
No

Reads data without modifying any state in the target system.

Yes

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

Revoke access for specific people or groups on a Google Drive file. Identifies matches by email (exact, case-insensitive) or display name. When an input matches multiple people, the clear matches are still revoked and the ambiguous input is surfaced in the `ambiguous` response field with candidate details so the agent can re-prompt the user for just the uncertain ones. Inputs that don't match any collaborator are returned in `not_found`. Pending-owner matches (mid-ownership-transfer) are skipped and surfaced in `skipped_pending_owner` so the clean revokes in the batch still land. Owner permissions cannot be revoked -- transfer ownership first. When a grantee has both a direct and an inherited permission (e.g., shared-drive member also granted directly on the file), revoking the direct row leaves the inherited access intact. The inherited row is surfaced in `skipped_inherited` so callers don't assume the grantee is fully removed -- inherited access must be adjusted at the shared drive level.

Parameters

ParameterTypeReq.Description
file_path_or_idstringRequiredThe file path like folder/subfolder/filename or the file ID. If providing a path, it will be resolved within My Drive by default.
peoplearray<string>RequiredEmails or names of people (or groups) to remove access from. Emails match exactly; names use case-insensitive matching on display name, then first/last name token.
shared_drive_idstringOptionalIf 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

No secrets required

Output

Type:jsonSummary of revoked permissions, including any inputs that could not be matched

No code example available for this tool.

#

GoogleDrive.SearchFiles

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Cloud storage
MCP behavior
Yes

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

ParameterTypeReq.Description
querystringRequiredThe 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_idstringOptionalSearch 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_idstringOptionalIf provided, search only within this shared drive. Defaults to None (searches My Drive and optionally all shared drives).
include_shared_drivesbooleanOptionalIf True and shared_drive_id is not set, include all shared drives in search. Defaults to False (My Drive only).
include_organization_domain_documentsbooleanOptionalWhether 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_byarray<string>OptionalSort 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
limitintegerOptionalThe maximum number of search results to return. Defaults to 50.
file_typesarray<string>OptionalFilter by specific file types. Defaults to None, which includes all file types.
spreadsheetslidesdocumentdrawingformfolderimagevideoaudioscriptsitespdf

Requirements

No secrets required

Output

Type:jsonSearch results containing matching files from Google Drive with metadata and file information
#

GoogleDrive.SetGeneralAccess

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
Cloud storage
MCP behavior
No

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

Change the 'General access' (link sharing) setting on a Google Drive file. Idempotent: calling with the same state as the current configuration is a no-op. When access is 'domain', the link is scoped to the caller's email domain -- NOT the file owner's domain. For cross-org collaboration (e.g., editing a file owned by another organization), confirm with the user which domain they intend before calling. Google will reject domain sharing for personal accounts (gmail.com, outlook.com, etc.) -- the tool translates that rejection into a friendly error. The response's `access` and `role` fields report the EFFECTIVE state after the transition, not the requested state. For files on shared drives, inherited link permissions cannot be changed from the file level -- if the request would have required removing an inherited permission, the effective state will reflect the inherited permission that remained. When `skipped_inherited` is non-empty, inspect it to understand why effective state may differ from what was requested.

Parameters

ParameterTypeReq.Description
file_path_or_idstringRequiredThe file path like folder/subfolder/filename or the file ID. If providing a path, it will be resolved within My Drive by default.
accessstringOptionalThe new General access setting. 'restricted' removes link sharing, 'domain' shares with the caller's Google Workspace domain, 'anyone' makes it public with the link. Defaults to 'restricted'.
restricteddomainanyone
rolestringOptionalThe role granted via the link when access is 'domain' or 'anyone'. Ignored when access is 'restricted'. Defaults to reader (view-only). Constrained to reader/commenter/writer -- Drive rejects owner and organizer roles on link permissions.
readercommenterwriter
allow_discoverybooleanOptionalWhether the file should be discoverable through search. Only meaningful when access is 'domain' or 'anyone'. Defaults to False.
shared_drive_idstringOptionalIf 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

No secrets required

Output

Type:jsonNew General access state, including previous state for reference

No code example available for this tool.

#

GoogleDrive.ShareFile

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
Cloud storage
MCP behavior
No

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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.

Parameters

ParameterTypeReq.Description
file_path_or_idstringRequiredThe file path like folder/subfolder/filename or the file ID to share. If providing a path, it will be resolved within My Drive by default.
email_addressesarray<string>RequiredList of email addresses like user@domain.com to share with
rolestringOptionalThe permission role to grant. Defaults to reader (view-only).
readercommenterwriterowner
send_notification_emailbooleanOptionalWhether to send an email notification to the recipients. Defaults to True.
messagestringOptionalOptional message to include in the notification email. Defaults to None.
shared_drive_idstringOptionalIf 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

No secrets required

Output

Type:jsonSharing confirmation with list of granted permissions including recipient emails and roles
#

GoogleDrive.UploadFile

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
Cloud storage
MCP behavior
No

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

No

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

ParameterTypeReq.Description
file_namestringRequiredThe name for the uploaded file
source_urlstringRequiredThe public download URL to fetch the file content from. The tool will download from this URL and upload to Google Drive
mime_typestringOptionalThe 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_idstringOptionalThe 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_idstringOptionalIf 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

No secrets required

Output

Type:jsonUploaded file information including ID, name, web view link, and location
#

GoogleDrive.WhoAmI

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Cloud storage
MCP behavior
Yes

Reads data without modifying any state in the target system.

No

May permanently delete or overwrite data in the target system.

Yes

Repeated calls with the same inputs produce no additional effect.

Yes

Communicates with external APIs, databases, or other services.

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

No secrets required

Output

Type:jsonGet comprehensive user profile and Google Drive environment information.
Last updated on