Google Drive - ChatGPT & Claude App Details | Bullseye

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 Google Docs document ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

document_urlstring

Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw Google Docs document ID. If you only know the document title or title keywords, call `search_documents` first instead of asking the user for a URL. 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 Google Slides presentation ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

presentation_urlstring

Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the deck title or title keywords, call `search_presentations` first instead of asking the user for a URL.

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 Google Sheets spreadsheet ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

spreadsheet_urlstring

Google Sheets spreadsheet URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the spreadsheet title or title keywords, call `search_spreadsheets` first instead of asking the user for a URL.

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

Create File

create_file

Full Description

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

Parameters (2 required)

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.

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 an existing Google Slides deck to create a new deck from a template.

Parameters (0 required, 3 optional)

Optional

template_presentation_idstring

Raw Google Slides presentation ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

template_presentation_urlstring

Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the deck title or title keywords, call `search_presentations` first instead of asking the user for a URL.

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.

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, 3 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

spreadsheet_idstring

Raw Google Sheets spreadsheet ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

spreadsheet_urlstring

Google Sheets spreadsheet URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the spreadsheet title or title keywords, call `search_spreadsheets` first instead of asking the user for a URL.

Default: null

Export File

export_file

Full Description

Export a native Google Doc, Sheet, or Slide file to the requested MIME type.

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

Download the content and title of a Google Drive file. If download_raw_file is set to True, the file will be downloaded as a raw file. Set raw_export_mime_type to override the raw export format for Google Docs or Sheets. Otherwise, the file will be displayed as text. If text extraction is unsupported, the response falls back to raw file fields.

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

download_raw_fileboolean

When true, download the raw bytes instead of text-extracted content.

Default: False

raw_export_mime_typestring

Optional raw export MIME type to use when `download_raw_file=true` for Google Docs, Sheets, or Slides. Leave null to use the default raw export format.

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 Google Docs document ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

document_urlstring

Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw Google Docs document ID. If you only know the document title or title keywords, call `search_documents` first instead of asking the user for a URL. 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 the full Google Doc, including tab content when present.

Parameters (0 required, 2 optional)

Optional

document_idstring

Raw Google Docs document ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

document_urlstring

Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw Google Docs document ID. If you only know the document title or title keywords, call `search_documents` first instead of asking the user for a URL. Do not pass document titles, Drive open?id links, app:// URLs, or /document/create.

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 Google Docs document ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

document_urlstring

Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw Google Docs document ID. If you only know the document title or title keywords, call `search_documents` first instead of asking the user for a URL. 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 Google Docs document ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

document_urlstring

Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw Google Docs document ID. If you only know the document title or title keywords, call `search_documents` first instead of asking the user for a URL. 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 Google Docs document ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

document_urlstring

Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw Google Docs document ID. If you only know the document title or title keywords, call `search_documents` first instead of asking the user for a URL. 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 paragraph text with document indexes for a Google Doc.

Parameters (0 required, 3 optional)

Optional

document_idstring

Raw Google Docs document ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

document_urlstring

Google Docs URL in the format https://docs.google.com/document/d/<DOCUMENT_ID>/... or a raw Google Docs document ID. If you only know the document title or title keywords, call `search_documents` first instead of asking the user for a URL. 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 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,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 presentation metadata and slide content for a Google Slides deck.

Parameters (0 required, 2 optional)

Optional

presentation_idstring

Raw Google Slides presentation ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

presentation_urlstring

Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the deck title or title keywords, call `search_presentations` first instead of asking the user for a URL.

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 Google Slides presentation ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

presentation_urlstring

Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the deck title or title keywords, call `search_presentations` first instead of asking the user for a URL.

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

Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the deck title or title keywords, call `search_presentations` first instead of asking the user for a URL.

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

Return only text content to reduce payload size.

Parameters (0 required, 2 optional)

Optional

presentation_idstring

Raw Google Slides presentation ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

presentation_urlstring

Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the deck title or title keywords, call `search_presentations` first instead of asking the user for a URL.

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 Google Slides presentation ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

presentation_urlstring

Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the deck title or title keywords, call `search_presentations` first instead of asking the user for a URL.

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 Google Slides presentation ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

presentation_urlstring

Google Slides URL in the format https://docs.google.com/presentation/d/<PRESENTATION_ID>/... or a raw presentation ID. If you only know the deck title or title keywords, call `search_presentations` first instead of asking the user for a URL.

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 cell data from one or more bounded spreadsheet ranges using the CellData shape.

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 Google Sheets spreadsheet ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

spreadsheet_urlstring

Google Sheets spreadsheet URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the spreadsheet title or title keywords, call `search_spreadsheets` first instead of asking the user for a URL.

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 Google Sheets spreadsheet ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

spreadsheet_urlstring

Google Sheets spreadsheet URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the spreadsheet title or title keywords, call `search_spreadsheets` first instead of asking the user for a URL.

