Google Super

Learn how to use Google Super with Composio

Overview

SLUG: GOOGLESUPER

Description

Google Super App combines all Google services including Drive, Calendar, Gmail, Sheets, Analytics, Ads, and more, providing a unified platform for seamless integration and management of your digital life.

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/documents,https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/adwords,https://mail.google.com/,https://www.googleapis.com/auth/userinfo.profile,https://www.googleapis.com/auth/contacts.readonly,https://www.googleapis.com/auth/spreadsheets,https://www.googleapis.com/auth/presentations,https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/analytics,https://www.googleapis.com/auth/tasks,https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata,https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
generic_api_key
stringRequired

Connecting to Google Super

Create an auth config

Use the dashboard to create an auth config for the Google Super toolkit. This allows you to connect multiple Google Super accounts to Composio for agents to use.

1

Select App

Navigate to [Google Super](https://platform.composio.dev?next_page=/marketplace/Google Super).

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Google Super Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4googlesuper_auth_config_id = "ac_YOUR_GOOGLESUPER_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11 connection_request = composio.connected_accounts.initiate(
12 user_id=user_id,
13 auth_config_id=auth_config_id,
14 )
15
16 print(
17 f"Visit this URL to authenticate Google Super: {connection_request.redirect_url}"
18 )
19
20 # This will wait for the auth flow to be completed
21 connection_request.wait_for_connection(timeout=15)
22 return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, googlesuper_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4googlesuper_auth_config_id = "ac_YOUR_GOOGLESUPER_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Google Super for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, googlesuper_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Google Super toolkit’s playground](https://app.composio.dev/app/Google Super)

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Delete ACL Rule

Description

Deletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain.

Action Parameters

calendar_id
stringRequired
rule_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get ACL Rule

Description

Retrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain.

Action Parameters

calendar_id
stringRequired
rule_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create ACL Rule

Description

Creates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain.

Action Parameters

calendar_id
stringRequired
role
stringRequired
scope
objectRequired
send_notifications

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch ACL Rule

Description

Updates an existing access control rule for a calendar using patch semantics (partial update). This allows modifying specific fields without affecting other properties. IMPORTANT: The ACL rule must already exist on the calendar. This action cannot create new rules. If you receive a 404 Not Found error, the rule does not exist - use ACL insert to create it first, or use ACL list to verify available rules. Each patch request consumes three quota units. For domain-type ACL rules, if PATCH fails with 500 error, this action will automatically fallback to UPDATE method.

Action Parameters

calendar_id
stringRequired
role
rule_id
stringRequired
scope
send_notifications

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Watch ACL Changes

Description

Tool to watch for changes to ACL resources. Use when you need to set up real-time notifications for access control list modifications on a calendar.

Action Parameters

address
stringRequired
calendarId
stringRequired
id
stringRequired
maxResults
pageToken
params
showDeleted
syncToken
token
type
stringDefaults to web_hook

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Add Enrichment

Description

Adds an enrichment at a specified position in a defined album.

Action Parameters

albumId
stringRequired
albumPosition
object
newEnrichmentItem
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Add file sharing preference

Description

Modifies sharing permissions for an existing Google Drive file, granting a specified role to a user, group, domain, or 'anyone'.

Action Parameters

domain
email_address
file_id
stringRequired
role
stringRequired
transfer_ownership
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Modify email labels

Description

Adds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid (use 'listLabels' for custom label IDs).

Action Parameters

add_label_ids
array
message_id
stringRequired
remove_label_ids
array
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Add or remove to customer list

Description

AddOrRemoveToCustomerList Tool will add a contact to a customer list in Google Ads. Note: It takes 6 to 12 hours for changes to be reflected in the customer list.

Action Parameters

emails
arrayRequired
operation
stringDefaults to create
resource_name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Add Shared Drive Member

Description

Tool to add a member (user/group/domain) to a Shared Drive with a specified role. Use when you need to grant access to a Shared Drive, ensuring supportsAllDrives is set correctly.

Action Parameters

domain
drive_id
stringRequired
email_address
email_message
role
stringRequired
send_notification_email
type
stringRequired
use_domain_admin_access

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Add Sheet to Existing Spreadsheet

Description

Adds a new sheet (worksheet) to an existing spreadsheet. REQUIRES spreadsheetId parameter to identify which spreadsheet to modify. Use this tool to create a new tab within an existing Google Sheet, optionally specifying its title, index, size, and other properties. REQUIRED PARAMETER: - spreadsheetId: MUST be provided to identify the target spreadsheet. Use 'Search Spreadsheets' action if you need to find it by name IMPORTANT: - Sheet names must be unique within the spreadsheet - For tab colors, use EITHER rgbColor OR themeColor, never both - Index must be less than or equal to the current number of sheets - CONCURRENCY WARNING: Do not use 'index' when creating multiple sheets in parallel - this causes 'index is too high' errors. For parallel creation, omit the index field and let sheets be added at the end Common use cases: - Add a new sheet with a specific name - Insert a sheet at a specific position - Create a sheet with custom colors and formatting

Action Parameters

properties
spreadsheetId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Aggregate Column Data

Description

Searches for rows where a specific column matches a value and performs mathematical operations on data from another column.

Action Parameters

case_sensitive
booleanDefaults to True
has_header_row
booleanDefaults to True
operation
stringRequired
percentage_total
search_column
search_value
sheet_name
stringRequired
spreadsheet_id
stringRequired
target_column
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Audiences

Description

Tool to list Audiences on a property. Use when you need to retrieve audience configurations for a Google Analytics property. Audiences created before 2020 may not be supported.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Channel Groups

Description

Tool to list ChannelGroups on a property. Use when you need to retrieve channel groups that categorize traffic sources in Analytics reports.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Conversion Events

Description

Tool to list conversion events on a property. Use when you need to retrieve conversion events configured for a given property.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Custom Dimensions

Description

Tool to list CustomDimensions on a property. Use when you need to retrieve custom dimensions configured for a given property.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Measurement Protocol Secrets

Description

Tool to list MeasurementProtocolSecrets under a data stream. Use when you need to retrieve measurement protocol secrets for server-side event tracking.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List DataStreams

Description

Tool to list DataStreams on a property. Use when you need to retrieve data stream configurations for a Google Analytics property.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Expanded Data Sets

Description

Tool to list ExpandedDataSets on a property. Use when you need to retrieve expanded data set configurations for a Google Analytics 360 property.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Google Ads Links

Description

Tool to list GoogleAdsLinks on a property. Use when you need to retrieve Google Ads account links configured for a Google Analytics property. Supports pagination for large result sets.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Search Ads 360 Links

Description

Tool to list all SearchAds360Links on a property. Use when you need to retrieve all Search Ads 360 links for a given Google Analytics property. Supports pagination for large result sets.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Append Dimension

Description

Tool to append new rows or columns to a sheet, increasing its size. Use when you need to add empty rows or columns to an existing sheet.

Action Parameters

dimension
stringRequired
length
integerRequired
sheet_id
integerRequired
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Autocomplete Place Predictions

Description

Returns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches. Returns up to five predictions ordered by relevance.

Action Parameters

includePureServiceAreaBusinesses
includeQueryPredictions
includedPrimaryTypes
includedRegionCodes
input
stringRequired
inputOffset
languageCode
locationBias
locationRestriction
origin
regionCode
sessionToken

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Add Media Items

Description

Adds one or more media items to an album in Google Photos.

Action Parameters

albumId
stringRequired
mediaItemIds
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Create Media Items

Description

Unified action to upload media files and create them as items in Google Photos.

Action Parameters

albumId
stringRequired
albumPosition
object
files
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch delete Gmail messages

Description

Tool to permanently delete multiple Gmail messages in bulk. Use when you need to efficiently remove large numbers of emails (e.g., retention enforcement, mailbox hygiene).

Action Parameters

messageIds
arrayRequired
userId
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Events

Description

Execute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. Use this to materially reduce round-trips for bulk operations like migrations, cleanup, or large-scale updates.

Action Parameters

fail_fast
boolean
operations
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Execute Google Tasks Operations

Description

Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results. Use this to reduce LLM tool invocations when performing bulk operations like updating many tasks, moving tasks, or deleting multiple items. Note: Each sub-request still counts toward API quota; batching primarily reduces HTTP overhead and tool call count.

Action Parameters

max_requests
integerDefaults to 1000
requests
arrayRequired
validate_paths
booleanDefaults to True

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch get spreadsheet

Description

Retrieves data from specified cell ranges in a Google Spreadsheet.

Action Parameters

dateTimeRenderOption
stringDefaults to SERIAL_NUMBER
empty_strings_filtered
boolean
ranges
array
spreadsheet_id
stringRequired
valueRenderOption
stringDefaults to FORMATTED_VALUE

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Get Media Items

Description

Returns the list of media items for the specified media item identifiers.

Action Parameters

mediaItemIds
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch modify Gmail messages

Description

Modify labels on multiple Gmail messages in one efficient API call. Supports up to 1,000 messages per request for bulk operations like archiving, marking as read/unread, or applying custom labels.

Action Parameters

addLabelIds
messageIds
arrayRequired
removeLabelIds
userId
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Run Pivot Reports

Description

Tool to return multiple pivot reports in a batch for a GA4 property. Use when you need to fetch multiple pivot table reports with multi-dimensional analysis in a single request.

Action Parameters

property
stringRequired
requests
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Run Reports

Description

Tool to return multiple analytics data reports in a batch. Use when you need to fetch multiple reports for one GA4 property in a single request.

Action Parameters

property
stringRequired
requests
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch update spreadsheet

Description

Updates a specified range in a Google Sheet with given values, or appends them as new rows if `first_cell_location` is omitted. Auto-expands grid for large datasets, preventing range errors. Requirements: Target sheet must exist and spreadsheet must contain at least one worksheet.

Action Parameters

first_cell_location
includeValuesInResponse
boolean
sheet_name
stringRequired
spreadsheet_id
stringRequired
valueInputOption
stringDefaults to USER_ENTERED
values
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Update Values by Data Filter

Description

Tool to update values in ranges matching data filters. Use when you need to update specific data in a Google Sheet based on criteria rather than fixed cell ranges.

Action Parameters

data
arrayRequired
includeValuesInResponse
responseDateTimeRenderOption
Defaults to SERIAL_NUMBER
responseValueRenderOption
Defaults to FORMATTED_VALUE
spreadsheetId
stringRequired
valueInputOption
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Bulk Insert Tasks

Description

Creates multiple tasks in a Google Tasks list in a single operation using HTTP batching. Use when you need to create many tasks efficiently (reducing round-trips compared to individual insert calls).

Action Parameters

batch_size
Defaults to 50
tasklist_id
stringRequired
tasks
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Remove Calendar from List

Description

Tool to remove a calendar from the user's calendar list. Use when you need to unsubscribe from or hide a calendar from the user's list.

Action Parameters

calendar_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Single Calendar by ID

Description

Retrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID. This action requires a calendarId parameter and returns details about that one calendar only. NOTE: This does NOT list all calendars. To list all calendars in the user's calendar list, use GOOGLECALENDAR_CALENDAR_LIST_LIST instead.

Action Parameters

calendarId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Insert Calendar into List

Description

Inserts an existing calendar into the user's calendar list.

Action Parameters

