← Back to all apps

Google Drive

Productivityby Google
Open in ChatGPTOpen in ClaudeWebsite
Launched Mar 18, 2026 on Claude

Connect Google Drive to Claude to search through your documents, read file contents, upload new files, and analyze your data. Claude can find specific documents even when you don't remember the exact name, read and analyze the content of Google Docs, Sheets, Slides, and PDFs, and upload files directly to your Drive. Useful for finding project notes, extracting data from spreadsheets, preparing meeting materials, or organizing files scattered across your Drive.

47ChatGPT Tools
11Claude Tools
GoogleDeveloper
ProductivityCategory

Use Cases

productivitydata

Available Tools

Batch Update Document

batch_update_document
Full Description

Apply raw Google Docs batchUpdate requests to document content, not Drive file metadata.

Parameters (1 required, 4 optional)
Required
requestsarray

Raw Google Docs API documents.batchUpdate request objects for editing document content. Each list item must set exactly one request type key such as insertText, updateTextStyle, replaceAllText, deleteContentRange, insertInlineImage, or addDocumentTab. For insertInlineImage, pass a short public HTTP(S) URL string directly in uri. For local/generated image bytes, put the workspace image path in image_uris and set the matching request uri to a non-public placeholder such as that same path. Do not pass base64 data URLs directly. Send each request as a structured object in the list, not as a JSON string or other stringified input. Requests execute in order. Do not use this to rename or move the Drive file; use update_file for Drive metadata or parent-folder changes.

Optional
document_idstring

Raw native Google Docs document ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.document`. Do not pass a full URL or a Word file ID.

Default: null
document_urlstring

Native Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw document ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.document'`. Use Google Drive `fetch` for Word files (.doc or .docx). Do not pass document titles, Drive open?id links, app:// URLs, or /document/create.

Default: null
image_urisarray

Optional sidecar file references for local or generated images used by Drive roll-up batch update actions. This exists because runtime file upload rewriting currently only handles top-level file parameters. Put local workspace image paths here in the same order as the matching image URL placeholders in requests. Public HTTP(S) image URLs should stay directly in requests and should not be repeated here. Do not pass base64 data URLs.

Default: null
write_controlobject

Optional writeControl object for the underlying Google Docs API batch update call.

Default: null

Batch Update Presentation

batch_update_presentation
Full Description

Apply raw Google Slides batchUpdate requests to presentation content, not Drive file metadata.

Parameters (1 required, 4 optional)
Required
requestsarray

Raw Google Slides API presentations.batchUpdate request objects for editing presentation content. Each list item must set exactly one request type key such as createSlide, createImage, insertText, updateTextStyle, replaceAllText, updatePageElementTransform, deleteObject, or duplicateObject. Use slide/page objectId values returned by get_presentation, get_presentation_outline, or get_slide for fields such as elementProperties.pageObjectId or slideObjectIds; do not use the presentation ID, slide number, layout ID, or a page element ID. For local/generated image bytes in createImage.url, replaceImage.url, or replaceAllShapesWithImage.imageUrl, put the workspace image path in image_uris and set the matching request URL field to a non-public placeholder such as that same path. Send each request as a structured object in the list, not as a JSON string or other stringified input. Requests execute in order. Do not use this to rename or move the Drive file; use update_file for Drive metadata or parent-folder changes.

Optional
image_urisarray

Optional sidecar file references for local or generated images used by Drive roll-up batch update actions. This exists because runtime file upload rewriting currently only handles top-level file parameters. Put local workspace image paths here in the same order as the matching image URL placeholders in requests. Public HTTP(S) image URLs should stay directly in requests and should not be repeated here. Do not pass base64 data URLs.

Default: null
presentation_idstring

Raw native Google Slides presentation ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.presentation`. Do not pass a full URL or a PowerPoint file ID.

Default: null
presentation_urlstring

Native Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.presentation'`. Use Google Drive `fetch` for PowerPoint files (.ppt or .pptx).

Default: null
write_controlobject

Optional writeControl object for the underlying Google Slides API batch update call. Prefer providing requiredRevisionId from a fresh read before writing when you want concurrent edits to fail cleanly.

Default: null

Batch Update Spreadsheet

batch_update_spreadsheet
Full Description

Apply raw Google Sheets batchUpdate requests to spreadsheet content, not Drive file metadata.

Parameters (1 required, 6 optional)
Required
requestsarray

Raw Google Sheets API batchUpdate requests, in execution order. Each item must be one structured Sheets REST request object with exactly one request type key, for example {'addSheet': {...}}, {'updateCells': {...}}, or {'findReplace': {...}}. Use Google field names and casing exactly and do not pass JSON strings. For updateCells, provide a valid start or range with the target sheetId, keep row/column indexes inside the requested grid, put the field mask on updateCells.fields, and do not put a fields key inside rows[]. For findReplace, set exactly one scope: range, sheetId, or allSheets. For local/generated image bytes in IMAGE formulas, put the workspace image path in image_uris and set the matching formula URL argument to a non-public placeholder such as that same path. Do not use this to rename or move the Drive file; use update_file for Drive metadata or parent-folder changes.

Optional
image_urisarray

Optional sidecar file references for local or generated images used by Drive roll-up batch update actions. This exists because runtime file upload rewriting currently only handles top-level file parameters. Put local workspace image paths here in the same order as the matching image URL placeholders in requests. Public HTTP(S) image URLs should stay directly in requests and should not be repeated here. Do not pass base64 data URLs.

Default: null
include_spreadsheet_in_responseboolean

When true, include the updated spreadsheet resource in the response.