Default: null

Get Spreadsheet Metadata

get_spreadsheet_metadata

Full Description

Get metadata about a spreadsheet.

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 Google Sheets spreadsheet ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

spreadsheet_urlstring

Google Sheets spreadsheet URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the spreadsheet title or title keywords, call `search_spreadsheets` first instead of asking the user for a URL.

Default: null

Get Spreadsheet Range

get_spreadsheet_range

Full Description

Read only the plain values from a range of cells within a spreadsheet.

Parameters (2 required, 3 optional)

Required

rangestring

Cell range only (A1 or R1C1), e.g. A1:B10, A:Z, or 1:200. Do not include the sheet name here because sheet_name is prepended automatically. Passing Sheet1!A1:Z200 or duplicated prefixes like Sheet1!Sheet1!A1:B10 will fail. Keep the range within existing sheet bounds. Use this action only when you need the plain values of a range; use `get_spreadsheet_cells` when you need cell values together with formatting, formulas, validation, notes, hyperlinks, or other cell 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 Google Sheets spreadsheet ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

spreadsheet_urlstring

Google Sheets spreadsheet URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the spreadsheet title or title keywords, call `search_spreadsheets` first instead of asking the user for a URL.

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, 2 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

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, 2 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

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, 2 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

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 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

Search

search

Full Description

Search Google Drive files by query and return basic details. Accepted parameters are only query, topn, special_filter_query_str, best_effort_fetch, fetch_ttl, and require_viewed_by_user. Use clear, specific keywords such as project names, collaborators, or file types. Example: `"design doc pptx". When using query, each search query is an AND token match. Meaning, every token in the query is required to be present in order to match.


Search will return documents that contain all of the keywords in the query.
Therefore, queries should be short and keyword-focused (avoid long natural language).
If no results are found, try the following strategies: 1) Use different or related keywords. 2) Make the query more generic and simpler.
To improve recall, consider variants of your terms: abbreviations, synonyms, etc.

Previous search results can provide hints about useful variants of internal terms — use those to refine queries. Use special_filter_query_str when you need precise MIME-type or metadata filters. It uses Google Drive v3 search (the q parameter).

Supported time fields: modifiedTime, createdTime, viewedByMeTime, sharedWithMeTime (ISO 8601, e.g., '2025-09-03T00:00:00').

People/ownership filters: 'me' in owners, 'user@domain.com' in owners, 'user@domain.com' in writers, 'user@domain.com' in readers, sharedWithMe = true.

Type filters: mimeType = 'application/vnd.google-apps.document' (Docs), ...spreadsheet (Sheets), ...presentation (Slides), and mimeType != 'application/vnd.google-apps.folder' to exclude folders. or mimeType = 'application/vnd.google-apps.folder' to select folders. Set require_viewed_by_user=True to restrict results to files the current user has viewed. Do not pass unsupported fields like top_k, max_results, page_size, folder_url, query_type, user_message, recency_days, driveId, or include_shared_drives`.

Parameters (1 required, 5 optional)

Required

querystring

Keyword query for Drive search. Use concise terms like project/file names. This may be empty only when `special_filter_query_str` is provided.

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

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 bounded spreadsheet rows containing a query string and return matching rows.

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

Compatibility-only bounded A1 scan range, e.g. A1:Z500 or B2. Prefer start_row, end_row, start_column, and end_column. Whole-column or whole-row ranges such as A:Z, A:A, or 1:500 are rejected for search because they can read far more cells than intended. 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 Google Sheets spreadsheet ID only (for example `1abcDEF...`). Use this when you already have the ID from a prior search result. Do not pass a full URL here.

Default: null

spreadsheet_urlstring

Google Sheets spreadsheet URL in the format https://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/... or a raw spreadsheet ID. If you only know the spreadsheet title or title keywords, call `search_spreadsheets` first instead of asking the user for a URL.

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

Use Cases

Available Tools

Batch Update Document

Batch Update Presentation

Batch Update Spreadsheet

Copy Document

Create File

Create Folder

Create Presentation From Template

Delete Document

Duplicate Sheet In New Spreadsheet

Export File

Fetch

Find Document Text Range

Get Document

Get Document Comments

Get Document Paragraph Range

Get Document Tables

Get Document Text

Get File Metadata

Get Presentation

Get Presentation Comments

Get Presentation Outline

Get Presentation Tables

Get Presentation Text

Get Profile

Get Slide

Get Slide Thumbnail

Get Spreadsheet Cells

Get Spreadsheet Comments

Get Spreadsheet Metadata

Get Spreadsheet Range

Import Document

Import Presentation

Import Spreadsheet

List Drives

List Folder

Oai User Fetch

Oai User Search

Recent Documents

Search

Search Spreadsheet Rows

Share Document

Links