background_color
color_id
color_rgb_format
default_reminders
foreground_color
hidden
id
stringRequired
notification_settings
selected
summary_override

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch Calendar List Entry

Description

Updates an existing calendar on the user's calendar list using patch semantics. This method allows partial updates, modifying only the specified fields.

Action Parameters

backgroundColor
calendar_id
stringRequired
colorId
colorRgbFormat
defaultReminders
foregroundColor
hidden
notificationSettings
selected
summaryOverride

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Calendar List Entry

Description

Updates an existing entry on the user\'s calendar list.

Action Parameters

backgroundColor
calendar_id
stringRequired
colorId
colorRgbFormat
defaultReminders
foregroundColor
hidden
notificationSettings
selected
summaryOverride

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Watch Calendar List

Description

Watch for changes to CalendarList resources using push notifications. Use this to receive real-time updates when calendar list entries are modified.

Action Parameters

address
stringRequired
expiration
id
stringRequired
params
token
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Calendar

Description

Deletes a secondary calendar that you own or have delete permissions on. You cannot delete your primary calendar or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead.

Action Parameters

calendar_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Calendar

Description

Updates metadata for a calendar.

Action Parameters

calendarId
stringRequired
description
location
summary
stringRequired
timeZone

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Stop Channel

Description

Tool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription.

Action Parameters

id
stringRequired
resourceId
stringRequired
token

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Check Compatibility

Description

Tool to list dimensions and metrics compatible with a GA4 report request. Use when you need to validate compatibility of chosen dimensions or metrics before running a report.

Action Parameters

compatibilityFilter
dimensionFilter
dimensions
metricFilter
metrics
property
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Clear Basic Filter

Description

Tool to clear the basic filter from a sheet. Use when you need to remove an existing basic filter from a specific sheet within a Google Spreadsheet.

Action Parameters

sheet_id
integerRequired
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Clear Calendar

Description

Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.

Action Parameters

calendar_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Clear tasks

Description

Permanently clears all completed tasks from a specified Google Tasks list; this action is destructive and idempotent.

Action Parameters

tasklist
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Clear spreadsheet values

Description

Clears cell content (preserving formatting and notes) from a specified A1 notation range in a Google Spreadsheet; the range must correspond to an existing sheet and cells.

Action Parameters

range
stringRequired
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Color Definitions

Description

Returns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Compute Route Matrix

Description

Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes.

Action Parameters

destinations
arrayRequired
fieldMask
stringDefaults to originIndex,destinationIndex,duration,distanceMeters,status,condition
languageCode
stringDefaults to en-US
origins
arrayRequired
routingPreference
Defaults to TRAFFIC_AWARE
travelMode
stringDefaults to DRIVE
units
stringDefaults to IMPERIAL

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Copy Google Document

Description

Tool to create a copy of an existing Google Document. Use this to duplicate a document, for example, when using an existing document as a template. The copied document will have a default title (e.g., 'Copy of [original title]') if no new title is provided, and will be placed in the user's root Google Drive folder.

Action Parameters

document_id
stringRequired
title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Copy file

Description

Duplicates an existing file in Google Drive, identified by its `file_id`.

Action Parameters

file_id
stringRequired
new_title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Album

Description

Creates a new album in Google Photos.

Action Parameters

coverPhotoBaseUrl
string
coverPhotoMediaItemId
string
id
string
isWriteable
boolean
mediaItemsCount
string
productUrl
string
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Audience Export

Description

Tool to create an audience export. Use after configuring the audience and dimensions to produce a long-running Operation.

Action Parameters

audience
stringRequired
dimensions
arrayRequired
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Audience List

Description

Tool to create an audience list. Use when you need to define and asynchronously populate a new AudienceList resource under a GA4 property.

Action Parameters

audience
stringRequired
dimensions
arrayRequired
parent
stringRequired
webhookNotification

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Chart in Google Sheets

Description

Create a chart in a Google Sheets spreadsheet using the specified data range and chart type. Conditional requirements: - Provide either a simple chart via chart_type + data_range (basicChart), OR supply a full chart_spec supporting all chart types. Exactly one approach should be used. - When using chart_spec, set exactly one of the union fields (basicChart | pieChart | bubbleChart | candlestickChart | histogramChart | waterfallChart | treemapChart | orgChart | scorecardChart).

Action Parameters

background_blue
background_green
background_red
chart_spec
chart_type
stringRequired
data_range
stringRequired
legend_position
stringDefaults to BOTTOM_LEGEND
sheet_id
integerRequired
spreadsheet_id
stringRequired
subtitle
title
x_axis_title
y_axis_title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Comment

Description

Tool to create a comment on a file. Use when you need to add a new comment to a specific file in Google Drive.

Action Parameters

anchor
content
stringRequired
file_id
stringRequired
quoted_file_content_mime_type
quoted_file_content_value

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create customer list

Description

Creates a customer list in Google Ads. Note: Requires an authenticated Google Ads connection with customer_id configured.

Action Parameters

description
string
name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a document

Description

Creates a new Google Docs document using the provided title as filename and inserts the initial text at the beginning if non-empty, returning the document's ID and metadata (excluding body content).

Action Parameters

text
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Document Markdown

Description

Creates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text.

Action Parameters

markdown_text
string
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Shared Drive

Description

Tool to create a new shared drive. Use when you need to programmatically create a new shared drive for collaboration or storage.

Action Parameters

backgroundImageFile
colorRgb
hidden
name
stringRequired
requestId
themeId

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create email draft

Description

Creates a Gmail email draft. All recipients (recipient_email, cc, bcc) are optional - drafts can be created without recipients and edited later before sending. At least one of subject or body must be provided. Supports To/Cc/Bcc, subject, plain/HTML body (ensure `is_html=True` for HTML), attachments, and threading. When creating a draft reply to an existing thread (thread_id provided), leave subject empty to stay in the same thread; setting a subject will create a NEW thread instead.

Action Parameters

attachment
bcc
array
body
cc
array
extra_recipients
array
is_html
boolean
recipient_email
subject
thread_id
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Event

Description

Create a Google Calendar event using `start_datetime` plus `event_duration_hour` and `event_duration_minutes` fields to derive the end time. Requires calendar write access. The organizer is added as an attendee unless `exclude_organizer` is True. By default, attempts to create a Google Meet link for the event (create_meeting_room defaults to True). Workspace accounts will receive a Meet link, while personal Gmail accounts will gracefully fallback to creating an event without a Meet link when conference creation fails. Set create_meeting_room to False to explicitly skip Meet link creation. Example request to create event for 1 hour 30 minutes: { "calendar_id": "primary", "start_datetime": "2025-01-16T13:00:00", "timezone": "America/New_York", "event_duration_hour": 1, "event_duration_minutes": 30, "summary": "Client sync", "attendees": [{"email": "guest@example.com"}] }

Action Parameters

attendees
birthdayProperties
calendar_id
stringDefaults to primary
create_meeting_room
Defaults to True
description
eventType
stringDefaults to default
event_duration_hour
integer
event_duration_minutes
integerDefaults to 30
exclude_organizer
boolean
extended_properties
focusTimeProperties
guestsCanInviteOthers
guestsCanSeeOtherGuests
guests_can_modify
boolean
location
outOfOfficeProperties
recurrence
send_updates
start_datetime
stringRequired
summary
timezone
transparency
stringDefaults to opaque
visibility
stringDefaults to default
workingLocationProperties

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Expanded Data Set

Description

Tool to create an expanded data set for a property. Use when you need to combine specific dimensions and metrics into a custom dataset after property creation.

Action Parameters

expandedDataSet
objectRequired
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create File or Folder

Description

Creates a new file or folder with metadata. Use to create empty files or folders, or files with content by providing it in the request body (though this action primarily focuses on metadata creation).

Action Parameters

description
fields
mimeType
name
parents
starred

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a File from Text

Description

Creates a new file in Google Drive from provided text content (up to 10MB), supporting various formats including automatic conversion to Google Workspace types.

Action Parameters

file_name
stringRequired
mime_type
stringDefaults to text/plain
parent_id
text_content
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a folder

Description

Creates a new folder in Google Drive, optionally within an EXISTING parent folder specified by its ID or name. The parent folder MUST already exist - use GOOGLEDRIVE_FIND_FOLDER first to verify the parent exists or find its ID.

Action Parameters

name
stringRequired
parent_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Footnote

Description

Tool to create a new footnote in a Google Document. Use this when you need to add a footnote at a specific location or at the end of the document body.

Action Parameters

documentId
stringRequired
endOfSegmentLocation
location

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Google Sheet

Description

Creates a new Google Spreadsheet in Google Drive. If a title is provided, the spreadsheet will be created with that name. If no title is provided, Google will create a spreadsheet with a default name like 'Untitled spreadsheet'.

Action Parameters

title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Header

Description

Tool to create a new header in a Google Document, optionally with text content. Use this tool when you need to add a header to a document. You can provide: - document_id: The ID of the document (required) - type: The header type (DEFAULT is the standard header) - text: Optional text content to add to the header - section_break_location: Optional location for section-specific headers

Action Parameters

documentId
stringRequired
sectionBreakLocation
text
type
stringDefaults to DEFAULT

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create label

Description

Creates a new label with a unique name in the specified user's Gmail account.

Action Parameters

background_color
label_list_visibility
stringDefaults to labelShow
label_name
stringRequired
message_list_visibility
stringDefaults to show
text_color
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a Meet

Description

Creates a new Google Meet space, optionally configuring its access type and entry point access controls.

Action Parameters

access_type
string
entry_point_access
string

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Named Range

Description

Tool to create a new named range in a Google Document. Use this to assign a name to a specific part of the document for easier reference or programmatic manipulation.

Action Parameters

documentId
stringRequired
name
stringRequired
rangeEndIndex
integerRequired
rangeSegmentId
rangeStartIndex
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Paragraph Bullets

Description

Tool to add bullets to paragraphs within a specified range in a Google Document. Use when you need to format a list or a set of paragraphs as bullet points.

Action Parameters

createParagraphBullets
objectRequired
document_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Recurring Audience List

Description

Tool to create a recurring audience list that automatically generates new audience lists daily based on the latest data. Use when you need to automate audience list creation and reduce quota token consumption.

Action Parameters

activeDaysRemaining
audience
stringRequired
dimensions
arrayRequired
parent
stringRequired
webhookNotification

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Reply

Description

Tool to create a reply to a comment in Google Drive. Use when you need to respond to an existing comment on a file.

Action Parameters

action
comment_id
stringRequired
content
stringRequired
fields
file_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Rollup Property

Description

Tool to create a GA4 Roll-up Property and optionally initial source links.

Action Parameters

account
stringRequired
displayName
stringRequired
sourceProperties
timeZone
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Shortcut to File/Folder

Description

Tool to create a shortcut to a file or folder in Google Drive. Use when you need to link to an existing Drive item from another location without duplicating it.

Action Parameters

ignoreDefaultVisibility
includeLabels
includePermissionsForView
keepRevisionForever
name
stringRequired
supportsAllDrives
target_id
stringRequired
target_mime_type

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Slides from Markdown

Description

Creates a new Google Slides presentation from Markdown text. Automatically splits content into slides using '---' separators and applies appropriate templates based on content structure.

Action Parameters

markdown_text
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create spreadsheet column

Description

Creates a new column in a Google Spreadsheet. Specify the target sheet using sheet_id (numeric) or sheet_name (text). If neither is provided, defaults to the first sheet (sheet_id=0).