Default: False
response_include_grid_databoolean

When true, include grid data in updatedSpreadsheet. Only meaningful when include_spreadsheet_in_response is true.

Default: False
response_rangesarray

Optional ranges to include in updatedSpreadsheet when include_spreadsheet_in_response is true. A1 range including the sheet name, e.g. Sheet1!A1:C20 or 'Q1 Plan'!A1:C20. Quote sheet names that contain spaces or punctuation and avoid duplicated sheet prefixes.

Default: null
spreadsheet_idstring

Raw native Google Sheets spreadsheet ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.spreadsheet`. Do not pass a full URL or an Excel file ID.

Default: null
spreadsheet_urlstring

Native Google Sheets URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.spreadsheet'`. Use Google Drive `fetch` for Excel files (.xls or .xlsx).

Default: null

Bulk Update File Comments

bulk_update_file_comments
Full Description

Create, reply to, and resolve Drive file comments in one bulk tool call. Before calling, inspect the file and decide on all intended comment updates for this file. Put top-level comments in comments, thread replies in replies, and resolved threads in resolutions. For each top-level comment, you must include enough location context for a reader to identify the exact target even if Google displays the Drive API comment as unanchored: use quoted_text with the exact sentence or phrase for Docs/text, use slide_number plus quoted_text when possible for Slides, and use sheet_cell_range with the sheet name and A1 cell/range for Sheets. Supports 1-20 total operations.

Parameters (0 required, 5 optional)
Optional
commentsarray

Top-level Drive file comments to create. Inspect the file first and collect all intended comments for this file before calling this action instead of calling once per comment. For every comment, you must include enough location context for a reader to identify the target even if Google shows the Drive API comment as unanchored: use `quoted_text` with the exact sentence or phrase for Docs/text, use `slide_number` plus `quoted_text` when possible for Slides, and use `sheet_cell_range` with the sheet name and A1 cell/range for Sheets.

Default: null
idstring

Google Drive file ID only (for example `1abcDEF...`). Do not pass extra parameters.

Default: null
repliesarray

Replies to add to existing Drive comment threads. Include all intended replies for this file in one call.

Default: null
resolutionsarray

Existing Drive comment threads to resolve. Include all intended resolutions for this file in one call.

Default: null
urlstring