Action Parameters

inherit_from_before
boolean
insert_index
integer
sheet_id
sheet_name
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create spreadsheet row

Description

Inserts a new, empty row into a specified sheet of a Google Spreadsheet at a given index, optionally inheriting formatting from the row above.

Action Parameters

inherit_from_before
boolean
insert_index
integer
sheet_id
sheet_name
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a task list

Description

Creates a new task list with the specified title.

Action Parameters

tasklist_title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Comment

Description

Deletes a comment from a file. Use when you need to remove a specific comment from a Google Drive file.

Action Parameters

comment_id
stringRequired
file_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Content Range in Document

Description

Tool to delete a range of content from a Google Document. Use when you need to remove a specific portion of text or other structural elements within a document.

Action Parameters

document_id
stringRequired
range
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Dimension (Rows/Columns)

Description

Tool to delete specified rows or columns from a sheet in a Google Spreadsheet. Use when you need to remove a range of rows or columns.

Action Parameters

delete_dimension_request
dimension
end_index
include_spreadsheet_in_response
response_include_grid_data
response_ranges
sheet_id
sheet_name
spreadsheet_id
stringRequired
start_index

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Draft

Description

Permanently deletes a specific Gmail draft using its ID; ensure the draft exists and the user has necessary permissions for the given `user_id`.

Action Parameters

draft_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Shared Drive

Description

Tool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified).

Action Parameters

allowItemDeletion
driveId
stringRequired
useDomainAdminAccess

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete event

Description

Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); this action is idempotent and raises a 404 error if the event is not found.

Action Parameters

calendar_id
stringDefaults to primary
event_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Header

Description

Deletes the header from the specified section or the default header if no section is specified. Use this tool to remove a header from a Google Document.

Action Parameters

document_id
stringRequired
header_id
stringRequired
tab_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete label from account (permanent)

Description

Permanently DELETES a user-created Gmail label from the account (not from a message). WARNING: This action DELETES the label definition itself, removing it from all messages. System labels (INBOX, SENT, UNREAD, etc.) cannot be deleted. To add/remove labels from specific messages, use GMAIL_ADD_LABEL_TO_EMAIL action instead.

Action Parameters

label_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete message

Description

Permanently deletes a specific email message by its ID from a Gmail mailbox; for `user_id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access.

Action Parameters

message_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Named Range

Description

Tool to delete a named range from a Google Document. Use when you need to remove a previously defined named range by its ID or name.

Action Parameters

deleteNamedRange
objectRequired
document_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Paragraph Bullets

Description

Tool to remove bullets from paragraphs within a specified range in a Google Document. Use when you need to clear bullet formatting from a section of a document.

Action Parameters

document_id
stringRequired
range
objectRequired
tab_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Permission

Description

Deletes a permission from a file by permission ID. IMPORTANT: You must first call GOOGLEDRIVE_LIST_PERMISSIONS to get valid permission IDs. Use when you need to revoke access for a specific user or group from a file.

Action Parameters

file_id
stringRequired
permission_id
stringRequired
supportsAllDrives
useDomainAdminAccess

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Reply

Description

Tool to delete a specific reply by reply ID. Use when you need to remove a reply from a comment on a file.

Action Parameters

comment_id
stringRequired
file_id
stringRequired
reply_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Sheet

Description

Tool to delete a sheet (worksheet) from a spreadsheet. Use when you need to remove a specific sheet from a Google Sheet document.

Action Parameters

sheet_id
integerRequired
spreadsheetId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Table

Description

Tool to delete an entire table from a Google Document. Use when you have the document ID and the specific start and end index of the table element to be removed. The table's range can be found by inspecting the document's content structure.

Action Parameters

document_id
stringRequired
segment_id
tab_id
table_end_index
integerRequired
table_start_index
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Table Column

Description

Tool to delete a column from a table in a Google Document. Use this tool when you need to remove a specific column from an existing table within a document.

Action Parameters

document_id
stringRequired
requests
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Table Row

Description

Tool to delete a row from a table in a Google Document. Use when you need to remove a specific row from an existing table.

Action Parameters

documentId
stringRequired
tableCellLocation
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete task

Description

Deletes a specified task from a Google Tasks list. Both tasklist_id and task_id are required parameters. Important: The Google Tasks API does not support deleting tasks by task_id alone - you must specify which task list contains the task. Use 'List Task Lists' to get available list IDs, then 'List Tasks' to find the task_id within that list.

Action Parameters

task_id
stringRequired
tasklist_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete task list

Description

Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible.

Action Parameters

tasklist_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Distance Matrix (Legacy)

Description

DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations. This API only works with API keys (no OAuth2 support). Use the modern 'Compute Route Matrix' action instead, which supports OAuth2 authentication. Supports different modes of transportation and options like departure/arrival times.

Action Parameters

arrival_time
avoid
departure_time
destinations
stringRequired
key
language
mode
Defaults to driving
origins
stringRequired
region
traffic_model
transit_mode
transit_routing_preference
units

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Download a file from Google Drive

Description

Downloads a file from Google Drive by its ID. For Google Workspace documents (Docs, Sheets, Slides), optionally exports to a specified `mime_type`. For other file types, downloads in their native format regardless of mime_type. Examples: Export a Google Doc to plain text: {"file_id": "1N2o5xQWmAbCdEfGhIJKlmnOPq", "mime_type": "text/plain"} Download a Google Sheet as CSV: {"file_id": "1ZyXwVuTsRqPoNmLkJiHgFeDcB", "mime_type": "text/csv"}

Action Parameters

file_id
stringRequired
mime_type

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Download file via operation

Description

Tool to download file content using long-running operations. Use when you need to download Google Vids files or export Google Workspace documents as part of a long-running operation. Operations are valid for 24 hours from creation.

Action Parameters

file_id
stringRequired
mime_type
revision_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create a calendar

Description

Creates a new, empty Google Calendar with the specified title (summary).

Action Parameters

summary
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Edit File

Description

Updates an existing Google Drive file by overwriting its entire content with new text (max 10MB). This action allows users to change the content of a Drive file, ensuring that the latest updates are saved and available without creating a new file. Users can specify different MIME types for the content being uploaded, facilitating various file formats.

Action Parameters

content
stringRequired
file_id
stringRequired
mime_type
stringDefaults to text/plain

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Empty Trash

Description

Tool to permanently delete all of the user's trashed files. Use when you want to empty the trash in Google Drive. This action allows you to permanently remove all files that are currently in the trash of Google Drive. It can be applied to files in both the user's root trash and shared drives, ensuring a complete removal of unwanted files.

Action Parameters

driveId
enforceSingleParent

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: End active conference

Description

Ends an active conference in a Google Meet space. REQUIRES 'space_name' parameter (e.g., 'spaces/jQCFfuBOdN5z' or just 'jQCFfuBOdN5z'). Use when you need to terminate an ongoing conference in a specified space. This operation only succeeds if a conference is actively running in the space. You must always provide the space_name to identify which space's conference to end.

Action Parameters

space_name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Event

Description

Retrieves a SINGLE event by its unique event_id (REQUIRED). This action does NOT list or search events - it fetches ONE specific event when you already know its ID. If you want to list events within a time range, search for events, or filter by criteria like time_min/time_max, use GOOGLECALENDAR_EVENTS_LIST instead.

Action Parameters

calendar_id
stringDefaults to primary
event_id
stringRequired
max_attendees
time_zone

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Import Event

Description

Tool to import an event as a private copy to a calendar. Use when you need to add an existing event to a calendar using its iCalUID. Only events with eventType='default' can be imported.

Action Parameters

attachments
attendees
calendar_id
stringDefaults to primary
colorId
conferenceDataVersion
description
end
objectRequired
extendedProperties
guestsCanInviteOthers
guestsCanModify
guestsCanSeeOtherGuests
iCalUID
stringRequired
location
recurrence
reminders
sequence
source
start
objectRequired
status
summary
supportsAttachments
transparency
visibility

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Event Instances

Description

Returns instances of the specified recurring event.

Action Parameters

calendarId
stringRequired
eventId
stringRequired
maxAttendees
maxResults
originalStart
pageToken
showDeleted
timeMax
timeMin
timeZone

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Events

Description

Returns events on the specified calendar.

Action Parameters

alwaysIncludeEmail
calendarId
stringDefaults to primary
eventTypes
iCalUID
maxAttendees
maxResults
orderBy
pageToken
privateExtendedProperty
q
sharedExtendedProperty
showDeleted
showHiddenInvitations
singleEvents
syncToken
timeMax
timeMin
timeZone
updatedMin

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Events from All Calendars

Description

Return a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars.

Action Parameters

calendar_ids
event_types
max_results_per_calendar
q
show_deleted
boolean
single_events
booleanDefaults to True
time_max
stringRequired
time_min
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Move Event

Description

Moves an event to another calendar, i.e., changes an event's organizer.

Action Parameters

calendar_id
stringRequired
destination
stringRequired
event_id
stringRequired
send_updates

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Watch Events

Description

Watch for changes to Events resources.

Action Parameters

address
stringRequired
calendarId
stringRequired
id
stringRequired
params
payload
token
type
stringDefaults to web_hook

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Execute SQL on Spreadsheet

Description

Execute SQL queries against Google Sheets tables. Supports SELECT, INSERT, UPDATE, and DELETE operations with familiar SQL syntax. Tables are automatically detected and mapped from the spreadsheet structure.

Action Parameters

delete_method
stringDefaults to clear
dry_run
boolean
spreadsheet_id
stringRequired
sql
stringRequired

Action Response

affected_rows
integerRequired
data
array
error
message
stringRequired
operation
stringRequired
successful
booleanRequired
table_schema
array

Tool Name: Export Google Doc as PDF

Description

Tool to export a Google Docs file as PDF using the Google Drive API. Use when you need to generate a PDF version of a Google Docs document for download or distribution. Note: Google Drive enforces a 10MB limit on export content.

Action Parameters

file_id
stringRequired
filename

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Fetch emails

Description

Fetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval.

Action Parameters

ids_only
boolean
include_payload
booleanDefaults to True
include_spam_trash
boolean
label_ids
array
max_results
integerDefaults to 1
page_token
query
user_id
stringDefaults to me
verbose
booleanDefaults to True

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Fetch message by message ID

Description

Fetches a specific email message by its ID, provided the `message_id` exists and is accessible to the authenticated `user_id`.

Action Parameters

format
stringDefaults to full
message_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Fetch Message by Thread ID

Description

Retrieves messages from a Gmail thread using its `thread_id`, where the thread must be accessible by the specified `user_id`.

Action Parameters

page_token
string
thread_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Modify File Labels

Description

Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified. Use when you need to programmatically change labels on a Google Drive file, such as adding, updating, or removing them.

Action Parameters

file_id
stringRequired
kind
Defaults to drive#modifyLabelsRequest
label_modifications
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Find event

Description

Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types; ensure `timeMin` is not chronologically after `timeMax` if both are provided.

Action Parameters

calendar_id
stringDefaults to primary
event_types
arrayDefaults to ['birthday', 'default', 'focusTime', 'outOfOffice', 'workingLocation']
max_results
integerDefaults to 10
order_by
page_token
query
show_deleted
single_events
booleanDefaults to True
timeMax
timeMin
updated_min

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Find file

Description

The comprehensive Google Drive search tool that handles all file and folder discovery needs. Use this for any file finding task - from simple name searches to complex queries with date filters, MIME types, permissions, custom properties, folder scoping, and more. Searches across My Drive and shared drives with full metadata support. Examples: - Find PDFs: q="mimeType = 'application/pdf'" - Find recent files: q="modifiedTime > '2024-01-01T00:00:00'" - Search by name: q="name contains 'report'" - Files in folder: folderId="abc123" or q="'FOLDER_ID' in parents"

Action Parameters

corpora
Defaults to allDrives
driveId
editors_field_removed
fields
Defaults to *
folder_id
includeItemsFromAllDrives
Defaults to True
include_labels
include_permissions_for_view
orderBy
pageSize
Defaults to 100
pageToken
q
spaces
Defaults to drive
supportsAllDrives
Defaults to True

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Find folder

Description

Tool to find a folder in Google Drive by its name and optionally a parent folder. Use when you need to locate a specific folder to perform further actions like creating files in it or listing its contents.

Action Parameters

full_text_contains
full_text_not_contains
modified_after
name_contains
name_exact
name_not_contains
parent_folder_id
starred

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Find free slots

Description

Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range (defaults to the current day UTC if `time_min`/`time_max` are omitted). Returns busy intervals enriched with event details and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods.

Action Parameters

calendar_expansion_max
integerDefaults to 50
group_expansion_max
integerDefaults to 100
items
arrayDefaults to ['primary']
time_max
time_min
timezone
stringDefaults to UTC

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Find and Replace in Spreadsheet

Description

Tool to find and replace text in a Google Spreadsheet. Use when you need to fix formula errors, update values, or perform bulk text replacements across cells. Common use cases: - Fix #ERROR! cells by replacing with empty string or correct formula - Update old values with new ones across multiple cells - Fix formula references or patterns - Clean up data formatting issues

Action Parameters

allSheets
endColumnIndex
endRowIndex
find
stringRequired
matchCase
matchEntireCell
range
rangeSheetId
replace
stringRequired
searchByRegex
sheetId
sheetName
spreadsheetId
stringRequired
startColumnIndex
startRowIndex

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Find worksheet by title

Description

Finds a worksheet by its exact, case-sensitive title within a Google Spreadsheet; returns a boolean indicating if found and the matched worksheet's metadata when found, or None when not found.

Action Parameters

spreadsheet_id
stringRequired
worksheet_title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Format cell

Description

Applies text and background cell formatting to a specified range in a Google Sheets worksheet.

Action Parameters

blue
numberDefaults to 0.9
bold
boolean
end_column_index
end_row_index
fontSize
integerDefaults to 10
green
numberDefaults to 0.9
italic
boolean
range
red
numberDefaults to 0.9
spreadsheet_id
stringRequired
start_column_index
start_row_index
strikethrough
boolean
underline
boolean
worksheet_id
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Forward email message

Description

Forward an existing Gmail message to specified recipients, preserving original body and attachments.

Action Parameters

additional_text
message_id
stringRequired
recipient_email
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Query Free/Busy Information

Description

Returns free/busy information for a set of calendars.

Action Parameters

calendarExpansionMax
groupExpansionMax
items
arrayRequired
timeMax
stringRequired
timeMin
stringRequired
timeZone

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Generate File IDs

Description

Generates a set of file IDs which can be provided in create or copy requests. Use when you need to pre-allocate IDs for new files or copies.

Action Parameters

count
space
type

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Geocode Address

Description

DEPRECATED: Legacy API to convert street addresses into geographic coordinates (latitude and longitude). This API works best with API key authentication. For OAuth connections without an API key, you may need to provide the 'key' parameter or use the newer 'Text Search' action instead. Use when you need to geocode an address or location to get its precise latitude/longitude coordinates.

Action Parameters

address
bounds
components
key
language
region

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Geocode Address With Query

Description

Tool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API.

Action Parameters

address_query
stringRequired
language_code
region_code

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Geocode Destinations

Description

Tool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations, landmarks, entrances, and navigation points. Use when you need comprehensive destination data for an address, place ID, or geographic coordinates.

Action Parameters

addressQuery
languageCode
locationQuery
place
regionCode
travelModes

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Reverse Geocode Location

Description

Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates.

Action Parameters

languageCode
latitude
numberRequired
longitude
numberRequired
regionCode
types

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Reverse Geocode Location With Query

Description

Tool to convert geographic coordinates to human-readable addresses using a location query parameter. Use when you need reverse geocoding with coordinates in a single string format.

Action Parameters

granularity
languageCode
locationQuery
stringRequired
regionCode
types

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Geocode Place by ID

Description

Tool to perform geocode lookup using a place identifier to retrieve address and coordinates. Use when you need to get detailed geographic information for a specific Google Place ID.

Action Parameters

languageCode
place_id
stringRequired
regionCode

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Geocoding API (Legacy)

Description

DEPRECATED: Legacy API to convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. This API only works with API keys (no OAuth2 support). Consider using the modern Places API (Text Search or Nearby Search) for similar functionality with OAuth2 authentication.

Action Parameters

address
bounds
components
extra_computations
key
language
latlng
location_type
place_id
region
result_type

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Geolocate Device

Description

Tool to determine location based on cell towers and WiFi access points. Use when you need to find the geographic location of a device using network infrastructure data.

Action Parameters

carrier
cellTowers
considerIp
Defaults to True
homeMobileCountryCode
homeMobileNetworkCode
radioType
wifiAccessPoints

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get 2D Map Tile

Description

Tool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations. Use when you need to download individual map tile images for roadmap, satellite, or terrain views. Requires a valid session token from the createSession endpoint.

Action Parameters

key
orientation
session
stringRequired
x
integerRequired
y
integerRequired
z
integerRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get 3D Tiles Root

Description

Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google's photorealistic tiles following the OGC 3D Tiles specification.

Action Parameters

key

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get about

Description

Tool to retrieve information about the user, the user's Drive, and system capabilities. Use when you need to check storage quotas, user details, or supported import/export formats.

Action Parameters

fields
stringDefaults to *

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Account

Description

Tool to retrieve a single Account by its resource name. Use when you need detailed account info after confirming the account resource name (e.g., accounts/100).

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Album

Description

Returns the album based on the specified albumId.

Action Parameters

albumId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Gmail attachment

Description

Retrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs.

Action Parameters

attachment_id
stringRequired
file_name
stringRequired
message_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Attribution Settings

Description

Tool to retrieve attribution configuration for a Google Analytics property. Use when you need to check attribution models, lookback windows, and conversion export settings.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Audience

Description

Tool to retrieve a single Audience configuration from a Google Analytics property. Use when you need detailed audience information including membership criteria and filter clauses.

Action Parameters

audienceId
stringRequired
propertyId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Audience Export

Description

Tool to get configuration metadata for an Audience Export. Use after creating an Audience Export to retrieve its status and details.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Audience List

Description

Tool to get configuration metadata about a specific audience list. Use after confirming the audience list resource name.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Auto-Forwarding Settings

Description

Tool to get the auto-forwarding setting for the specified account. Use when you need to retrieve the current auto-forwarding configuration including enabled status, forwarding email address, and message disposition.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Google Calendar

Description

Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access.

Action Parameters

calendar_id
stringDefaults to primary

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Campaign By Id

Description

GetCampaignById Tool will return details of a campaign in Google Ads.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get campaign by name

Description

GetCampaignByName Tool will run a SQL GetCampaignByName in Google Ads.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Changes Start Page Token

Description

Tool to get the starting pageToken for listing future changes in Google Drive. Use this when you need to track changes to files and folders.

Action Parameters

driveId
supportsAllDrives
supportsTeamDrives
teamDriveId

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Charts from Spreadsheet

Description

Tool to retrieve a list of all charts from a specified Google Sheets spreadsheet. Use when you need to get chart IDs and their specifications for embedding or referencing elsewhere, such as in Google Docs.

Action Parameters

spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Comment

Description

Tool to get a comment by ID. Use when you need to retrieve a specific comment from a Google Drive file and have both the file ID and comment ID.

Action Parameters

commentId
stringRequired
fileId
stringRequired
includeDeleted

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get conditional format rules

Description

List conditional formatting rules for each sheet (or a selected sheet) in a normalized, easy-to-edit form. Use when you need to view, audit, or prepare to modify conditional format rules.

Action Parameters

sheet_id
sheet_title
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get conference record

Description

Get conference record

Action Parameters

end_time
meeting_code
space_name
start_time

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get contacts

Description

Fetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination.

Action Parameters

include_other_contacts
booleanDefaults to True
page_token
string
person_fields
stringDefaults to emailAddresses,names,birthdays,genders
resource_name
stringDefaults to people/me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Conversion Event

Description

Tool to retrieve a conversion event (deprecated, use Key Events instead). Use after confirming the conversion event resource name.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get current date and time

Description

Gets the current date and time, allowing for a specific timezone offset.

Action Parameters

timezone

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get customer lists

Description

GetCustomerLists Tool will list all customer lists in Google Ads.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Data Retention Settings

Description

Tool to retrieve data retention configuration for a Google Analytics property. Use when you need to check event-level and user-level data retention durations and reset settings.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Data Sharing Settings

Description

Tool to retrieve data sharing configuration for a Google Analytics account. Use when you need to check which data sharing settings are enabled for an account, including sharing with Google support, sales teams, products, and benchmarking.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Data Validation Rules

Description

Tool to extract data validation rules from a Google Sheets spreadsheet. Use when you need to understand dropdown lists, allowed values, custom formulas, or other validation constraints for cells.

Action Parameters

includeEmpty
boolean
ranges
sheetId
sheetTitle
spreadsheetId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Directions (Legacy)

Description

DEPRECATED: Legacy API that fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes. This API only works with API keys (no OAuth2 support). Use the modern 'Get Route' action instead, which supports OAuth2 authentication.

Action Parameters

avoid
destination
stringRequired
language
stringDefaults to en
mode
stringDefaults to driving
origin
stringRequired
units
stringDefaults to imperial
waypoints

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get document by id

Description

Retrieves an existing Google Document by its ID; will error if the document is not found.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Shared Drive

Description

Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive.

Action Parameters

drive_id
stringRequired
use_domain_admin_access

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get File Metadata

Description

Tool to get a file's metadata by ID. Use when you need to retrieve the metadata for a specific file in Google Drive.

Action Parameters

fileId
stringRequired
includeLabels
includePermissionsForView
supportsAllDrives

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Google Signals Settings

Description

Tool to retrieve Google Signals configuration settings for a GA4 property. Use when you need to check whether Google Signals is enabled and the consent status for a property.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Key Event

Description

Tool to retrieve a Key Event. Use after confirming the key event resource name.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Language Settings

Description

Tool to retrieve the language settings for a Gmail user. Use when you need to determine the display language preference for the authenticated user or a specific Gmail account.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Download Photos Media Item

Description

Downloads a media item from Google Photos and returns it as a file.

Action Parameters

mediaItemId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Meet details

Description

Retrieve details of a Google Meet space using its unique identifier.

Action Parameters

space_name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Metadata

Description

Tool to get metadata for dimensions, metrics, and comparisons for a GA4 property. Use when you need to discover available fields before building a report.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Participant Details

Description

Retrieves detailed information about a specific participant from a Google Meet conference record. Returns participant details including user identity, display name, and meeting join/leave times. PREREQUISITE: You must first obtain the participant resource name. Either: 1. Use LIST_PARTICIPANT_SESSIONS with a conference record ID to get available participants and their resource names 2. Use LIST_CONFERENCE_RECORDS to get conference record IDs if you don't have one The 'name' parameter is REQUIRED and must be in the format: 'conferenceRecords/{conference_record}/participants/{participant}'

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get People

Description

Retrieves either a specific person's details (using `resource_name`) or lists 'Other Contacts' (if `other_contacts` is true), with `person_fields` specifying the data to return.

Action Parameters

other_contacts
boolean
page_size
integerDefaults to 10
page_token
string
person_fields
stringDefaults to emailAddresses,names,birthdays,genders
resource_name
stringDefaults to people/me
sync_token
string

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Permission

Description

Gets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive.

Action Parameters

fields
file_id
stringRequired
permission_id
stringRequired
supports_all_drives
use_domain_admin_access

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Place Details

Description

Retrieves comprehensive details for a place using its resource name (places/{place_id} format). Use when you need detailed information about a specific place.

Action Parameters

fieldMask
stringDefaults to id,displayName,formattedAddress
languageCode
name
stringRequired
regionCode
sessionToken

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Profile

Description

Retrieves key Gmail profile information (email address, message/thread totals, history ID) for a user.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Property

Description

Tool to retrieve a single GA4 Property by its resource name. Use when you need detailed property configuration including display name, time zone, currency, and other settings.

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Property Quotas Snapshot

Description

Tool to retrieve all property quotas organized by category for a given property. Use when you need to check current quota usage for a GA4 property.

Action Parameters

property
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get recordings by conference record ID

Description

Retrieves recordings from Google Meet for a given conference record ID.

Action Parameters

conferenceRecord_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Reply

Description

Tool to get a specific reply to a comment on a file. Use when you need to retrieve the details of a particular reply.

Action Parameters

commentId
stringRequired
fileId
stringRequired
includeDeleted
replyId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Revision

Description

Tool to get a specific revision's metadata by revision ID. Use when you need to retrieve information about a particular version of a file.

Action Parameters

acknowledge_abuse
file_id
stringRequired
revision_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Route

Description

Calculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps.

Action Parameters

computeAlternativeRoutes
boolean
destination_address
stringRequired
fieldMask
stringDefaults to routes.distanceMeters,routes.duration,routes.polyline.encodedPolyline
languageCode
stringDefaults to en-US
origin_address
stringRequired
routeModifiers_avoidFerries
boolean
routeModifiers_avoidHighways
boolean
routeModifiers_avoidTolls
boolean
routingPreference
string
travelMode
stringDefaults to DRIVE
units
stringDefaults to IMPERIAL

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get sheet names

Description

Lists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations.

Action Parameters

spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Spreadsheet by Data Filter

Description

Returns the spreadsheet at the given ID, filtered by the specified data filters. Use this tool when you need to retrieve specific subsets of data from a Google Sheet based on criteria like A1 notation, developer metadata, or grid ranges. Important: This action is designed for filtered data retrieval. While it accepts empty filters and returns full metadata in that case, GOOGLESHEETS_GET_SPREADSHEET_INFO is the recommended action for unfiltered spreadsheet retrieval.

Action Parameters

dataFilters
array
excludeTablesInBandedRanges
includeGridData
spreadsheetId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get spreadsheet info

Description

Retrieves comprehensive metadata for a Google Spreadsheet using its ID, excluding cell data.

Action Parameters

spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Table Schema

Description

This action is used to get the schema of a table in a Google Spreadsheet, call this action to get the schema of a table in a spreadsheet BEFORE YOU QUERY THE TABLE. Analyze table structure and infer column names, types, and constraints. Uses statistical analysis of sample data to determine the most likely data type for each column. Call this action after calling the LIST_TABLES action to get the schema of a table in a spreadsheet.

Action Parameters

sample_size
integerDefaults to 50
sheet_name
spreadsheet_id
stringRequired
table_name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Task

Description

Retrieve a specific Google Task. REQUIRES both `tasklist_id` and `task_id`. Tasks cannot be retrieved by ID alone - you must always specify which task list contains the task.

Action Parameters

task_id
stringRequired
tasklist_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get task list

Description

Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user.

Action Parameters

tasklist_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Transcript Entry

Description

Fetches a single transcript entry by resource name for targeted inspection or incremental processing. Use when you have a specific transcript entry resource name and need to retrieve its details (text, speaker, timestamps, language). PREREQUISITE: Obtain the transcript entry resource name first by using LIST_TRANSCRIPT_ENTRIES or construct it from known IDs. The 'name' parameter is REQUIRED and must follow the format: 'conferenceRecords/{conferenceRecordId}/transcripts/{transcriptId}/entries/{entryId}'

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get transcripts by conference record ID

Description

Retrieves all transcripts for a specific Google Meet conference using its conferenceRecord_id.

Action Parameters

conferenceRecord_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Vacation Settings

Description

Tool to retrieve vacation responder settings for a Gmail user. Use when you need to check if out-of-office auto-replies are configured and view their content.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete folder or file

Description

Tool to delete a file or folder in Google Drive. Use when you need to permanently remove a specific file or folder using its ID. Note: This action is irreversible.

Action Parameters

fileId
stringRequired
supportsAllDrives

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Hide Shared Drive

Description

Tool to hide a shared drive from the default view. Use when you want to remove a shared drive from the user's main Google Drive interface without deleting it.

Action Parameters

drive_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Insert Dimension in Google Sheet

Description

Tool to insert new rows or columns into a sheet at a specified location. Use when you need to add empty rows or columns within an existing Google Sheet.

Action Parameters

include_spreadsheet_in_response
insert_dimension
objectRequired
response_include_grid_data
response_ranges
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Insert Inline Image

Description

Tool to insert an image from a given URI at a specified location in a Google Document as an inline image. Use when you need to add an image to a document programmatically.

Action Parameters

documentId
stringRequired
location
objectRequired
objectSize
uri
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Insert Page Break

Description

Tool to insert a page break into a Google Document. Use when you need to start new content on a fresh page, such as at the end of a chapter or section.

Action Parameters

documentId
stringRequired
insertPageBreak
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Insert Table in Google Doc

Description

Tool to insert a table into a Google Document. Use when you need to add a new table at a specific location or at the end of a segment (like document body, header, or footer) in a document.

Action Parameters

columns
integerRequired
documentId
stringRequired
index
insertAtEndOfSegment
rows
integerRequired
segmentId
tabId

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Insert Table Column

Description

Tool to insert a new column into a table in a Google Document. Use this tool when you need to add a column to an existing table at a specific location.

Action Parameters

document_id
stringRequired
requests
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Insert Task

Description

Creates a new task in a given `tasklist_id`, optionally as a subtask of an existing `task_parent` or positioned after an existing `task_previous` sibling, where both `task_parent` and `task_previous` must belong to the same `tasklist_id` if specified. IMPORTANT: Date fields (due, completed) accept various formats like '28 Sep 2025', '11:59 PM, 22 Sep 2025', or ISO format '2025-09-21T15:30:00Z' and will automatically convert them to RFC3339 format required by the API.

Action Parameters

completed
deleted
due
etag
hidden
id
notes
status
Defaults to needsAction
task_parent
task_previous
tasklist_id
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Insert Text into Document

Description

Tool to insert a string of text at a specified location within a Google Document. Use when you need to add new text content to an existing document. IMPORTANT: Two ways to specify insertion location: 1. Use 'insertion_index' to insert at a specific position (index 1 is safe for document start) 2. Use 'append_to_end=true' to append text to the end of the document (recommended for appending) CRITICAL CONSTRAINT: When using insertion_index, the index MUST fall within the bounds of an EXISTING paragraph. You cannot insert text at arbitrary indices or at structural boundaries (e.g., table starts). The index must also be strictly less than the document's end index. To safely append text without index concerns, use append_to_end=true.

Action Parameters

append_to_end
document_id
stringRequired
insertion_index
segment_id
text_to_insert
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Access Proposals

Description

Tool to list pending access proposals on a file. Use when you need to retrieve access proposals for a specific file. Note: Only approvers can list access proposals; non-approvers will receive a 403 error.

Action Parameters

fileId
stringRequired
pageSize
pageToken

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Accounts

Description

Tool to list all Accounts accessible by the caller. Use when you need to enumerate all Google Analytics accounts your credentials can access.

Action Parameters

pageSize
pageToken
showDeleted

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List ACL Rules

Description

Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules.

Action Parameters

calendar_id
stringRequired
max_results
page_token
show_deleted
sync_token

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Albums

Description

Lists all albums shown to a user in the Albums tab of Google Photos.

Action Parameters

excludeNonAppCreatedData
boolean
pageSize
integerDefaults to 20
pageToken
string

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List All Tasks Across All Lists

Description

Tool to list all tasks across all of the user's task lists with optional filters. Use when the agent needs to see all tasks without knowing which list to query first. Each returned task is annotated with its tasklist_id and tasklist_title for context.

Action Parameters

completedMax
completedMin
dueMax
dueMin
max_tasks_total
Defaults to 1000
showAssigned
showCompleted
Defaults to True
showDeleted
showHidden
updatedMin

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Approvals

Description

Tool to list approvals on a file for workflow-based access control. Use when you need to retrieve all approvals associated with a specific file in Google Drive.

Action Parameters

fileId
stringRequired
pageSize
pageToken

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Audience Exports

Description

Tool to list all audience exports for a GA4 property. Use when you need to fetch its export history after initiating exports.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Audience Lists

Description

Tool to list all audience lists for a specified property to help find and reuse existing lists. Use when you need to retrieve a property's configured audience lists after confirming the property ID.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Audiences

Description

Tool to list all audiences on a property. Use when you need to fetch all audiences for a GA4 property after confirming its existence.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Google Calendars

Description

Retrieves calendars from the user's Google Calendar list, with options for pagination and filtering.

Action Parameters

max_results
integerDefaults to 10
min_access_role
page_token
show_deleted
boolean
show_hidden
boolean
sync_token

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Changes

Description

Tool to list the changes for a user or shared drive. Use when you need to track modifications to files and folders, such as creations, deletions, or permission changes. The pageToken is optional - if not provided, the current start page token will be automatically fetched to begin monitoring changes from now. Example usage (continuing with pageToken): ```json { "pageToken": "22633", "pageSize": 100, "includeRemoved": true } ``` Returns changes with timestamps, file IDs, and modification details. Save the `nextPageToken` from the response to continue paginating through changes, or save the `newStartPageToken` to monitor future changes efficiently.

Action Parameters

driveId
includeCorpusRemovals
includeItemsFromAllDrives
includeLabels
includePermissionsForView
includeRemoved
Defaults to True
pageSize
Defaults to 100
pageToken
restrictToMyDrive
spaces
Defaults to drive
supportsAllDrives

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Comments

Description

Tool to list all comments for a file in Google Drive. Use when you need to retrieve comments associated with a specific file.

Action Parameters

fields
Defaults to *
fileId
stringRequired
includeDeleted
pageSize
Defaults to 20
pageToken
startModifiedTime

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Conference Records

Description

Tool to list conference records. Use when you need to retrieve a list of past conferences, optionally filtering them by criteria like meeting code, space name, or time range.

Action Parameters

filter
page_size
page_token

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List CSE identities

Description

Tool to list client-side encrypted identities for an authenticated user. Use when you need to retrieve CSE identity configurations including key pair associations.

Action Parameters

page_size
page_token
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List CSE key pairs

Description

Tool to list client-side encryption key pairs for an authenticated user. Use when you need to retrieve CSE keypair configurations including public keys and enablement states. Supports pagination for large result sets.

Action Parameters

page_size
page_token
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List drafts

Description

Retrieves a paginated list of email drafts from a user's Gmail account. Use verbose=true to get full draft details including subject, body, sender, and timestamp.

Action Parameters

max_results
integerDefaults to 1
page_token
string
user_id
stringDefaults to me
verbose
boolean

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List File Labels

Description

Tool to list the labels on a file. Use when you need to retrieve all labels associated with a specific file in Google Drive.

Action Parameters

file_id
stringRequired
max_results
page_token

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Files and Folders

Description

Tool to list a user's files and folders in Google Drive. Use this to search or browse for files and folders based on various criteria.

Action Parameters

corpora
driveId
fields
folderId
includeItemsFromAllDrives
includeLabels
includePermissionsForView
orderBy
pageSize
Defaults to 100
pageToken
q
spaces
supportsAllDrives

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Gmail filters

Description

Tool to list all Gmail filters (rules) in the mailbox. Use for security audits to detect malicious filter rules or before creating new filters to avoid duplicates.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Gmail history

Description

Tool to list Gmail mailbox change history since a known startHistoryId. Use when performing incremental mailbox syncs to fetch only new changes.

Action Parameters

history_types
label_id
max_results
integerDefaults to 100
page_token
start_history_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Key Events

Description

Tool to list Key Events. Use when you need to retrieve all key event definitions for a given property.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Gmail labels

Description

Retrieves a list of all system and user-created labels for the specified Gmail account.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Media Items

Description

Lists all media items from a user's Google Photos library.

Action Parameters

pageSize
integerDefaults to 25
pageToken
string

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Participant Sessions

Description

Tool to list all participant sessions for a specific participant in a Google Meet conference. A participant session represents each unique join or leave session when a user joins a conference from a device. If a user joins multiple times from the same device, each join creates a new session. REQUIRED INPUT: You MUST provide the `parent` parameter containing a participant resource name in the format `conferenceRecords/{conferenceRecord}/participants/{participant}`. Example workflow: 1. Call GOOGLEMEET_LIST_CONFERENCE_RECORDS to get conference records 2. Extract a conference record name (e.g., "conferenceRecords/abc123xyz") 3. Call GOOGLEMEET_LIST_PARTICIPANTS with that conference record to get participants 4. Extract a participant name (e.g., "conferenceRecords/abc123xyz/participants/def456") 5. Pass that participant name as the `parent` parameter to this action

Action Parameters

filter
page_size
page_token
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Permissions

Description

Tool to list a file's permissions. Use when you need to retrieve all permissions associated with a specific file or shared drive.

Action Parameters

fileId
stringRequired
includePermissionsForView
pageSize
pageToken
supportsAllDrives
useDomainAdminAccess

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Properties

Description

Tool to list GA4 properties under a specific account. Use after obtaining an account ID; supports pagination and including soft-deleted properties.

Action Parameters

account
stringRequired
pageSize
pageToken
showDeleted

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Recurring Audience Lists

Description

Tool to list all recurring audience lists for a GA4 property. Use when you need to find and reuse existing recurring audience lists.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Replies to Comment

Description

Tool to list replies to a comment in Google Drive. Use this when you need to retrieve all replies associated with a specific comment on a file.

Action Parameters

comment_id
stringRequired
fields
Defaults to *
file_id
stringRequired
include_deleted
page_size
page_token

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Reporting Data Annotations

Description

Tool to list all Reporting Data Annotations on a property. Use when you need to retrieve or inspect annotations for a GA4 property.

Action Parameters

filter
pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List File Revisions

Description

Tool to list a file's revisions. Use when you need to retrieve the revision history of a specific file in Google Drive.

Action Parameters

fileId
stringRequired
pageSize
pageToken
supportsAllDrives

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Rollup Properties

Description

Tool to list roll-up GA4 properties accessible to the caller. Use when you need to identify roll-up properties across all accessible accounts.

Action Parameters

pageSize

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List send-as aliases

Description

Lists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases. Use when you need to retrieve available sending addresses for composing emails.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Calendar Settings

Description

Tool to return all user settings for the authenticated user. Use when you need to retrieve calendar settings.

Action Parameters

maxResults
pageToken

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Shared Drives

Description

Tool to list the user's shared drives. Use when you need to get a list of all shared drives accessible to the authenticated user.

Action Parameters

pageSize
pageToken
q
useDomainAdminAccess

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List SKAdNetwork Conversion Value Schemas

Description

Tool to list SKAdNetworkConversionValueSchema configurations for an iOS data stream. Use when you need to retrieve conversion value schemas for iOS app tracking. Maximum one schema per property is supported.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List S/MIME configs

Description

Lists S/MIME configs for the specified send-as alias. Use when you need to retrieve all S/MIME certificate configurations associated with a specific send-as email address.

Action Parameters

send_as_email
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Charts from Spreadsheet

Description

Tool to retrieve a list of charts with their IDs and metadata from a Google Sheets spreadsheet. Use to identify charts available for embedding into Google Docs.

Action Parameters

fields_mask
stringDefaults to sheets(properties(sheetId,title),charts(chartId,spec(title,altText)))
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Tables in Spreadsheet

Description

This action is used to list all tables in a Google Spreadsheet, call this action to get the list of tables in a spreadsheet. Discover all tables in a Google Spreadsheet by analyzing sheet structure and detecting data patterns. Uses heuristic analysis to find header rows, data boundaries, and table structures.

Action Parameters

min_columns
integerDefaults to 1
min_confidence
numberDefaults to 0.5
min_rows
integerDefaults to 2
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List task lists

Description

Fetches the authenticated user's task lists from Google Tasks; results may be paginated.

Action Parameters

maxResults
integerDefaults to 20
pageToken

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Tasks

Description

Retrieves tasks from a Google Tasks list; all date/time strings must be RFC3339 UTC, and `showCompleted` must be true if `completedMin` or `completedMax` are specified.

Action Parameters

completedMax
completedMin
dueMax
dueMin
maxResults
pageToken
showCompleted
showDeleted
showHidden
tasklist_id
stringRequired
updatedMin

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List threads

Description

Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination.

Action Parameters

max_results
integerDefaults to 10
page_token
string
query
string
user_id
stringDefaults to me
verbose
boolean

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Transcript Entries

Description

Tool to list structured transcript entries (speaker/time/text segments) for a specific Google Meet transcript. Use when you need to access the detailed content of a transcript, including individual spoken segments with timestamps and speaker information. Note: The transcript entries returned by the API might not match the transcription in Google Docs due to interleaved speakers or post-generation modifications.

Action Parameters

page_size
page_token
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Look up spreadsheet row

Description

Finds the first row in a Google Spreadsheet where a cell's entire content exactly matches the query string, searching within a specified A1 notation range or the first sheet by default.

Action Parameters

case_sensitive
boolean
query
stringRequired
range
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Embed Google Map

Description

Tool to generate an embeddable Google Map URL and HTML iframe code. Use when you need to display a map (place, view, directions, street view, search) on a webpage without JavaScript. Note: This API only works with API keys (no OAuth2 support). It generates embed URLs and does not make direct API calls.

Action Parameters

directions_params
mode
stringRequired
place_params
search_params
streetview_params
view_params

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Modify thread labels

Description

Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid.

Action Parameters

add_label_ids
remove_label_ids
thread_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Move File

Description

Tool to move a file from one folder to another in Google Drive. Use when you need to reorganize files by changing their parent folder(s).

Action Parameters

add_parents
file_id
stringRequired
include_labels
include_permissions_for_view
keep_revision_forever
ocr_language
remove_parents
supports_all_drives
use_content_as_indexable_text

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Move Task

Description

Moves the specified task to another position in the destination task list.

Action Parameters

destinationTasklist
parent
previous
task
stringRequired
tasklist
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Move to Trash

Description

Moves an existing, non-deleted email message to the trash for the specified user.

Action Parameters

message_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Mutate conditional format rules

Description

Add, update, delete, or reorder conditional format rules on a Google Sheet. Use when you need to create, modify, or remove conditional formatting without manually building batchUpdate requests. Supports four operations: ADD (create new rule), UPDATE (replace existing rule), DELETE (remove rule), MOVE (reorder rules by changing index).

Action Parameters

index
new_index
operation
stringRequired
rule
sheet_id
integerRequired
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Export or download a file

Description

DEPRECATED: Exports Google Workspace files (max 10MB) to a specified format using `mime_type`, or downloads other file types; use `GOOGLEDRIVE_DOWNLOAD_FILE` instead.

Action Parameters

file_id
stringRequired
mime_type

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch Calendar

Description

Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided; `summary` is mandatory and cannot be an empty string, and an empty string for `description` or `location` clears them.

Action Parameters

calendar_id
stringRequired
description
location
summary
stringRequired
timezone

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch Event

Description

Update specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar_id` and `event_id` are valid and the user has write access to the calendar.