Google Drive/Docs/Sheets/Slides file URL containing a valid ID (for example https://drive.google.com/file/d/<FILE_ID>/... or https://docs.google.com/document/d/<FILE_ID>/...). Do not pass local filesystem paths, Windows paths, gdrive:// URIs, or plain names.

Default: null

Copy Document

copy_document
Full Description

Copy a document and return the URL of the new copy.

Parameters (1 required, 1 optional)
Required
urlstring

Google Drive/Docs/Sheets/Slides file URL containing a valid ID (for example https://drive.google.com/file/d/<FILE_ID>/... or https://docs.google.com/document/d/<FILE_ID>/...). Do not pass local filesystem paths, Windows paths, gdrive:// URIs, or plain names.

Optional
new_titlestring

Optional new title for the copied file. Parameter name is `new_title` (not `title`).

Default: null

Copy File

copy_file
Full Description

Copy a Drive file and return the URL of the new copy.

Parameters (1 required, 2 optional)
Required
urlstring

Google Drive/Docs/Sheets/Slides file URL containing a valid ID (for example https://drive.google.com/file/d/<FILE_ID>/... or https://docs.google.com/document/d/<FILE_ID>/...). Do not pass local filesystem paths, Windows paths, gdrive:// URIs, or plain names.

Optional
new_titlestring

Optional new title for the copied file. Parameter name is `new_title` (not `title`).

Default: null
parent_folderstring

Optional parent folder reference. Accepted values: folder ID, folder URL, or literal `root`. Parameter name is `parent_folder` (not `parent_id` or `folder_id`).

Default: null

Create File

create_file
Full Description

Create a native Google Doc, Sheet, or Slide file.

Parameters (2 required, 1 optional)
Required
mime_typestring

Native Google Workspace MIME type to create. Supported values: application/vnd.google-apps.document, application/vnd.google-apps.spreadsheet, application/vnd.google-apps.presentation.

titlestring

Title for the new file.

Optional
parent_folder_idstring

Destination folder ID, supported only for direct Google Drive service-account connections. Use a writable shared-drive folder. Omit for OAuth or delegated connections.

Default: null

Create Folder

create_folder
Full Description

Create a folder in Google Drive, optionally under a parent folder. parent_folder may be a Drive folder ID (e.g., "1A2B3C..."), a folder URL, or the literal string "root" to target the user's Drive root.

Parameters (1 required, 1 optional)
Required
namestring

Name of the new folder.

Optional
parent_folderstring

Optional parent folder reference. Accepted values: folder ID, folder URL, or literal `root`. Parameter name is `parent_folder` (not `parent_id` or `folder_id`).

Default: null

Create Presentation From Template

create_presentation_from_template
Full Description

Copy a Google Slides template to create a new deck.

Parameters (0 required, 4 optional)
Optional
parent_folder_idstring

Destination folder ID. Required for direct service accounts: use a shared-drive folder the service account can write to. Omit for the connected user's My Drive.

Default: null
template_presentation_idstring

Raw native Google Slides presentation ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.presentation`. Do not pass a full URL or a PowerPoint file ID.

Default: null
template_presentation_urlstring

Native Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.presentation'`. Use Google Drive `fetch` for PowerPoint files (.ppt or .pptx).

Default: null
titlestring

Optional title for the new deck created from a template copy.

Default: null

Delete Document

delete_document
Full Description

Permanently delete a Drive file.

Parameters (1 required)
Required
urlstring

Google Drive/Docs/Sheets/Slides file URL containing a valid ID (for example https://drive.google.com/file/d/<FILE_ID>/... or https://docs.google.com/document/d/<FILE_ID>/...). Do not pass local filesystem paths, Windows paths, gdrive:// URIs, or plain names.

Delete File

delete_file
Full Description

Permanently delete a Drive file.

Parameters (1 required)
Required
urlstring

Google Drive/Docs/Sheets/Slides file URL containing a valid ID (for example https://drive.google.com/file/d/<FILE_ID>/... or https://docs.google.com/document/d/<FILE_ID>/...). Do not pass local filesystem paths, Windows paths, gdrive:// URIs, or plain names.

Duplicate Sheet In New Spreadsheet

duplicate_sheet_in_new_spreadsheet
Full Description

Duplicate an existing sheet into a newly created spreadsheet file.

Parameters (2 required, 4 optional)
Required
new_file_namestring

Name of the newly created spreadsheet file that will receive the copied sheet.

source_sheet_namestring

Source sheet name to duplicate. Use the visible tab name, not the spreadsheet file name.

Optional
new_sheet_namestring

Optional name for the copied sheet in the new spreadsheet. Leave null to keep the source sheet name.

Default: null
parent_folder_idstring

Destination folder ID, supported only for direct Google Drive service-account connections. Use a writable shared-drive folder. Omit for OAuth or delegated connections.

Default: null
spreadsheet_idstring

Raw native Google Sheets spreadsheet ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.spreadsheet`. Do not pass a full URL or an Excel file ID.

Default: null
spreadsheet_urlstring

Native Google Sheets URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.spreadsheet'`. Use Google Drive `fetch` for Excel files (.xls or .xlsx).

Default: null

Export File

export_file
Full Description

Export a native Google Doc, Sheet, or Slide to the requested MIME type. Returns a user-scoped file reference without inline file content or base64. Google Drive files.export limits the exported response to 10 MB. Oversized exports fail; this action does not return a truncated file. For a larger native export, use the Drive URL and the same MIME type: fetch(url=google_drive_url, download_raw_file=True, raw_export_mime_type="application/pdf"). For a stored, non-Google-native Drive file, use fetch(url=google_drive_url, download_raw_file=True).

Parameters (0 required, 3 optional)
Optional
idstring

Google Drive file ID only (for example `1abcDEF...`). Do not pass extra parameters.

Default: null
mime_typestring

Export MIME type for a native Google Doc, Sheet, or Slide file. Common examples: application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.openxmlformats-officedocument.presentationml.presentation, text/markdown, text/plain, text/csv.

Default: application/pdf
urlstring

Google Drive/Docs/Sheets/Slides file URL containing a valid ID (for example https://drive.google.com/file/d/<FILE_ID>/... or https://docs.google.com/document/d/<FILE_ID>/...). Do not pass local filesystem paths, Windows paths, gdrive:// URIs, or plain names.

Default: null

Fetch

fetch
Full Description

With default options, return readable file text. Folders return at most 100 direct children as JSON; larger folders may be partial. Set download_raw_file=True to preserve the original complete raw-file response and provider limits. Additionally set include_base64=False to stream native files through files.download into a user-scoped file_uri without inline bytes. Google files.export is limited to 10 MB; files.download is not subject to that export limit. Use raw_export_mime_type for an explicit native export format.

Parameters (1 required, 3 optional)
Required
urlstring

Drive file or canonical Drive folder URL. With default text options, folders return at most 100 direct children as JSON and may be partial for larger folders.

Optional
download_raw_fileboolean

Return the complete raw file; set include_base64=false to stream a file reference instead of inline bytes.

Default: False
include_base64boolean

Set false to receive a streamed file reference without inline bytes. Omit or set true to preserve the existing raw-file response.

Default: null
raw_export_mime_typestring

Requires download_raw_file=true for Google Docs, Sheets, or Slides; null uses the default raw export.

Default: null

Fetch File Revision

fetch_file_revision
Full Description

Fetch text and revision-level author metadata from one Drive revision.

Parameters (2 required, 2 optional)
Required
fileIdstring

Google Drive API `fileId` path parameter. Raw file IDs are preferred; Drive/Docs/Sheets/Slides URLs are also accepted.

revisionIdstring

Revision ID returned by `list_file_revisions`. To compare to the current file, use `previousRevisionId` from that response.

Optional
acknowledgeAbuseboolean

Google Drive API `acknowledgeAbuse` query parameter for downloading abusive revision media when the user owns the file or organizes the shared drive.

Default: null
exportMimeTypestring

Connector export MIME type for Google Docs/Sheets/Slides revisions. Use `text/plain` for readable document text.

Default: text/plain

Fetch Thumbnail

fetch_thumbnail
Full Description

Return a bounded provider-generated image thumbnail for internal product callers.

Parameters (1 required, 1 optional)
Required
file_idstring

Raw Google Drive ID of an accessible image file.

Optional
sizestring

Preferred maximum thumbnail dimension in pixels. Omit for the provider's original rendition. A requested size may fall back to the original thumbnail.

Default: null

Find Document Text Range

find_document_text_range
Full Description

Find the index range of an exact text match in a Google Doc.

Parameters (1 required, 4 optional)
Required
text_to_findstring

Exact document text to match. Prefer this over raw indexes when possible.

Optional
document_idstring

Raw native Google Docs document ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.document`. Do not pass a full URL or a Word file ID.

Default: null
document_urlstring

Native Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw document ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.document'`. Use Google Drive `fetch` for Word files (.doc or .docx). Do not pass document titles, Drive open?id links, app:// URLs, or /document/create.

Default: null
instanceinteger

1-based occurrence number when target_text appears multiple times.

Default: 1
tab_idstring

Optional Google Docs tab ID. Use this to target a specific tab in a tabbed document. Exclude to get all tabs.

Default: null

Get Document

get_document
Full Description

Get a native Google Doc, including tab content. Use fetch for Word files.

Parameters (0 required, 3 optional)
Optional
document_idstring

Raw native Google Docs document ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.document`. Do not pass a full URL or a Word file ID.

Default: null
document_urlstring

Native Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw document ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.document'`. Use Google Drive `fetch` for Word files (.doc or .docx). Do not pass document titles, Drive open?id links, app:// URLs, or /document/create.

Default: null
fieldsstring

Optional Google Docs API partial-response fields selector. Nested selections use Google API fields syntax. When selecting tabs, include tabProperties so each flattened tab has its required tabId. Omit this parameter to return the full document resource.

Default: null

Get Document Comments

get_document_comments
Full Description

Read user comments and replies on a Google Doc for additional review context.

Parameters (0 required, 5 optional)
Optional
document_idstring

Raw native Google Docs document ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.document`. Do not pass a full URL or a Word file ID.

Default: null
document_urlstring

Native Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw document ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.document'`. Use Google Drive `fetch` for Word files (.doc or .docx). Do not pass document titles, Drive open?id links, app:// URLs, or /document/create.

Default: null
include_deletedboolean

When true, include deleted comments and deleted replies in the result.

Default: False
page_sizeinteger

Maximum comment threads to return on this page. Use the response nextPageToken to continue.

Default: 100
page_tokenstring

Opaque nextPageToken from a previous get_document_comments response.

Default: null

Get Document Paragraph Range

get_document_paragraph_range
Full Description

Resolve the paragraph range containing a given document index.

Parameters (1 required, 3 optional)
Required
index_withininteger

A Google Docs document index that falls within the paragraph you want to resolve.

Optional
document_idstring

Raw native Google Docs document ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.document`. Do not pass a full URL or a Word file ID.

Default: null
document_urlstring

Native Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw document ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.document'`. Use Google Drive `fetch` for Word files (.doc or .docx). Do not pass document titles, Drive open?id links, app:// URLs, or /document/create.

Default: null
tab_idstring

Optional Google Docs tab ID. Use this to target a specific tab in a tabbed document. Exclude to get all tabs.

Default: null

Get Document Tables

get_document_tables
Full Description

Return table structures and cell text from a Google Doc.

Parameters (0 required, 3 optional)
Optional
document_idstring

Raw native Google Docs document ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.document`. Do not pass a full URL or a Word file ID.

Default: null
document_urlstring

Native Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw document ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.document'`. Use Google Drive `fetch` for Word files (.doc or .docx). Do not pass document titles, Drive open?id links, app:// URLs, or /document/create.

Default: null
tab_idstring

Optional Google Docs tab ID. Use this to target a specific tab in a tabbed document. Exclude to get all tabs.

Default: null

Get Document Text

get_document_text
Full Description

Return text and indexes from a native Google Doc. Use fetch for Word files.

Parameters (0 required, 3 optional)
Optional
document_idstring

Raw native Google Docs document ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.document`. Do not pass a full URL or a Word file ID.

Default: null
document_urlstring

Native Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw document ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.document'`. Use Google Drive `fetch` for Word files (.doc or .docx). Do not pass document titles, Drive open?id links, app:// URLs, or /document/create.

Default: null
tab_idstring

Optional Google Docs tab ID. Use this to target a specific tab in a tabbed document. Exclude to get all tabs.

Default: null

Get File Comments

get_file_comments
Full Description

Read comments and replies on an arbitrary Drive file.

Parameters (0 required, 5 optional)
Optional
idstring

Google Drive file ID only (for example `1abcDEF...`). Do not pass extra parameters.

Default: null
include_deletedboolean

When true, include deleted comments and deleted replies in the result.

Default: False
page_sizeinteger

Maximum comment threads to return on this page. Use the response nextPageToken to continue.

Default: 100
page_tokenstring

Opaque nextPageToken from a previous get_file_comments response.

Default: null
urlstring

Google Drive/Docs/Sheets/Slides file URL containing a valid ID (for example https://drive.google.com/file/d/<FILE_ID>/... or https://docs.google.com/document/d/<FILE_ID>/...). Do not pass local filesystem paths, Windows paths, gdrive:// URIs, or plain names.

Default: null

Get File Metadata

get_file_metadata
Full Description

Return metadata for a Google Drive file or folder without downloading contents. This action wraps Google Drive files.get.

Parameters (2 required, 6 optional)
Required
fileIdstring

Google Drive API `fileId` path parameter. Raw file IDs are preferred; Drive/Docs/Sheets/Slides URLs are also accepted.

idstring

Google Drive file ID only (for example `1abcDEF...`). Do not pass extra parameters.

Optional
acknowledgeAbuseboolean

Google Drive API `acknowledgeAbuse` query parameter for downloading abusive media when applicable.

Default: null
fieldsstring

Google Drive API partial response `fields` selector for the file metadata.

Default: id,name,mimeType,size,webViewLink,createdTime,modifiedTime,parents,shared,driveId,hasAugmentedPermissions,capabilities/canShare,permissions(type,role,emailAddress,domain,displayName,allowFileDiscovery)
includeLabelsstring

Google Drive API `includeLabels` query parameter: comma-separated label IDs to include in `labelInfo`.

Default: null
includePermissionsForViewstring

Google Drive API `includePermissionsForView` query parameter. Only `published` is supported.

Default: null
supportsAllDrivesboolean

Google Drive API `supportsAllDrives` query parameter.

Default: True
supportsTeamDrivesboolean

Deprecated Google Drive API `supportsTeamDrives` query parameter.

Default: null

Get Presentation

get_presentation
Full Description

Get a native Google Slides presentation. Use fetch for PowerPoint files.

Parameters (0 required, 3 optional)
Optional
fieldsstring

Optional Google Slides API partial-response fields selector. For example, use `presentationId,title,revisionId,pageSize,locale` for a compact metadata read. Nested selections use Google API fields syntax. Omit this parameter to return the full presentation resource.

Default: null
presentation_idstring

Raw native Google Slides presentation ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.presentation`. Do not pass a full URL or a PowerPoint file ID.

Default: null
presentation_urlstring

Native Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.presentation'`. Use Google Drive `fetch` for PowerPoint files (.ppt or .pptx).

Default: null

Get Presentation Comments

get_presentation_comments
Full Description

Read user comments and replies on a Google Slides deck for additional review context.

Parameters (0 required, 5 optional)
Optional
include_deletedboolean

When true, include deleted comments and deleted replies in the result.

Default: False
page_sizeinteger

Maximum comment threads to return on this page. Use the response nextPageToken to continue.

Default: 100
page_tokenstring

Opaque nextPageToken from a previous get_presentation_comments response.

Default: null
presentation_idstring

Raw native Google Slides presentation ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.presentation`. Do not pass a full URL or a PowerPoint file ID.

Default: null
presentation_urlstring

Native Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.presentation'`. Use Google Drive `fetch` for PowerPoint files (.ppt or .pptx).

Default: null

Get Presentation Outline

get_presentation_outline
Full Description

Return a compact slide outline for stable slide targeting.

Parameters (1 required)
Required
presentation_urlstring

Native Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.presentation'`. Use Google Drive `fetch` for PowerPoint files (.ppt or .pptx).

Get Presentation Tables

get_presentation_tables
Full Description

Return Google Slides table structures with row and column coordinates preserved.

Parameters (1 required)
Required
presentation_urlstring

Google Slides URL

Get Presentation Text

get_presentation_text
Full Description

Get text from a native Google Slides presentation. Use fetch for PowerPoint files.

Parameters (0 required, 2 optional)
Optional
presentation_idstring

Raw native Google Slides presentation ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.presentation`. Do not pass a full URL or a PowerPoint file ID.

Default: null
presentation_urlstring

Native Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.presentation'`. Use Google Drive `fetch` for PowerPoint files (.ppt or .pptx).

Default: null

Get Profile

get_profile
Full Description

Return the current Google Drive user's profile information. This action takes no parameters.

Get Slide

get_slide
Full Description

Get a single slide by object ID.

Parameters (1 required, 2 optional)
Required
slide_object_idstring

Google Slides slide/page objectId for the target slide. Use an objectId from get_presentation or get_presentation_outline; do not pass the presentation ID, slide number, layout ID, or a page element ID.

Optional
presentation_idstring

Raw native Google Slides presentation ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.presentation`. Do not pass a full URL or a PowerPoint file ID.

Default: null
presentation_urlstring

Native Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.presentation'`. Use Google Drive `fetch` for PowerPoint files (.ppt or .pptx).

Default: null

Get Slide Thumbnail

get_slide_thumbnail
Full Description

Return slide metadata plus an inline thumbnail image for visual layout questions.

Parameters (1 required, 3 optional)
Required
slide_object_idstring

Slide/page objectId to render as a thumbnail image. Use an objectId from get_presentation or get_presentation_outline; do not pass the presentation ID, slide number, layout ID, or a page element ID.

Optional
presentation_idstring

Raw native Google Slides presentation ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.presentation`. Do not pass a full URL or a PowerPoint file ID.

Default: null
presentation_urlstring

Native Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.presentation'`. Use Google Drive `fetch` for PowerPoint files (.ppt or .pptx).

Default: null
thumbnail_sizestring

Thumbnail size. Defaults to MEDIUM. Use LARGE only when fine layout details matter.

Options:LARGEMEDIUMSMALL
Default: MEDIUM

Get Spreadsheet Cells

get_spreadsheet_cells
Full Description

Read CellData from bounded native Google Sheets ranges. Use fetch for Excel files.

Parameters (1 required, 3 optional)
Required
rangesarray

One or more A1 ranges including the sheet name, e.g. ['Sheet1!A1:C20']. Keep each range within existing sheet bounds.

Optional
cell_fieldsstring

Raw Google Sheets CellData field mask fragment. Examples: 'formattedValue,effectiveValue' or 'formattedValue,userEnteredValue,effectiveFormat(textFormat,numberFormat)'. Default: 'userEnteredValue,userEnteredFormat'. Prefer this action over `get_spreadsheet_range` unless you only need the plain cell values; use this action for formatting, formulas, validation, notes, hyperlinks, and other cell metadata.

Default: null
spreadsheet_idstring

Raw native Google Sheets spreadsheet ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.spreadsheet`. Do not pass a full URL or an Excel file ID.

Default: null
spreadsheet_urlstring

Native Google Sheets URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.spreadsheet'`. Use Google Drive `fetch` for Excel files (.xls or .xlsx).

Default: null

Get Spreadsheet Comments

get_spreadsheet_comments
Full Description

Read user comments and replies on a Google Sheets spreadsheet for additional review context.

Parameters (0 required, 5 optional)
Optional
include_deletedboolean

When true, include deleted comments and deleted replies in the result.

Default: False
page_sizeinteger

Maximum comment threads to return on this page. Use the response nextPageToken to continue.

Default: 100
page_tokenstring

Opaque nextPageToken from a previous get_spreadsheet_comments response.

Default: null
spreadsheet_idstring

Raw native Google Sheets spreadsheet ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.spreadsheet`. Do not pass a full URL or an Excel file ID.

Default: null
spreadsheet_urlstring

Native Google Sheets URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.spreadsheet'`. Use Google Drive `fetch` for Excel files (.xls or .xlsx).

Default: null

Get Spreadsheet Metadata

get_spreadsheet_metadata
Full Description

Get metadata for a native Google Sheet. Use fetch for Excel files.

Parameters (0 required, 4 optional)
Optional
charts_onlyboolean

When true, return only sheet properties and chart IDs/titles.

Default: False
include_conditional_format_rulesboolean

When true, include per-sheet conditional formatting rules in the response.

Default: False
spreadsheet_idstring

Raw native Google Sheets spreadsheet ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.spreadsheet`. Do not pass a full URL or an Excel file ID.

Default: null
spreadsheet_urlstring

Native Google Sheets URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.spreadsheet'`. Use Google Drive `fetch` for Excel files (.xls or .xlsx).

Default: null

Get Spreadsheet Range

get_spreadsheet_range
Full Description

Read plain cell values from a native Google Sheet. Use fetch for Excel files.

Parameters (2 required, 3 optional)
Required
rangestring

A1/R1C1 range, optional sheet, e.g. A1:B10 or Sheet1!A1:B10. Use `get_spreadsheet_cells` for formatting, formulas, notes, hyperlinks, or metadata.

sheet_namestring

Sheet tab name only (no ! or coordinates). For A1 notation compatibility, quote names with spaces/punctuation (e.g. 'Q1 Plan'). If the name contains a single quote, escape it as two single quotes inside the quoted name (e.g. 'O''Reilly').

Optional
spreadsheet_idstring

Raw native Google Sheets spreadsheet ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.spreadsheet`. Do not pass a full URL or an Excel file ID.

Default: null
spreadsheet_urlstring

Native Google Sheets URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.spreadsheet'`. Use Google Drive `fetch` for Excel files (.xls or .xlsx).

Default: null
value_render_optionstring

The option to render the values, e.g. 'FORMATTED_VALUE', 'UNFORMATTED_VALUE' or 'FORMULA'. Use null for default.

Default: null

Import Document

import_document
Full Description

Upload a local DOC/DOCX/ODT/RTF/HTML/TXT file to Drive, defaulting to native Google Docs.

Parameters (1 required, 3 optional)
Required
source_fileobject

Uploaded document file to import through Google Drive's conversion flow. Pass the resolved uploaded file object directly. The source MIME type must match one of the accepted document import MIME types on `source_file.mime_type`. Defaults to creating a native Google Doc; use `upload_file` to store arbitrary raw files without conversion.

Optional
parent_folder_idstring

Destination folder ID. Required for direct service accounts: use a shared-drive folder the service account can write to. Omit for the connected user's My Drive.

Default: null
titlestring

Optional title for the imported Google Docs document. Defaults to the uploaded filename stem.

Default: null
upload_modestring

How to store the uploaded file in Drive. Defaults to native_google_docs. `keep_source_file_type` preserves the uploaded file type, but the source file must still be one of the accepted Drive import MIME types for this action.

Options:native_google_docskeep_source_file_type
Default: native_google_docs

Import Presentation

import_presentation
Full Description

Upload a local PPT/PPTX/ODP file to Drive, defaulting to native Google Slides.

Parameters (1 required, 3 optional)
Required
source_fileobject

Uploaded presentation file to import through Google Drive's conversion flow. Pass the resolved uploaded file object directly. The source MIME type must match one of the accepted presentation import MIME types on `source_file.mime_type`. Defaults to creating a native Google Slides deck; use `upload_file` to store arbitrary raw files without conversion.

Optional
parent_folder_idstring

Destination folder ID. Required for direct service accounts: use a shared-drive folder the service account can write to. Omit for the connected user's My Drive.

Default: null
titlestring

Optional title for the imported Google Slides presentation. Defaults to the uploaded filename stem.

Default: null
upload_modestring

How to store the uploaded file in Drive. Defaults to native_google_slides. `keep_source_file_type` preserves the uploaded file type, but the source file must still be one of the accepted Drive import MIME types for this action.

Options:native_google_slideskeep_source_file_type
Default: native_google_slides

Import Spreadsheet

import_spreadsheet
Full Description

Upload a spreadsheet file to Drive, defaulting to native Google Sheets conversion.

Parameters (1 required, 3 optional)
Required
source_fileobject

Uploaded spreadsheet file to import through Google Drive's conversion flow. Pass the resolved uploaded file object directly. The source MIME type must match one of the accepted spreadsheet import MIME types on `source_file.mime_type`. Defaults to creating a native Google Sheet; use `upload_file` to store arbitrary raw files without conversion.

Optional
parent_folder_idstring

Destination folder ID. Required for direct service accounts: use a shared-drive folder the service account can write to. Omit for the connected user's My Drive.

Default: null
titlestring

Optional title for the imported spreadsheet. Defaults to the uploaded filename stem.

Default: null
upload_modestring

How to store the uploaded spreadsheet in Drive. Defaults to native_google_sheets. `keep_source_file_type` preserves the uploaded file type, but the source file must still be one of the accepted Drive import MIME types for this action.

Options:native_google_sheetskeep_source_file_type
Default: native_google_sheets

List Drives

list_drives
Full Description

List shared drives accessible to the user. This action takes no parameters.

List File Revisions

list_file_revisions
Full Description

List version-history revisions for a Google Drive file. The response includes previousRevisionId; pass that to fetch_file_revision to read the immediately previous version. When Google returns lastModifyingUser, use it as revision-level attribution while comparing revisions to identify when specific text first appeared.

Parameters (1 required, 2 optional)
Required
fileIdstring

Google Drive API `fileId` path parameter. Raw file IDs are preferred; Drive/Docs/Sheets/Slides URLs are also accepted.

Optional
pageSizeinteger

Google Drive API `pageSize` query parameter: maximum revisions to request per page.

Default: 100
pageTokenstring

Google Drive API `pageToken` query parameter: token for continuing a previous revisions.list request.

Default: null

List Folder

list_folder
Full Description

List the items directly contained in a Google Drive folder. Accepted parameters are only url and top_k. For My Drive root, pass the literal root alias instead of a synthetic folder URL.

Parameters (1 required, 1 optional)
Required
urlstring

Google Drive folder URL (for example https://drive.google.com/drive/folders/<FOLDER_ID>) or the literal `root` alias for the user's My Drive root folder. Do not pass `my-drive`, raw folder names, or local filesystem paths.

Optional
top_kinteger

Maximum number of items to scan in the folder. Parameter name is `top_k`.

Default: 100

Oai User Fetch

oai_user_fetch
Full Description

Uses mfetch to perform document fetch for link following and citations.

Parameters (2 required)
Required
content_locationstring

Content location returned by oai_user_search.

document_idstring

Document id returned by oai_user_search.

Oai User Search

oai_user_search
Full Description

Uses synced RAG index to perform semantic search against query. The index is refreshed until (now - 2h).

Parameters (1 required)
Required
querystring

Semantic search query for the synced knowledge store.

Recent Documents

recent_documents
Full Description

Return the most recently modified documents accessible to the user. Accepted parameters are only top_k and require_viewed_by_user. Set require_viewed_by_user=True to only return files the current user has viewed.

Parameters (1 required, 1 optional)
Required
top_kinteger

Number of recent files to return. Parameter name is `top_k`.

Optional
require_viewed_by_userboolean

When true, return only files viewed by the authenticated user.

Default: False

Resolve Drives For Admin

resolve_drives_for_admin
Full Description

Fetch names and URLs for shared drives using the administrator's connection. The invoker authorizes the private admin action and the caller's explicit link. Lookup does not change or rely on the content allowlist. Names are transient customer content, never tenant metadata. Supply at most 100 shared drive IDs; unavailable drives return an error for that ID.

Parameters (1 required)
Required
drive_idsarray

Shared drive IDs to resolve to display names and Google Drive URLs.

Search

search
Full Description

Search Google Drive and return file or folder metadata. Calls without item_type and page_token retain the legacy search and optional best-effort text hydration. An explicit image, document, or folder item type searches exactly one metadata-only provider page; it never fetches file contents, even with best_effort_fetch=True. Return the opaque, provider-owned next_page_token unchanged as the next request's page_token, including when a page has no allowed results. Use short, specific keywords, or omit the query to browse accessible files. Broaden an empty-result search with related terms, abbreviations, or synonyms. special_filter_query_str is a raw Google Drive v3 q filter for MIME type, modification time, ownership, sharing, or folder selection. Set require_viewed_by_user=True to restrict results to viewed files. Search covers all accessible drives by default. Do not pass unsupported top_k, max_results, page_size, folder_url, query_type, user_message, recency_days, driveId, or include_shared_drives fields.

Parameters (0 required, 8 optional)
Optional
best_effort_fetchboolean

When true, attempt to fetch text content for each result.

Default: False
fetch_ttlnumber

Best-effort fetch timeout in seconds when best_effort_fetch=true.

Default: 15.0
item_typestring

Restrict a paginated search to images, documents, or folders.

Default: null
page_tokenstring

Opaque next_page_token returned by a previous Drive search.

Default: null
querystring

Optional keyword query for Drive search. Use concise terms like project/file names, or omit the query to browse accessible files.

require_viewed_by_userboolean

When true, keep only files viewed by the authenticated user.

Default: False
special_filter_query_strstring

Optional raw Google Drive API `q` filter expression for advanced filtering.

topninteger

Maximum results to return. Parameter name is `topn` (not `top_k`, `max_results`, or `page_size`).

Default: 20

Search Spreadsheet Rows

search_spreadsheet_rows
Full Description

Search a native Google Sheet's existing cell bounds. Use fetch for Excel files.

Parameters (2 required, 14 optional)
Required
querystring

String to search for in any cell within each row.

sheet_namestring

Sheet tab name only (no ! or coordinates). For A1 notation compatibility, quote names with spaces/punctuation (e.g. 'Q1 Plan'). If the name contains a single quote, escape it as two single quotes inside the quoted name (e.g. 'O''Reilly').

Optional
column_numbersarray

Deprecated compatibility alias for return_columns. 1-based column positions relative to the scanned range. Use null unless maintaining an older caller.

Default: null
end_columnstring

Last spreadsheet column letter to scan, e.g. Z. Required unless range is provided. Choose a finite bound from spreadsheet metadata or known table width. The scan may cover at most 50,000 cells.

Default: null
end_rowinteger

1-based last row to scan. Required unless range is provided. Choose a finite bound from spreadsheet metadata or user context; this is the scan limit, not the result limit. The scan may cover at most 50,000 cells.

Default: null
header_rowinteger

1-based spreadsheet row containing column headers. The default behaves like the previous search_spreadsheet_rows action: row 1 when included, otherwise the first scanned row. Use null when the scanned range has no header row.

Default: 1
include_header_rowboolean

When true and header_row is inside the scan, include the header values as the first output row.

Default: True
max_columnsinteger

Maximum number of scanned columns to return when return_columns is null. Default is 100.

Default: 100
max_matching_rowsinteger

Maximum number of matching non-header rows to return. This limits output only, not the scan. Default is 100.

Default: 100
max_rowsinteger

Deprecated compatibility alias for max_matching_rows. Leave null for new calls.

Default: null
rangestring

bounded A1 scan range, optional sheet, e.g. A1:F100 or Sheet1!A1:F100. The scan may cover at most 50,000 cells.

Default: null
return_columnsarray

Optional spreadsheet column letters to include in output, e.g. ['A', 'C', 'F']. They must fall inside the scanned column bounds. Leave null to return the first max_columns scanned columns.

Default: null
spreadsheet_idstring

Raw native Google Sheets spreadsheet ID (for example `1abcDEF...`). Use an ID from a search result with MIME type `application/vnd.google-apps.spreadsheet`. Do not pass a full URL or an Excel file ID.

Default: null
spreadsheet_urlstring

Native Google Sheets URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the title, search Google Drive for `mimeType = 'application/vnd.google-apps.spreadsheet'`. Use Google Drive `fetch` for Excel files (.xls or .xlsx).

Default: null
start_columnstring

First spreadsheet column letter to scan, e.g. A. Usually A when scanning the visible table.

Default: A
start_rowinteger

1-based first row to scan. Usually 1 when the header is in the first row.

Default: 1

Share Document

share_document
Full Description

Share a document with a user or anyone at the company. Provide either user_email or anyone_at_company. When sharing with anyone at the company, you can specify whether to show the file in search results.

Parameters (2 required, 3 optional)
Required
permission
urlstring

Google Drive file URL to share. Folder URLs are not accepted for this action.

Optional
anyone_at_companyboolean

Share with anyone in the workspace/domain.

Default: False
show_in_searchboolean

When sharing with anyone_at_company, whether the file is discoverable in search.

Default: False
user_emailstring

Specific user email to share with. Provide this or set anyone_at_company=true.

Default: null

Share File

share_file
Full Description

Share a Drive file with a user or anyone at the company.

Parameters (2 required, 3 optional)
Required
permissionstring

Share permission level to grant. Use `reader` for read-only access, `writer` to allow edits, `commenter` for comment-only access, or `owner` only when the API path supports ownership transfer.

Options:readerwritercommenterowner
urlstring

Google Drive file URL to share. Folder URLs are not accepted for this action.

Optional
anyone_at_companyboolean

Share with anyone in the Google Workspace domain.

Default: False
show_in_searchboolean

When sharing with anyone_at_company, whether the file is discoverable in search.

Default: False
user_emailstring

Specific user email to share with. Provide this or set anyone_at_company=true.

Default: null

Update File

update_file
Full Description

Update an existing Drive file. Without file_uri, this updates metadata and parents only, including rename and move operations. With file_uri, this replaces the raw file bytes in place using Drive files.update upload semantics while preserving the same Drive file ID. Do not use Google Workspace MIME types with file_uri; native Docs/Sheets/Slides edits use their dedicated batch-update actions.

Parameters (1 required, 5 optional)
Required
fileIdstring

Google Drive API `fileId` path parameter. Raw file IDs are preferred; Drive/Docs/Sheets/Slides URLs are also accepted.

Optional
addParentsstring

Optional Google Drive API `addParents` query parameter: comma-separated parent folder IDs to add. For moving a file, set this to the destination folder ID.

Default: null
file_uriobject

Optional connector file reference whose bytes should replace the existing raw Drive file content. Leave null for a metadata-only rename or move. Do not pass raw local file paths or string URLs.

Default: null
mime_typestring

Optional MIME type for the replacement bytes. Leave null to use the MIME type from file_uri, or application/octet-stream if file_uri does not include one. Do not use Google Workspace MIME types such as application/vnd.google-apps.document.

Default: null
namestring

Optional Google Drive file name. Use this to rename an existing Drive file. Leave null when only changing parents.

Default: null
removeParentsstring

Optional Google Drive API `removeParents` query parameter: comma-separated parent folder IDs to remove. For moving a file, set this to the current/source parent folder ID.

Default: null

Upload File

upload_file
Full Description

Upload a file reference as a new Google Drive file, not rename or move an existing file.

Parameters (1 required, 3 optional)
Required
file_uriobject

Required file reference for the bytes to upload. Pass the `file_uri` object returned by another connector or generated by the runtime; if you provide it manually, send the same structured object/dictionary shape rather than base64 content. Do not pass raw local file paths or string URLs.

Optional
file_namestring

Optional destination file name including extension. Leave null to use the name from file_uri.

Default: null
mime_typestring

Optional MIME type for the Drive file. Leave null to use the MIME type from file_uri.

Default: null
parent_folder_idstring

Optional destination Google Drive folder ID. Leave null to upload to My Drive/root. Do not pass folder URLs, folder names, `root`, or local filesystem paths.

Default: null

Links

WebsitePrivacy Policy