Action Parameters

attendees
calendar_id
stringRequired
conference_data_version
description
end_time
event_id
stringRequired
location
max_attendees
rsvp_response
send_updates
start_time
summary
supports_attachments
timezone

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch Label

Description

Patches the specified label.

Action Parameters

color
id
stringRequired
labelListVisibility
messageListVisibility
name
userId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch Task

Description

Partially updates an existing task (identified by `task_id`) within a specific Google Task list (identified by `tasklist_id`), modifying only the provided attributes from `TaskInput` (e.g., `title`, `notes`, `due` date, `status`) and requiring both the task and list to exist.

Action Parameters

completed
deleted
due
etag
hidden
id
notes
status
task_id
stringRequired
tasklist_id
stringRequired
title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch task list

Description

Updates the title of an existing Google Tasks task list.

Action Parameters

tasklist_id
stringRequired
updated_title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Place Photo

Description

Retrieves high quality photographic content from the Google Maps Places database. Use when you need to download a place photo using a photo_reference obtained from Place Details, Nearby Search, or Text Search requests. Images are scaled proportionally to fit within specified dimensions.

Action Parameters

maxheight
maxwidth
photo_reference
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Presentation (Batch/Markdown)

Description

Update Google Slides presentations using markdown content or raw API text. Supports professional themes, auto-formatting, and multiple slide types (title, bullet, table, quote, image, two-column).

Action Parameters

markdown_text
presentationId
stringRequired
requests
writeControl

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Copy Google Slides from Template

Description

Tool to create a new Google Slides presentation by duplicating an existing template deck via Drive file copy. Use when you need to preserve themes, masters, and layouts exactly as they appear in the template. After copying, use GOOGLESLIDES_PRESENTATIONS_BATCH_UPDATE to replace placeholder text or images.

Action Parameters

new_title
parent_folder_id
template_presentation_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Google Slides Presentation

Description

Tool to create a blank Google Slides presentation. Use when you need to initialize a new presentation with a specific title.

Action Parameters

presentationId
title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Presentation

Description

Tool to retrieve the latest version of a presentation. Use after obtaining the presentation ID.

Action Parameters

fields
presentationId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Presentation Page

Description

Tool to get the latest version of a specific page in a presentation. Use when you need to inspect slide, layout, master, or notes page details.

Action Parameters

pageObjectId
stringRequired
presentationId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Page Thumbnail

Description

Tool to generate and return a thumbnail image URL for a specific page. Use when you need a quick preview of a slide page after loading it.

Action Parameters

pageObjectId
stringRequired
presentationId
stringRequired
thumbnailProperties.mimeType
thumbnailProperties.thumbnailSize

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Audience Export

Description

Tool to create an audience export for Google Analytics. Use when you need to export a snapshot of users in an audience at a specific point in time. This initiates a long-running asynchronous request that returns an operation resource name immediately.

Action Parameters

audience
stringRequired
dimensions
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Audience Exports

Description

Tool to list all audience exports for a property. Use when you need to find and reuse existing audience exports rather than creating new ones.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Audience List

Description

Tool to create an audience list for later retrieval by initiating a long running asynchronous request. Use when you need to create a snapshot of users currently in an audience. The method returns quickly with an Operation resource while processing occurs in the background.

Action Parameters

audience
stringRequired
dimensions
arrayRequired
parent
stringRequired
webhookNotification

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Calculated Metrics

Description

Tool to list CalculatedMetrics on a property. Use when you need to retrieve all calculated metrics configured for a given property.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Event Create Rules

Description

Tool to list EventCreateRules configured on a web data stream. Use when you need to retrieve event create rules for a specific GA4 property data stream.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Reporting Data Annotations

Description

Tool to list all Reporting Data Annotations for a specific property. Use when you need to retrieve annotations that document important events or periods in GA4 reporting data.

Action Parameters

filter
pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Report Task

Description

Tool to create a report task as a long-running asynchronous request for customized Google Analytics event data reports. Use when you need to generate large or complex reports that process asynchronously.

Action Parameters

parent
stringRequired
reportDefinition

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Report Tasks

Description

Tool to list all report tasks for a Google Analytics property. Use when you need to retrieve report task definitions and their execution status.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Subproperty Event Filters

Description

Tool to list all subproperty event filters on a property. Use when you need to retrieve event filters that route events to subproperties.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Subproperty Sync Configs

Description

Tool to list SubpropertySyncConfig resources for managing subproperty synchronization configurations. Use when you need to fetch subproperty sync configs for a GA4 property.

Action Parameters

pageSize
pageToken
parent
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Query Audience Export

Description

Tool to query a completed audience export. Use when you need to fetch user rows with pagination.

Action Parameters

limit
name
stringRequired
offset

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Query Audience List

Description

Tool to query an audience list. Use when you need to retrieve user rows from a GA4 audience list with pagination.

Action Parameters

limit
name
stringRequired
offset

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Query Spreadsheet Table

Description

This action is used to query a table in a Google Spreadsheet, call this action to query a table in a spreadsheet. Execute SQL-like SELECT queries against spreadsheet tables. Supports WHERE conditions, ORDER BY, LIMIT clauses. Call this action after calling the GET_TABLE_SCHEMA action to query a table in a spreadsheet.

Action Parameters

include_formulas
boolean
spreadsheet_id
stringRequired
sql
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Quick Add Event

Description

Parses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and `calendar_id` must be valid if not 'primary'.

Action Parameters

calendar_id
stringDefaults to primary
send_updates
stringDefaults to none
text
string

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Remove attendee from event

Description

Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist.

Action Parameters

attendee_email
stringRequired
calendar_id
stringDefaults to primary
event_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Replace All Text in Document

Description

Tool to replace all occurrences of a specified text string with another text string throughout a Google Document. Use when you need to perform a global find and replace operation within a document.

Action Parameters

document_id
stringRequired
find_text
stringRequired
match_case
boolean
replace_text
stringRequired
search_by_regex
tab_ids

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Replace Image in Document

Description

Tool to replace a specific image in a document with a new image from a URI. Use when you need to update an existing image within a Google Doc.

Action Parameters

document_id
stringRequired
replace_image
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Reply to email thread

Description

Sends a reply within a specific Gmail thread using the original thread's subject, requiring a valid `thread_id` and at least one of recipient_email, cc, or bcc must be provided. Supports attachments via the `attachment` parameter with valid `s3key`, `mimetype`, and `name`.

Action Parameters

attachment
bcc
array
cc
array
extra_recipients
array
is_html
boolean
message_body
string
recipient_email
thread_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Resumable Upload

Description

Tool to start and complete a Google Drive resumable upload session. Use when uploading large files that require resumable, chunked uploads.

Action Parameters

chunkSize
integerDefaults to 262144
file_id
file_to_upload
objectRequired
folder_to_upload_to
metadata
queryParams
object

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Run Funnel Report

Description

Tool to run a GA4 funnel report. Use when you need a customized funnel analysis report for a given property.

Action Parameters

dateRanges
dimensionFilter
funnel
objectRequired
funnelBreakdown
funnelNextAction
funnelVisualizationType
limit
property
stringRequired
returnPropertyQuota
segments

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Run Pivot Report

Description

Tool to run a customized pivot report of Google Analytics event data. Use when you need a pivot table view with advanced segmentation and multi-dimensional analysis of GA4 data.

Action Parameters

cohortSpec
comparisons
currencyCode
dateRanges
dimensionFilter
dimensions
keepEmptyRows
metricFilter
metrics
arrayRequired
pivots
property
stringRequired
returnPropertyQuota

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Run Realtime Report

Description

Tool to run a customized realtime report of Google Analytics event data. Use when you need realtime data (last 30-60 minutes) with dimensions and metrics for a GA4 property.

Action Parameters

dimensionFilter
dimensions
limit
metricAggregations
metricFilter
metrics
minuteRanges
orderBys
property
stringRequired
returnPropertyQuota

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Run Report

Description

Tool to run a customized GA4 data report. Use when you need event data after specifying dimensions, metrics, and date ranges.

Action Parameters

cohortSpec
comparisons
currencyCode
dateRanges
dimensionFilter
dimensions
keepEmptyRows
limit
metricAggregations
metricFilter
metrics
offset
orderBys
property
stringRequired
returnPropertyQuota

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Search Developer Metadata

Description

Tool to search for developer metadata in a spreadsheet. Use when you need to find specific metadata entries based on filters.

Action Parameters

dataFilters
arrayRequired
spreadsheetId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Search Documents

Description

Search for Google Documents using various filters including name, content, date ranges, and more.

Action Parameters

created_after
include_trashed
max_results
Defaults to 10
modified_after
order_by
Defaults to modifiedTime desc
query
shared_with_me
starred_only

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Search Media Items

Description

Searches for media items in a user's Google Photos library.

Action Parameters

albumId
string
filters
object
orderBy
string
pageSize
integerDefaults to 25
pageToken
string

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Search People

Description

Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'.

Action Parameters

other_contacts
booleanDefaults to True
pageSize
integerDefaults to 10
person_fields
stringDefaults to emailAddresses,metadata,names,phoneNumbers
query
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Search Spreadsheets

Description

Search for Google Spreadsheets using various filters including name, content, date ranges, and more.

Action Parameters

created_after
include_trashed
max_results
Defaults to 10
modified_after
order_by
Defaults to modifiedTime desc
query
shared_with_me
starred_only

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Send Draft

Description

Sends the specified, existing draft to the recipients in the To, Cc, and Bcc headers.

Action Parameters

draft_id
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Send Email

Description

Sends an email via Gmail API using the authenticated user's Google profile display name. At least one of 'to' (or 'recipient_email'), 'cc', or 'bcc' must be provided. At least one of subject or body must be provided. Requires `is_html=True` if the body contains HTML. For attachments, you must provide a FileUploadable object with valid `s3key` (obtained from a previous file download action like GMAIL_GET_ATTACHMENT), `mimetype` (e.g., 'image/png', 'application/pdf'), and `name` (filename). All common file types including PNG, JPG, PDF, MP4, etc. are supported. Gmail API limits total message size to ~25 MB after base64 encoding.

Action Parameters

attachment
object
bcc
array
body
cc
array
extra_recipients
array
is_html
boolean
recipient_email
subject
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Set Basic Filter

Description

Tool to set a basic filter on a sheet in a Google Spreadsheet. Use when you need to filter or sort data within a specific range on a sheet.

Action Parameters

filter
objectRequired
spreadsheetId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Set Data Validation Rule

Description

Tool to set or clear data validation rules (including dropdowns) on a range in Google Sheets. Use when you need to apply dropdown lists, range-based dropdowns, or custom formula validation to cells.

Action Parameters

end_column_index
integerRequired
end_row_index
integerRequired
formula
input_message
mode
stringRequired
sheet_id
integerRequired
show_custom_ui
booleanDefaults to True
source_range_a1
spreadsheet_id
stringRequired
start_column_index
integerRequired
start_row_index
integerRequired
strict
booleanDefaults to True
validation_type
values

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Calendar Setting

Description

Tool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value.

Action Parameters

setting
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get IMAP Settings

Description

Retrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get POP settings

Description

Tool to retrieve POP settings for a Gmail account. Use when you need to check the current POP configuration including access window and message disposition.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Settings

Description

Returns all user settings for the authenticated user.

Action Parameters

maxResults
pageToken
syncToken

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get send-as alias

Description

Tool to retrieve a specific send-as alias configuration for a Gmail user. Use when you need to get details about a send-as email address including display name, signature, SMTP settings, and verification status. Fails with HTTP 404 if the specified address is not a member of the send-as collection.

Action Parameters

send_as_email
stringRequired
user_id
stringDefaults to me

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Watch Settings

Description

Watch for changes to Settings resources.

Action Parameters

address
stringRequired
expiration
id
stringRequired
params
token
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create sheet from JSON

Description

Creates a new Google Spreadsheet and populates its first worksheet from `sheet_json`. When data is provided, the first item's keys establish the headers. An empty list creates an empty worksheet.

Action Parameters

sheet_json
arrayRequired
sheet_name
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Copy Sheet to Another Spreadsheet

Description

Tool to copy a single sheet from a spreadsheet to another spreadsheet. Use when you need to duplicate a sheet into a different spreadsheet.

Action Parameters

destination_spreadsheet_id
stringRequired
sheet_id
integerRequired
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Append Values to Spreadsheet

Description

Tool to append values to a spreadsheet. Use when you need to add new data to the end of an existing table in a Google Sheet.

Action Parameters

includeValuesInResponse
insertDataOption
majorDimension
range
stringRequired
responseDateTimeRenderOption
responseValueRenderOption
spreadsheetId
stringRequired
valueInputOption
stringRequired
values
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Clear Spreadsheet Values

Description

Tool to clear one or more ranges of values from a spreadsheet. Use when you need to remove data from specific cells or ranges while keeping formatting and other properties intact.

Action Parameters

ranges
arrayRequired
spreadsheet_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Clear Values By Data Filter

Description

Clears one or more ranges of values from a spreadsheet using data filters. The caller must specify the spreadsheet ID and one or more DataFilters. Ranges matching any of the specified data filters will be cleared. Only values are cleared -- all other properties of the cell (such as formatting, data validation, etc..) are kept.

Action Parameters

dataFilters
arrayRequired
spreadsheetId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Batch Get Spreadsheet Values by Data Filter

Description

Tool to return one or more ranges of values from a spreadsheet that match the specified data filters. Use when you need to retrieve specific data sets based on filtering criteria rather than entire sheets or fixed ranges.

Action Parameters

dataFilters
arrayRequired
dateTimeRenderOption
majorDimension
spreadsheetId
stringRequired
valueRenderOption

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Stop Watch Channel

Description

Tool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch.

Action Parameters

address
channelType
expiration
id
stringRequired
kind
Defaults to api#channel
params
payload
resourceId
stringRequired
resourceUri
token

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Sync Events

Description

Synchronizes Google Calendar events, performing a full sync if no `sync_token` is provided or if a 410 GONE error (due to an expired token) necessitates it, otherwise performs an incremental sync for events changed since the `sync_token` was issued.

Action Parameters

calendar_id
stringDefaults to primary
event_types
max_results
pageToken
single_events
sync_token

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Tiles Session

Description

Tool to create a session token required for accessing 2D Tiles and Street View imagery. Use when you need to initialize tile-based map rendering or street view display. The session token is valid for approximately two weeks and must be included in all subsequent tile requests.

Action Parameters

highDpi
imageFormat
language
stringRequired
layerTypes
mapType
stringRequired
overlay
region
stringRequired
scale
styles

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Trash File

Description

Tool to move a file or folder to trash (soft delete). Use when you need to delete a file but want to allow recovery via UNTRASH_FILE. This action is distinct from permanent deletion and provides a safer cleanup workflow.

Action Parameters

fields
file_id
stringRequired
supportsAllDrives
Defaults to True

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Unhide Shared Drive

Description

Tool to unhide a shared drive. Use when you need to restore a shared drive to the default view.

Action Parameters

driveId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Unmerge Table Cells

Description

Tool to unmerge previously merged cells in a table. Use this when you need to revert merged cells in a Google Document table back to their individual cell states.

Action Parameters

document_id
stringRequired
tableRange
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Untrash File

Description

Tool to restore a file from the trash. Use when you need to recover a deleted file. This action updates the file's metadata to set the 'trashed' property to false.

Action Parameters

file_id
stringRequired
supportsAllDrives

Action Response

data
arrayRequired
error
successful
booleanRequired

Tool Name: Update ACL Rule

Description

Updates an access control rule for the specified calendar.

Action Parameters

calendar_id
stringRequired
role
stringRequired
rule_id
stringRequired
send_notifications
Defaults to True

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Album

Description

Updates an album's title or cover photo in Google Photos.

Action Parameters

albumId
stringRequired
coverPhotoMediaItemId
title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Comment

Description

Tool to update an existing comment on a Google Drive file. Use when you need to change the content or status (e.g., resolve) of a comment.

Action Parameters

comment_id
stringRequired
content
fields
file_id
stringRequired
resolved

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Document Markdown

Description

Replaces the entire content of an existing Google Docs document with new Markdown text; requires edit permissions for the document.

Action Parameters

id
stringRequired
markdown
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Document Section Markdown

Description

Tool to insert or replace a section of a Google Docs document with Markdown content. Use when you need to update only a section of a document by specifying start and optional end indices. Supports full Markdown formatting.

Action Parameters

document_id
stringRequired
end_index
markdown_text
stringRequired
start_index

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Document Style

Description

Tool to update the overall document style, such as page size, margins, and default text direction. Use when you need to modify the global style settings of a Google Document.

Action Parameters

document_id
stringRequired
document_style
objectRequired
fields
stringDefaults to *
tab_id

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Shared Drive

Description

Tool to update the metadata for a shared drive. Use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive.

Action Parameters

backgroundImageFile
colorRgb
driveId
stringRequired
hidden
name
restrictions
themeId
useDomainAdminAccess

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Google event

Description

Updates an existing event in Google Calendar. REQUIRES event_id - you MUST first search for the event using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to obtain the event_id. This is a full PUT replacement, so provide all desired fields as unspecified ones may be cleared or reset.

Action Parameters

attendees
birthdayProperties
calendar_id
stringDefaults to primary
create_meeting_room
Defaults to True
description
eventType
stringDefaults to default
event_duration_hour
integer
event_duration_minutes
integerDefaults to 30
event_id
stringRequired
extended_properties
focusTimeProperties
guestsCanInviteOthers
guestsCanSeeOtherGuests
guests_can_modify
boolean
location
outOfOfficeProperties
recurrence
send_updates
start_datetime
stringRequired
summary
timezone
transparency
stringDefaults to opaque
visibility
stringDefaults to default
workingLocationProperties

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update existing document

Description

Applies programmatic edits, such as text insertion, deletion, or formatting, to a specified Google Doc using the `batchUpdate` API method.

Action Parameters

document_id
stringRequired
editDocs
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update File (Metadata)

Description

Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3. Use this tool to modify attributes of an existing file like its name, description, or parent folders. Note: This action currently supports metadata updates only. File content updates require multipart/related upload and are not yet implemented.

Action Parameters

add_parents
description
fileId
stringRequired
keep_revision_forever
mime_type
name
ocr_language
remove_parents
starred
supports_all_drives
use_domain_admin_access
viewers_can_copy_content
writers_can_share

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update File Revision Metadata

Description

Updates ONLY the metadata properties of a specific file revision (keepForever, published, publishAuto, publishedOutsideDomain). IMPORTANT: This action does NOT update file content. To update file content, use EDIT_FILE or UPDATE_FILE_PUT instead. This action requires BOTH file_id AND revision_id parameters. Use LIST_REVISIONS to get available revision IDs for a file. Valid parameters: file_id (required), revision_id (required), keep_forever, published, publish_auto, published_outside_domain. Invalid parameters (use other actions): file_contents, mime_type, content, name - these are NOT supported by this action.

Action Parameters

file_id
stringRequired
keep_forever
publishAuto
published
publishedOutsideDomain
revision_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Media Item

Description

Updates a media item's description in Google Photos.

Action Parameters

description
mediaItemId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Permission

Description

Tool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive.

Action Parameters

enforceExpansiveAccess
fileId
stringRequired
permission
objectRequired
permissionId
stringRequired
removeExpiration
supportsAllDrives
transferOwnership
useDomainAdminAccess

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Reply

Description

Tool to update a reply to a comment on a Google Drive file. Use when you need to modify the content of an existing reply.

Action Parameters

comment_id
stringRequired
content
stringRequired
fields
file_id
stringRequired
reply_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Sheet Properties

Description

Tool to update properties of a sheet (worksheet) within a Google Spreadsheet, such as its title, index, visibility, tab color, or grid properties. Use this when you need to modify the metadata or appearance of a specific sheet.

Action Parameters

spreadsheetId
stringRequired
updateSheetProperties
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Google Meet Space

Description

Updates the settings of an existing Google Meet space. REQUIRED PARAMETER: - name: The space identifier (e.g., 'spaces/jQCFfuBOdN5z'). This is always required to identify which space to update. OPTIONAL PARAMETERS: - config: The new configuration settings to apply (accessType, entryPointAccess, moderation, etc.) - updateMask: Specify which fields to update. If omitted, all provided config fields are updated. Example: To change access type, provide name='spaces/abc123' and config={'accessType': 'OPEN'}

Action Parameters

config
name
stringRequired
updateMask

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Spreadsheet Properties

Description

Tool to update properties of a spreadsheet, such as its title, locale, or auto-recalculation settings. Use when you need to modify the overall configuration of a Google Sheet.

Action Parameters

fields
stringRequired
properties
objectRequired
spreadsheetId
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Table Row Style

Description

Tool to update the style of a table row in a Google Document. Use when you need to modify the appearance of specific rows within a table, such as setting minimum row height or marking rows as headers.

Action Parameters

documentId
stringRequired
updateTableRowStyle
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Task

Description

Updates the specified task.

Action Parameters

due
notes
status
task
stringRequired
tasklist
stringRequired
title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Task List

Description

Updates the authenticated user's specified task list.

Action Parameters

tasklist_id
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Upload File

Description

Uploads a file (max 5MB) to Google Drive, moving it to a specified folder if a valid folder ID is provided, otherwise uploads to root.

Action Parameters

file_to_upload
objectRequired
folder_to_upload_to

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Upload File from URL to Drive

Description

Tool to fetch a file from a provided URL server-side and upload it into Google Drive. Use when you need to reliably persist externally hosted files into Drive without client-side downloads or temporary storage.

Action Parameters

mime_type
name
stringRequired
parent_folder_id
source_headers
source_url
stringRequired
supports_all_drives
Defaults to True

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Upload Media

Description

Upload a media file to Google Photos. Supports images (up to 200MB) and videos (up to 20GB).

Action Parameters

description
string
file_to_upload
objectRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Upsert Rows (Smart Update/Insert)

Description

Upsert rows - update existing rows by key, append new ones. Automatically handles column mapping and partial updates. Use for: CRM syncs (match Lead ID), transaction imports (match Transaction ID), inventory updates (match SKU), calendar syncs (match Event ID). Features: - Auto-adds missing columns to sheet - Partial column updates (only update Phone + Status, preserve other columns) - Column order doesn't matter (auto-maps by header name) - Prevents duplicates by matching key column Example inputs: - Contact update: keyColumn='Email', headers=['Email','Phone','Status'], data=[['john@ex.com','555-0101','Active']] - Inventory sync: keyColumn='SKU', headers=['SKU','Stock','Price'], data=[['WIDGET-001',50,9.99],['GADGET-002',30,19.99]] - CRM lead update: keyColumn='Lead ID', headers=['Lead ID','Score','Status'], data=[['L-12345',85,'Hot']] - Partial update: keyColumn='Email', headers=['Email','Phone'] (only updates Phone, preserves Name/Address/etc)

Action Parameters

_normalization_message
headers
keyColumn
key_column_index
rows
arrayRequired
sheetName
stringRequired
spreadsheetId
stringRequired
strictMode
booleanDefaults to True
tableStart
Defaults to A1

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get spreadsheet values

Description

Returns a range of values from a spreadsheet. Use when you need to read data from specific cells or ranges in a Google Sheet.

Action Parameters

date_time_render_option
stringDefaults to SERIAL_NUMBER
major_dimension
range
stringRequired
spreadsheet_id
stringRequired
value_render_option
stringDefaults to FORMATTED_VALUE

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update spreadsheet values

Description

Tool to set values in a range of a Google Spreadsheet. Use when you need to update or overwrite existing cell values in a specific range.

Action Parameters

include_values_in_response
major_dimension
range
stringRequired
response_datetime_render_option
response_value_render_option
spreadsheet_id
stringRequired
value_input_option
stringRequired
values
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Watch Drive Changes

Description

Tool to subscribe to changes for a user or shared drive in Google Drive. Use when you need to monitor a Google Drive for modifications and receive notifications at a specified webhook URL.

Action Parameters

address
stringRequired
drive_id
expiration
id
stringRequired
include_corpus_removals
include_items_from_all_drives
include_labels
include_permissions_for_view
include_removed
Defaults to True
page_size
Defaults to 100
page_token
params
restrict_to_my_drive
spaces
Defaults to drive
supports_all_drives
token
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Watch File for Changes

Description

Tool to subscribe to push notifications for changes to a specific file. Use when you need to monitor a file for modifications and receive real-time notifications at a webhook URL.

Action Parameters

acknowledgeAbuse
address
stringRequired
expiration
fileId
stringRequired
id
stringRequired
includeLabels
includePermissionsForView
params
payload
supportsAllDrives
supportsTeamDrives
token
type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired