Your AI team, working in Google Super
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.
Start your companyWhat your team can do in Google Super
552 tools to work with, connected with your account.
Adds a text, location, or map enrichment at a specified position in a Google Photos album created by this app.
Submit email contacts for addition to or removal from a Google Ads Customer Match list through an asynchronous offline user data job, marking ad user data and personalization consent as granted. The returned status does not confirm processing completion.
Add a GRID sheet with rows and columns to an existing spreadsheet. This action does not create chart-only or DATA_SOURCE sheets. Use properties to configure the GRID sheet's dimensions, tab color, position, visibility, and text direction. Notes: - Sheet names must be unique; use forceUnique=true to auto-append suffix (_2, _3) if name exists - For tab colors, use EITHER rgbColor OR themeColor, not both - Avoid 'index' when creating sheets in parallel (causes errors)
Aggregates data from a column in a Google Sheet, either across all rows or rows matching column-value filters. Supports sum, average, count, minimum, maximum, and percentage.
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.
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.
Tool to archive a CustomDimension on a property. Use when you need to remove a custom dimension from active use without permanently deleting it. Archived dimensions cannot be used in new reports.
Auto-fit column widths or row heights for a dimension range using batchUpdate.autoResizeDimensions. Use when you need to automatically adjust row heights or column widths to fit content after writing data.
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.
Adds one or more app-created media items to an app-created Google Photos album.
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.
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.
Uploads and creates up to 50 Google Photos media items from public URLs or uploaded files, optionally placing them at a specific position in an app-created album. Creating media requires the photoslibrary.appendonly authorization scope, which is not included in the toolkit's default scopes.
Permanently deletes multiple Gmail messages by ID, bypassing Trash. A successful request does not confirm individual messages existed or were deleted.
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.
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.
Returns app-created Google Photos media items for the specified media item identifiers.
Retrieves values from specified cell ranges in a Google Spreadsheet. If ranges are omitted or empty after filtering blank entries, it retrieves data from the first sheet.
Read multiple explicit ranges from one Google Spreadsheet in one request.
Retrieves one or more ranges of values from a Google Spreadsheet using data filters. Each filter specifies an A1 range or a grid range.
Adds or removes labels on up to 1,000 Gmail messages in one request, supporting operations such as archiving and marking messages read or unread. A successful response confirms request acceptance, not individual message status.
Create, update, remove, or act on supported Google Ads resource types in one request. With partial_failure=false (the default), all operations are atomic and execute only if every operation is valid. With partial_failure=true, valid operations execute independently while invalid operations return errors. Use negative temporary resource IDs to connect resources created in the same request. Remove operations are destructive.
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.
Runs multiple analytics data reports for one GA4 property in a single request. Report metadata returned by this tool does not include data truncation reasons.
Update 1 to 500 Google Meet members in one space in a single batch. Requires meetings.space.created. Supply nested member names and optional email or role values. A child updateMask requires an identical top-level updateMask. With neither mask, all fields are updated, including clearing unset fields.
Tool to set values in one or more ranges of a spreadsheet. Use when you need to update multiple ranges in a single operation for better performance.
Write values to multiple Google Sheets ranges in one batch request.
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.
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.
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.
Clears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely.
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.
Permanently clear values from one range while preserving formatting, notes, and validation.
Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone. Always require explicit user confirmation before invoking.
Calculates travel distance and duration matrices between multiple origins and destinations using the Routes API, with various travel modes and OAuth2 support; some connections limit requests to 100 origin-destination pairs. Map results using originIndex and destinationIndex, and check condition for route availability.
Creates a copy of a file and applies any requested updates with patch semantics. Use when you need to duplicate a file with advanced options like label inclusion, visibility settings, or custom metadata.
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.
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.
Tool to copy a single sheet from a spreadsheet to another spreadsheet. Use when you need to duplicate a sheet into a different spreadsheet.
Creates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if needed.
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).
Creates a Google Drive file from text, with support for Google Workspace formats and an optional parent folder. Returns file metadata at the top level; files can inherit parent permissions, and shared-drive targets are not supported in all cases.
Creates a Google Drive folder, optionally inside an existing parent specified by ID or exact name. If multiple folders match a parent name, it uses the first match; use a parent ID to avoid ambiguity.
Creates a new Google Spreadsheet in Drive with an optional title and folder ID or exact folder name. Multiple matching folders return choices before creation; if moving a created spreadsheet to the requested folder fails, the response reports partial success.
Creates a new secondary Google Calendar with the specified title and optional settings. Use this action when you need to create a new calendar for organizing events separately from the primary calendar. The authenticated user becomes the owner of the newly created calendar. Optional parameters include description, location, and timezone.
Creates a new task list with the specified title and returns its details, including its ID for use in task operations. Duplicate titles are permitted, so check existing lists before creating one to avoid unintended duplicates.
Creates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain.
Creates a new album in Google Photos. This requires the photoslibrary.appendonly scope, which is not included in the default authorization scopes.
Creates a table in a Google Document and attempts to populate its cells with the provided text. Table creation and cell population are separate steps, so a failure after creation can leave the table in the document.
Create an Analytics audience from explicit membership filter clauses. Requires the https://www.googleapis.com/auth/analytics.edit OAuth scope, which is not granted by default.
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. The export begins in CREATING state with rowCount=0; the operation must complete before export data is accessible for querying.
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.
Create an immutable account asset containing a validated callout. Associate the returned resource using Mutate Customer Assets with field_type CALLOUT. Cleanup removes that association; Google does not allow deleting the asset.
Create a custom GA4 channel group with ordered traffic grouping rules. Requires the connection to grant the https://www.googleapis.com/auth/analytics.edit scope, which is not requested by default.
Create a chart in a Google Sheets spreadsheet using a specified data range and chart type, or an optional full chart specification. The chart type and data range are required even when supplying a chart specification.
Tool to create a comment on a file in Google Drive. Returns a nested `data` object; extract `data.id` for the resulting comment identifier. Omit `anchor` and `quoted_file_content_*` for general file-level comments.
Tool to create a CustomDimension for a Google Analytics property. Use when you need to add a new custom dimension to track specific user properties, event parameters, or eCommerce item parameters.
Tool to create a custom metric in Google Analytics. Use when you need to define a new custom metric for tracking specific event parameters.
Create a new Google Ads client under an eligible direct parent manager. Requires a manager account, not an advertiser client account. Currency and time zone cannot be changed after creation. Set validate_only=true to check eligibility and parameters without account creation. Invitation fields require Google allowlisting.
Creates a Google Ads Customer Match user list for contact information, not a customer account. Membership updates can take many hours to propagate; targeting eligibility is not immediate after creation.
Create a Data Manager user list, or validate without creating one.
Create a web, Android, or iOS data stream under a GA4 property. Requires the connection to grant the https://www.googleapis.com/auth/analytics.edit scope, which is not requested by default.
Creates a new Google Docs document, optionally initializing it with a title and content provided as Markdown text.
Creates a new tab in a Google Docs document. Tabs allow you to organize document content into separate sections within a single document. Use this action when you need to add a new organizational tab to a document. When a tab is added at a specified index, all subsequent tabs' indexes are automatically incremented.
Create a metadata-only Google Drive file, folder, or shortcut.
Creates a Gmail draft with optional recipients, subject, plain or HTML body, attachments, and threading. When a requested thread cannot be fetched, the draft is created without threading; a provided subject is used instead of the thread subject.
Creates a timed or all-day Google Calendar event and returns it under response_data, without conflict checking. send_updates defaults to "all", which emails all attendees; for eligible event types, the organizer is added unless excluded and a Google Meet link is requested by default.
Create a rule that emits a destination event when source-event conditions match. Requires the https://www.googleapis.com/auth/analytics.edit OAuth scope, which is not granted by default.
Create an expanded data set for a Google Analytics 360 property using specified dimensions and metrics.
Create the experiment definition that begins an experiment setup workflow. Create its control and treatment arms before scheduling it.
Create two Google Ads experiment arms in one atomic batch: one control and one treatment arm belonging to the same experiment. The control arm must contain one campaign, and their traffic splits must total 100%.
Creates a new file or folder in Google Drive. Supports both metadata-only creation (for folders and empty documents) and file upload with content. When file_to_upload is provided, uploads the actual file bytes; otherwise creates an empty file. Native Google file types (Docs, Sheets, Forms, etc.) and folders are created as empty shells when no content is provided; content must be added manually afterward. Newly created files are private by default β set sharing permissions afterward for collaboration. For shared-drive folders, use this tool with the target folder ID in `parents` rather than GOOGLEDRIVE_CREATE_FOLDER.
Creates a footer in a Google document for the specified type and optional section. If the API reports that a footer already exists, the tool may return the document's existing default footer ID instead.
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.
Tool to create a new Gmail filter with specified criteria and actions. Use when the user wants to automatically organize incoming messages based on sender, subject, size, or other criteria. Note: you can only create a maximum of 1,000 filters per account.
Creates a new Google Meet space with optional access controls, moderation, recording, or transcription settings, without attaching it to a calendar event. Returns the space name, meeting URI and meeting code when available, and requires the meetings.space.created OAuth scope.
Create a blank Google Slides presentation with an optional title and presentation ID.
Creates a header in a Google Document, optionally for a specified section, and can add text. For a document-level default header, it may reuse an existing header; text insertion is attempted separately and its success is reported.
Create a key event definition for a Google Analytics property. Requires the connection to grant the https://www.googleapis.com/auth/analytics.edit scope, which is not requested by default.
Creates a Gmail label and returns its label ID. For nested labels, it may create missing parent labels; on a name conflict it attempts to return the existing matching label.
Create a member in a Google Meet space, optionally assigning a co-host role. Members configured with a role can join the space without knocking. Supply the space resource name and the member's email address.
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.
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.
Tool to create a permission for a file or shared drive. Use when you need to share a file or folder with users, groups, domains, or make it publicly accessible. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
Creates multiple permissions for files or shared drives in a single batch request. Use this action when you need to share multiple files with users, or share a single file with multiple users or groups simultaneously. Each permission in the batch can target a different file and specify different access levels. Batch operations are more efficient than creating permissions individually, with a maximum of 100 permissions per batch.
Create an ordinary GA4 property under an Analytics account. Requires the connection to grant the https://www.googleapis.com/auth/analytics.edit scope, which is not requested by default.
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.
Create a plain-text reply to a comment on a Google Drive file, optionally resolving or reopening the parent comment.
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.
Tool to create a roll-up property. Use when consolidating multiple GA4 properties into one aggregated view.
Creates a Google shared drive for collaboration or storage. When reusing a request ID, an existing drive returned is not guaranteed to be the drive originally created with that ID.
DEPRECATED: Creates a new Google Spreadsheet and populates its first worksheet from JSON rows; an empty list creates an empty worksheet. Headers use keys from the first row followed by additional keys found in later rows.
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. The shortcut receives its own distinct file ID (capture from response). No parent folder parameter exists; use GOOGLEDRIVE_MOVE_FILE after creation to place the shortcut in the desired location.
Creates a new Google Slides presentation from Markdown, splitting content into slides at '---' separators and selecting layouts based on content structure. Images that fail validation or cannot be fetched may be skipped; skipped URLs are reported in the execution message.
Inserts a new column in a Google Spreadsheet at a specified index. Select the target sheet by numeric ID or name; if neither is provided, sheet ID 0 is used.
Inserts a new, empty row into a specified sheet of a Google Spreadsheet at a given index, optionally inheriting formatting from the row above.
Creates a session token for 2D map tiles or Street View imagery, reusable for subsequent tile requests within its validity window. Managed requests support standard-resolution 2D map sessions only.
Deletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain.
Deletes a secondary calendar that you own or have delete permissions on. Deletion is permanent and irreversible β verify the correct calendar_id before calling. 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. Parallel calls may trigger userRateLimitExceeded; sequence bulk deletions.
Delete an existing chart from a Google Sheets spreadsheet. Use this action when you need to remove a chart that is no longer needed or needs to be replaced. This action is irreversible β once a chart is deleted, it cannot be recovered. The chart data source (the cells containing the data) remains unchanged; only the chart visualization is removed.
Tool to remove a child from a folder using Google Drive API v2. Use when you need to remove a file from a specific folder.
Permanently deletes a comment thread (and all its replies) from a Google Drive file β this action is irreversible. To remove only a single reply within a thread, use GOOGLEDRIVE_DELETE_REPLY instead. Verify the exact comment content and comment_id before calling.
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. Note: Every segment (body, header, footer, footnote) in Google Docs ends with a final newline character that cannot be deleted. Ensure the endIndex does not include this trailing newline.
Delete a Data Manager user list, optionally validating only.
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.
Permanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct `draft_id` and obtain explicit user confirmation before calling. Ensure the draft exists and the user has necessary permissions for the given `user_id`.
Deletes an event from the specified calendar. Only Google's HTTP 204 confirms deletion; 404 or 410 can also mean the event belongs to a different calendar. Bulk deletions may trigger `rateLimitExceeded` or `userRateLimitExceeded`; cap concurrency to 5β10 requests and apply exponential backoff.
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. Deleting a folder permanently removes all nested files and subfolders.
Tool to delete a footer from a Google Document. Use when you need to remove a footer from a specific section or the default footer.
Tool to permanently delete a Gmail filter by its ID. Use when you need to remove an existing email filtering rule.
Deletes a member who was previously assigned roles in a Google Meet space. Requires the full spaces/{space}/members/{member} resource name. This removes the member's space role assignment, not a participant from an active conference. Returns an empty object on success.
Deletes a specified header by ID from a Google Document, optionally targeting a document tab.
Permanently delete a deletable key event from a Google Analytics property. Deletion cannot be undone. Requires the connection to grant the https://www.googleapis.com/auth/analytics.edit scope, which is not requested by default.
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.
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.
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.
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.
Tool to remove a parent from a file using Google Drive API v2. Use when you need to remove a file from a specific folder.
Deletes a specified permission from a file or shared drive by permission ID; deleting other permissions does not remove an existing public-access permission. Check the returned success flag: an owner permission that cannot be removed returns success=false.
Move a Google Analytics property to the Trash Can and return its deletion state. This is a soft delete, not an immediate permanent purge. The API cannot restore the property; restoration is available through the Trash Can UI until expireTime. If it is not restored, the property and its child resources are permanently purged. Requires the https://www.googleapis.com/auth/analytics.edit OAuth scope, which is not granted by default.
Delete a custom property from a Google Drive file using API v2. The property is selected by key and visibility; visibility defaults to private when omitted.
Tool to delete a specific reply by reply ID. Deletion is irreversible; obtain explicit user confirmation before calling. Removes only the targeted reply, not the full comment thread β use GOOGLEDRIVE_DELETE_COMMENT to remove the entire thread.
Tool to permanently delete a file revision. Use when you need to remove a specific version of a binary file (images, videos, etc.). Cannot delete revisions for Google Docs/Sheets or the last remaining revision.
Tool to permanently delete a shared drive. Use when you need to remove a shared drive and its contents (if specified).
Tool to delete a sheet (worksheet) from a spreadsheet. Use when you need to remove a specific sheet from a Google Sheet document.
Deletes a tab from a Google Document. This action is irreversible β the tab cannot be recovered once removed. Use when you need to remove a tab and all its child tabs from a document's tab structure.
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.
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.
Deletes a specified task from a Google Tasks list. Deletion is permanent and irreversible β confirm with the user before executing, and consider GOOGLETASKS_UPDATE_TASK or GOOGLETASKS_MOVE_TASK as non-destructive alternatives. Both tasklist_id and task_id are required parameters. 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.
Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible. Require explicit user confirmation before calling; do not invoke in read-only or exploratory flows.
Tool to immediately and permanently delete a specified thread and all its messages. This operation cannot be undone. Use threads.trash instead for reversible deletion.
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. Capped at 100 elements per request (elements = origins Γ destinations count); split large sets into batches.
Downloads a Drive file's content and returns it in `downloaded_file_content`. For native blob files such as PDFs, images, videos, and Office files, it returns the original bytes without conversion; leave `mime_type` unset. For Google Workspace documents, it exports the content and `mime_type` optionally selects the export format.
Download the stored bytes of one blob-file revision. This action does not export Google Docs, Sheets, Slides, or other Workspace revisions. Use GOOGLEDRIVE_GET_REVISION to retrieve a Workspace revision's exportLinks, then download the selected export URL separately.
Starts a long-running operation to download a Drive file, including Google Vids files, or export supported Google Workspace documents. Returns operation status and metadata; operations are valid for 24 hours from creation.
Downloads an app-created Google Photos media item and returns it as a file.
Replaces the entire content of an existing Google Drive binary file with UTF-8 text while retaining its file ID. Google Docs, Sheets, Slides, and other checked Workspace file types are not supported.
Generates a Google Maps Embed URL and HTML iframe code for place, view, directions, street view, or search mode using an API key, without making an API call. Supply URL-escaped parameter values; generated URLs contain the key and location query.
Tool to permanently and irreversibly delete ALL trashed files in the user's Google Drive or a specified shared drive. Recovery is impossible after execution β no Drive tool can restore items once trash is emptied. Affects every item in trash across the entire account or shared drive, not just files from the current workflow. Always obtain explicit user confirmation and clarify that recovery is impossible before executing. Provide driveId to target a specific shared drive's trash; omit to empty the user's root trash.
Ends an active conference in a specified Google Meet space, immediately dropping active participants. A response indicating there is no active conference is also treated as success; obtain explicit user confirmation before calling.
Immediately stop a running experiment without deleting its campaigns, or validate that operation. Google changes the experiment's end date to now.
Deprecated SQL facade for selecting, inserting, updating, and deleting data in automatically detected spreadsheet tables, including limited WITH queries; discovery reads at most 10,000 rows per sheet. For detected header-based tables, the first data row is skipped and update/delete row targeting can be offset.
Export an entire native spreadsheet as XLSX, ODS, PDF, ZIP, CSV, or TSV; use Export Sheet as PDF for print layout and range controls.
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.
Exports a Google Workspace document to the requested MIME type and returns exported file content. Use when you need to export Google Docs, Sheets, Slides, Drawings, or Apps Script files to a specific format. Note: The exported content is limited to 10MB by Google Drive API.
DEPRECATED: Exports Google Workspace files (max 10MB) to a specified format using `mime_type`, or downloads other file types; use `GOOGLEDRIVE_DOWNLOAD_FILE` instead.
Render one sheet tab or rectangular range as PDF with orientation, gridline, margin, and fit-to-width controls.
Lists Gmail messages with query and label filtering, pagination, and optional message details. Individual detail fetches returning 404, 429, or 503 are skipped, so a page can contain fewer messages than the list result.
Fetches a Gmail message by its message ID in the requested format and returns formatted message details. Available fields depend on the format.
Retrieves messages from an accessible Gmail thread by thread ID, returning thread details and a messages array. Message order is not guaranteed; use messageTimestamp to identify oldest or newest messages and labelIds to filter drafts.
Finds and replaces text across cells in a Google Spreadsheet, scoped to a sheet, range, or all sheets; if no scope is specified, it searches all sheets. Formula cells can be included explicitly when fixing formula references or patterns.
Finds events in a specified Google Calendar using text, time ranges, and event types. Results are returned in event_data.event_data and may span multiple pages; follow nextPageToken even when a page is empty.
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"
Finds one page of Google Drive folders by name and optional parent. Use nextPageToken with page_token to retrieve additional pages.
Queries busy intervals and calculates free gaps for specified calendars, without filtering by meeting duration; the range is limited to 89 days, and calendar errors produce empty free slots marked unreliable. Omitted start defaults to now, and omitted end to 23:59:59 on the applicable day in the specified timezone.
Resolve transient Street View panorama IDs near up to 100 coordinates.
Formats a specified cell range in a Google Sheets worksheet. It always applies text style, font size and background color defaults unless supplied; a sheet prefix in an A1 range is ignored, so select the worksheet separately.
Forwards an existing Gmail message to specified recipients, with optional additional text. The tool copies original message parts into a new message, but may alter MIME structure and attachment metadata.
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.
Forecast clicks, conversions and costs for a hypothetical keyword campaign without creating resources.
Retrieve historical search volumes, competition, and bid metrics for supplied keywords without creating or changing advertising resources.
Generate keyword ideas and planning metrics from exactly one seed form.
Geocode a street address or address components to latitude and longitude, which may be approximate. API key authentication supports component-only queries; OAuth without an API key requires an address. DEPRECATED: Consider the newer Text Search action instead.
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. Results may match multiple places β always verify `formattedAddress`, `region`, and `addressComponents` in the response before using returned coordinates.
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.
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.
Geocode an address into geographic coordinates, reverse geocode coordinates to find an address, or look up a place by its Place ID using Googleβs Geocoding API v4beta. Choose one lookup mode per request; language and region options can guide results.
Estimate a device's geographic location from cell tower and WiFi observations. With a connected Google Maps account, IP fallback can be used; managed requests require device observations and disable IP fallback.
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.
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. The Map Tiles API is billable per request; cache the root response client-side and avoid repeated calls.
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. Note: storageQuota reflects My Drive (personal) storage only β it does not cover shared drives; use GOOGLEDRIVE_LIST_SHARED_DRIVES and GOOGLEDRIVE_GET_DRIVE for shared drive quotas. A successful response confirms base Drive read access only; write access and shared drive access must be verified separately.
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).
Retrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain.
Retrieves a Google Photos album created by this app by its ID.
Tool to get information about a specific Drive app by ID. Use 'self' as the app ID to get information about the calling app.
Tool to retrieve attribution configuration for a Google Analytics property. Use when you need to check attribution models, lookback windows, and conversion export settings.
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.
Tool to get configuration metadata about a specific audience export. Use when you need to understand an audience export after it has been created or check its status.
Tool to get configuration metadata about a specific audience list. Use after confirming the audience list resource name.
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.
Tool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value.
Retrieve a Google Ads campaign's name and status by numeric campaign ID for the specified or connected customer account.
Retrieve the first Google Ads campaign matching an exact name for the specified or connected customer account. Names containing quotes, backslashes, NUL or line breaks are not supported.
Tool to get a specific change by ID from Google Drive v2 API. Deprecated: Use changes.getStartPageToken and changes.list to retrieve recent changes instead.
Tool to get the starting pageToken for listing future changes in Google Drive. Returns only a token β pass it to GOOGLEDRIVE_LIST_CHANGES to retrieve actual changes. Persist this token; losing it requires a full rescan. The token is forward-looking: GOOGLEDRIVE_LIST_CHANGES may return no results if no changes have occurred since issuance. For simple recent-file lookups, prefer GOOGLEDRIVE_FIND_FILE; use this tool only for incremental change-feed workflows.
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.
Tool to get a specific child reference for a folder using Drive API v2. Use when you need to verify a specific file exists as a child of a folder.
Returns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events.
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.
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.
Tool to get a specific conference record by its resource name. Use when you have the conference record ID and need to retrieve detailed information about a single meeting instance.
Lists saved Google contacts with selectable fields and pagination, optionally including Other Contacts. Other Contacts are fetched on the first page; endpoint failures can result in partial results, and contact records may be sparse.
Retrieve provider-generated website or call conversion tag snippets after creating a conversion action. Markup is returned exactly as Google provides it.
Retrieve one Data Manager ingestion status snapshot. SUCCESS, FAILED, and PARTIAL_SUCCESS are terminal. PROCESSING and REQUEST_STATUS_UNKNOWN are not. The caller owns the documented backoff loop.
Gets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., 'tomorrow', 'next Monday') to avoid off-by-one-day errors across timezones.
Identifies the Google user connected to Calendar from the primary calendar resource. Returns the account identifier, email when available, display name, timezone, and primary calendar ID. This is Calendar identity metadata, not a full Google Account or People profile.
Returns current localized weather conditions for geographic coordinates.
Tool to retrieve a single CustomDimension by its resource name. Use when you need detailed information about a specific custom dimension including its display name, scope, and parameter name.
List a page of Google Ads customer lists (audience and remarketing user segments), not Google Ads accounts. Use the returned next-page token to retrieve further lists, and review similarly named results before selecting one.
Get one Data Manager user list without modifying it.
Retrieve client-side data redaction settings for a GA4 web data stream.
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.
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.
Retrieve one Google Analytics data stream by its resource name.
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.
Fetches directions between an origin and destination, with optional intermediate waypoints, travel modes, and preferences for avoiding tolls, highways, or ferries. DEPRECATED: Use the Google Maps Routes API instead. The legacy Directions API is not available to new Cloud projects; existing projects can continue to use it.
Retrieve a native Google Docs document's structured content and metadata by ID.
Retrieves an existing Google Document by its ID; will error if the document is not found.
Retrieves the end index and paragraph structure of a Google Document or specific segment. Use this action when you need to determine valid insertion points for text operations, especially before using insertText requests. The end index represents the maximum boundary of the document body or specified segment (header, footer, footnote, or tab).
Retrieve a Google Doc by ID and return a best-effort plain-text rendering. Converts document structure into plain text including paragraphs, lists, and tables without requiring clients to traverse complex Docs API JSON.
Retrieves a single Gmail draft by its ID. Use this to fetch and inspect draft content before sending via GMAIL_SEND_DRAFT. The format parameter controls the level of detail returned.
Get selected metadata fields for one Google Drive file by ID.
Get JSON metadata for one Drive file without downloading its content.
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.
Returns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying.
Get one Google Ads experiment by resource name or numeric ID.
Get one Google Ads experiment arm, including draft campaigns.
Gets a Drive file's metadata by ID, optionally returning only the metadata selected by `fields`. Use `fields` such as `id,name,mimeType,parents,modifiedTime` when a compact partial response is needed; omit it for Google's default metadata. This does not download file content: use GOOGLEDRIVE_DOWNLOAD_FILE for native bytes or exported Workspace content.
Retrieve the immutable installation snippet for a GA4 web data stream.
Retrieves a Gmail message attachment by message and attachment IDs and returns a downloadable file using the supplied filename.
Tool to retrieve a specific Gmail filter by its ID. Use when you need to inspect the criteria and actions of an existing filter.
Gets canonical metadata for one Google Calendar, defaulting to the authenticated user's primary calendar. Returns its identifier, title, description, location, time zone, and conference properties. Use GOOGLECALENDAR_CALENDAR_LIST_GET for one calendar's user-specific list settings such as access role, color, visibility, selection, and default reminders; use GOOGLECALENDAR_LIST_CALENDARS to enumerate accessible calendars.
Retrieve a Google Form's definition, questions, settings, and publishing state by ID.
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.
Retrieves a Google Slides presentation by ID, including its page structures. An optional field selector can limit the returned data.
Retrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size.
Retrieve a Key Event by its resource name. This operation is read-only.
Gets details for a specified Gmail label. Use this to retrieve label information including name, type, visibility settings, message/thread counts, and color.
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.
Retrieve details of a Google Meet space using its unique identifier. Newly created spaces may return incomplete data; retry after 1β3 seconds if needed.
Get a configured Google Meet space member by resource name, including their email and meeting role. Use when the space and member identifiers are already known.
Tool to get metadata for dimensions, metrics, and comparisons for a GA4 property. Use to discover available fields before building a report β always derive dimension/metric apiNames from this output rather than hardcoding from GA4 UI labels, which differ. Available fields vary per property; skip validation and downstream report tools like GOOGLE_ANALYTICS_RUN_REPORT return 400 INVALID_ARGUMENT on incompatible or invalid field combinations. Response can contain hundreds of fields; filter to relevant subset before passing to downstream logic.
Tool to generate a thumbnail of the latest version of a specified page. Use when you need a preview image URL for a slide page. This request counts as an expensive read request for quota purposes.
Tool to get a specific parent reference for a file using Drive API v2. Use when you need to retrieve information about a specific parent folder of a file.
Get a Google Meet conference participant by resource name, including their identity and first-join/last-leave times. Use when the conference record and participant IDs are known.
Retrieves detailed information about a specific participant session from a Google Meet conference record. Returns session details including start time and end time for a single join/leave session. 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. PREREQUISITE: You must first obtain the participant session resource name. Use LIST_PARTICIPANT_SESSIONS with a conference record ID and participant ID to get available sessions and their resource names. The 'name' parameter is REQUIRED and must be in the format: 'conferenceRecords/{conference_record}/participants/{participant}/participantSessions/{participant_session}'
Retrieves a person's details by resource name or lists the authenticated user's Other Contacts, using a field mask to select the information returned. Other Contacts can be paginated and queried using a sync token for changes since a previous sync.
Gets a permission by ID. Use this tool to retrieve a specific permission for a file or shared drive. Newly created or updated permissions on shared drives may have a brief propagation delay before appearing.
Tool to get the permission ID for an email address using the Drive API v2. Use when you need to convert an email address to its corresponding permission ID.
Retrieves details for a specific place by place ID or resource name. The returned details depend on the requested field mask; by default, it requests the ID, display name, and formatted address.
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.
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.
Retrieve the latest version of a presentation by ID or exact name, selecting the first matching non-trashed presentation for a name. Returned slide and page-element information is limited to IDs and page types rather than full slide content.
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.
Generate one short-lived page thumbnail URL using an expensive Slides quota read.
Retrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user. messagesTotal counts individual emails; threadsTotal counts conversations; neither is per-label β use GMAIL_FETCH_EMAILS with label filters for label-specific counts. The returned historyId seeds incremental sync via GMAIL_LIST_HISTORY; if historyIdTooOld is returned, rescan with GMAIL_FETCH_EMAILS before resuming. Response may be wrapped under a top-level data field; unwrap before reading fields. A successful call confirms mailbox connectivity but not full mailbox access if granted scopes are narrow. Use the returned email address to dynamically identify the authenticated account rather than hard-coding it.
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.
Tool to get a property by its key using Google Drive API v2. Use when you need to retrieve a specific custom property attached to a file.
Tool to retrieve all property quotas organized by category (corePropertyQuota, funnelPropertyQuota, realtimePropertyQuota) for a given GA4 property. Use when you need to check current quota usage. Snapshot data can lag real consumption by several minutes; treat reported values as approximate and avoid scheduling high-volume jobs at full apparent capacity.
Get a Google Meet recording's metadata by resource name, including its state, timestamps, and Google Drive destination when available. Use when the conference record and recording identifiers are known; this does not download the recording file.
Retrieves recordings from Google Meet for a given conference record ID. Only returns recordings if recording was enabled and permitted by the organizer's domain policies; a valid conference_record_id does not guarantee recordings exist. After a meeting ends, recordings may take several minutes to process β an empty result may be temporary, not permanent.
Tool to get configuration metadata about a specific recurring audience list. Use when you need to understand a recurring audience list's state after it has been created or to get the resource name of the most recent audience list instance.
Tool to get a specific reply to a comment on a file. Use when you need to retrieve the details of a particular reply.
Tool to get report metadata about a specific report task. Use after creating a report task to check its processing state or inspect its report definition.
Run a prominent, bounded Google Ads report template for Customer, Campaign, Ad, Keyword, Search Term, Dynamic Search Ads Search Term, or Bidding Strategy. Official required columns are always selected; dates default to LAST_30_DAYS.
Tool to get a specific revision's metadata (name, modifiedTime, keepForever, etc.) by revision ID. Returns metadata only β not file content. Use a separate download tool to retrieve file content or restore a revision.
Calculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps. Response `duration` is a string with 's' suffix (e.g., `"4557s"`); parse before displaying.
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.
Tool to get a shared drive by ID. Use when you need to retrieve information about a specific shared drive. To discover drive_ids, use GOOGLEDRIVE_LIST_SHARED_DRIVES first; GOOGLEDRIVE_GET_ABOUT reflects overall user storage, not individual shared drive details. Permission changes may have a brief propagation delay before appearing in results.
Lists all worksheet names from a specified Google Spreadsheet (which must exist), useful for discovering sheets before further operations.
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.
Get metadata for a Google Meet smart note generated by Take Notes with Gemini. Use when the conference record and smart note identifiers are known. Returns state, timestamps, and the Google Docs destination when available, not the full note content. Fetch document content separately with the Google Docs API.
Retrieve a Google Spreadsheet's structure, metadata, and selected grid data.
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.
Retrieves metadata for a Google Spreadsheet using its ID. By default, returns essential information (ID, title, sheet properties) to avoid payload size issues. Use the fields parameter for comprehensive metadata or specific fields.
Returns a range of values from a spreadsheet. Use when you need to read data from specific cells or ranges in a Google Sheet.
Read cell values from one range in a Google Sheets spreadsheet.
Read values from one range in a Google Spreadsheet.
Return detailed metadata for a Street View panorama.
Download one image tile from a Street View panorama.
Deprecated: Retrieves an inferred schema for a detected table in a Google Spreadsheet, including column names and types estimated from sampled data.
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. Use this to refresh task details before display or edits rather than relying on potentially stale results from GOOGLETASKS_LIST_TASKS.
Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user.
Retrieves time zone information for a specific geographic location and timestamp. Use this action when you need to determine the time zone ID, UTC offset, daylight savings offset, or localized time zone name for any point on Earth. The API considers the provided timestamp to accurately determine whether daylight savings is in effect at that moment.
Retrieves a specific transcript by its resource name. Returns transcript details including state (STARTED, ENDED, FILE_GENERATED), start/end times, and Google Docs destination. PREREQUISITE: Obtain the transcript resource name first by using GET_TRANSCRIPTS_BY_CONFERENCE_RECORD_ID or construct it from known IDs.
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}'
Lists a page of transcripts for a Google Meet conference record, with a continuation token when more results are available. Transcripts may require processing time after a meeting ends; an empty result may be transient or indicate that no transcript was generated.
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.
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.
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.
Tool to import a message into the user's mailbox with standard email delivery scanning and classification. Use when you need to add an existing email to a Gmail account without sending it through SMTP. This method doesn't perform SPF checks, so it might not work for some spam messages.
Upload ad events for an allowlisted Data Partner to Google Analytics, not Ads. Requires an eligible Data Partner account linked to the target advertiser. Use validate_only=true for the provider's deprecated no-execution check. The response is empty; this operation does not return a request ID.
Validate or asynchronously ingest Data Manager audience members. Use validate_only=true for a no-upload check. Customer Match terms must already be accepted for contact/mobile data; do not assert acceptance without authority. Consent may be supplied per request or member. A request ID confirms acceptance, not completion; poll request status for processing errors and partial failures.
Validate or submit a bounded Google Ads conversion-event batch. Set validate_only=true for a no-ingestion check. False starts irreversible asynchronous processing and returns a request ID for later status checks.
Ingest account-level identity linkage, not audience-list membership. Requires provider allowlisting. Each user links hashed first-party identifiers with mobile device IDs. Set validate_only=true for no ingestion. A request ID confirms asynchronous acceptance, not completion; poll request status for errors.
Inserts an existing calendar into the user's calendar list, with optional display settings. The primary keyword is not accepted; provide the actual calendar ID.
Tool to insert a file into a folder using Drive API v2. Use when you need to add an existing file to a folder.
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.
Tool to add a parent folder for a file using Google Drive API v2. Use when you need to add a file to an additional folder.
Inserts an image from a URI at a position in a Google Document table cell identified by table start index, row and column. The table lookup searches top-level body content, including the specified top-level tab when provided.
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.
Tool to insert a message into the user's mailbox similar to IMAP APPEND. Use when you need to add an email directly to a mailbox bypassing most scanning and classification. This does not send a message.
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.
Tool to add a property to a file, or update it if it already exists (v2 API). Use when you need to attach custom key-value metadata to a Google Drive file.
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.
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.
Inserts a new row into a table in a Google Document at a specified location. Use this action when you need to add a row to an existing table, either above or below a reference cell location.
Creates a task in a specified list, optionally under a parent or after a sibling in that list. Date inputs accept various formats; due dates are normalized to midnight UTC, discarding the time, and repeated calls can create duplicate tasks.
Insert text into a Google Docs table using the table's start index and zero-based row and column positions. Existing table content can cause the text to be inserted outside the requested cell.
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.
List principals and roles granted on an Analytics account or property. Requires the https://www.googleapis.com/auth/analytics.manage.users or analytics.manage.users.readonly OAuth scope, which is not granted by default.
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.
List Google Ads customer resource names directly accessible to the authenticated OAuth user. Google determines the complete result from the OAuth credentials and ignores customer_id and login-customer-id; this action does not filter the response. For MCC child account names, status, and direct hierarchy, use List Sub Accounts.
Tool to retrieve summaries of all Google Analytics accounts accessible by the caller. Use when you need a high-level overview of accounts and their properties without fetching full account details.
List Google Analytics accounts accessible to the caller using the v1beta API. Results are paginated and may include accounts without GA properties; soft-deleted accounts are excluded by default.
Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules.
Lists a page of AdSense links for a Google Analytics property. Use the returned next-page token to retrieve additional pages.
Lists Google Photos albums created by this app, with pagination support.
List tasks across the user's task lists with optional filters, annotating each returned task with its list ID and title. Results are limited to 1,000 tasks by default, with a configurable limit and a truncation indicator.
Lists a page of approvals associated with a Google Drive file, with pagination for browsing subsequent pages. Approval details are unavailable through this action.
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.
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.
List audience configurations for a Google Analytics property; audiences created before 2020 may not be supported. Returned filter clauses include their types but not the full membership criteria.
Tool to list BigQuery Links on a property. Use when you need to retrieve BigQuery link resources associated with a Google Analytics property. Results support pagination for large datasets.
Lists a page of buildings for a Google Workspace customer, including available addresses, coordinates, and floor names. Use the continuation token for further pages; Directory API access and appropriate administrator privileges are required.
List Calculated Metrics
Retrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference spaces, or other bookable calendar resources in an organization. The action supports filtering by resource category, capacity, building location, and other criteria. IMPORTANT: This requires Admin SDK Directory API access and appropriate admin permissions - it is NOT available for personal Gmail accounts, only Google Workspace domains.
Lists a page of changes for a user or shared drive; without a page token, it obtains a current start token and lists subsequent changes rather than earlier activity. Follow nextPageToken to continue and save newStartPageToken for future monitoring.
Tool to list ChannelGroups on a property. Use when you need to retrieve channel groups that categorize traffic sources in Analytics reports.
Lists all charts in a Google Sheets spreadsheet across all sheets, returning chart_id, sheet metadata, chart type, title, and position. Use this action when you need to discover what charts exist in a spreadsheet, retrieve chart IDs for update or delete operations, or inspect chart configurations. The default field mask in GOOGLESHEETS_GET_SPREADSHEET_INFO omits chart data, making this dedicated action necessary for chart discovery.
Lists comments on a Google Drive file, with pagination, an option to include deleted comments, and a minimum modification-time filter. Filter by author or content client-side.
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.
Lists deprecated conversion event resources configured for a Google Analytics property. Google recommends using key events instead.
Lists a page of client-side encrypted identities and their key-pair associations. A response indicating that CSE is not enabled is returned as an empty list.
Lists a page of client-side encryption key pairs, including public keys and enablement states. A response indicating that CSE is not enabled is returned as an empty list.
List Custom Dimensions
Tool to list CustomMetrics on a property. Use when you need to retrieve all custom metrics configured for a given property.
List conversion actions usable as Google Ads Data Manager destinations. Returns numeric destination IDs, true owning accounts, action types, and availability; defaults to enabled offline and enhanced-lead actions.
List one page of Data Manager user lists and their lifecycle configuration.
Tool to list DataStreams on a property. Use when you need to retrieve data stream configurations for a Google Analytics property.
Tool to list Display & Video 360 advertiser links on a property. Use when you need to retrieve DisplayVideo360AdvertiserLink resources associated with a Google Analytics property. Results support pagination for large datasets.
Tool to list DisplayVideo360AdvertiserLinkProposals on a property. Use when you need to retrieve Display & Video 360 advertiser link proposals associated with a Google Analytics property. Results support pagination for large datasets.
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. Draft ordering is non-guaranteed; iterate using page_token until it is absent to retrieve all drafts. Newly created drafts may not appear immediately. Rapid calls may trigger 403 userRateLimitExceeded or 429 errors; apply exponential backoff (1s, 2s, 4s) before retrying.
Start a Drive change monitor or list one page after an existing token.
List permissions for a Google Drive file, folder, or shared drive.
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.
List event edit rules configured on a GA4 web data stream.
Lists or incrementally synchronizes events from one calendar, defaulting to the connected user's primary calendar. Use timeMin/timeMax for a time window, singleEvents to expand recurring series, showDeleted to include cancelled events, query for text search, orderBy to sort, pageToken to continue a page sequence, and syncToken to retrieve changes after a completed full sync. A sync token cannot be combined with event, text, property, time, update-time, or ordering filters; keep other parameters unchanged across sync pages. The final page returns nextSyncToken, and an expired token requires a new full sync after Google returns HTTP 410. Use fields to request a smaller partial response, including continuation tokens needed by the workflow.
Lists and deduplicates events across selected calendars or the user's calendar list for a time range. Returns a compact summary by default, with full event details available on request; per-calendar errors can make results incomplete.
Tool to list ExpandedDataSets on a property. Use when you need to retrieve expanded data set configurations for a Google Analytics 360 property.
List Google Ads experiment arms, including draft campaigns.
List Google Ads experiments, optionally filtered by status and type.
Lists labels applied to a Google Drive file, including label IDs and applied field IDs. An empty labels array is a valid response; additional pages may be available.
Tool to list a file's revision metadata (not content) in Google Drive. Drive may prune old revisions, so history may be incomplete for frequently edited files. Filter client-side for specific revisionIds; do not assume the last entry is the active version.
Tool to list FirebaseLinks on a property. Use when you need to retrieve Firebase connections associated with a Google Analytics property. Each property can have at most one FirebaseLink.
Lists a page of child references for a folder using Google Drive API v2. Follow the returned nextPageToken to retrieve additional pages.
Tool to list all forwarding addresses for the specified Gmail account. Use when you need to retrieve the email addresses that are allowed to be used for forwarding messages.
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.
Lists Gmail mailbox change history since a known history ID for incremental sync, with optional label and history-type filters and pagination. An empty history list means no records matched the request, not necessarily that no mailbox changes occurred.
Retrieves all system and user-created labels for a Gmail account in a single unpaginated response. Primary use: obtain internal label IDs (e.g., 'Label_123') required by other Gmail tools β display names cannot be used as label identifiers and cause silent failures or errors. System labels (INBOX, UNREAD, SPAM, TRASH, etc.) are case-sensitive and must be used exactly as returned; INBOX, SPAM, and TRASH are read-only and cannot be added/removed via label modification tools. The Gmail search 'label:' operator accepts display names, but label_ids parameters in tools like GMAIL_FETCH_EMAILS require internal IDs from this tool β mixing conventions yields zero results silently. Do not hardcode label IDs across sessions; refresh via this tool on conflict errors.
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.
Lists calendars accessible through the connected user's CalendarList, returning IDs and user-specific metadata such as access role, color, visibility, selection, and reminders. Hidden calendars are omitted unless show_hidden is true; min_access_role and show_deleted provide additional filtering. Continue with page_token until next_page_token is absent; for incremental synchronization, pass next_sync_token back as sync_token. Use returned IDs, not display names, with event actions, and use GOOGLECALENDAR_GET_CALENDAR for canonical metadata about one known calendar.
Return one page of submissions for a Google Form.
List key event definitions for a Google Analytics property. Results are paginated, with a next-page token when more results are available.
Lists available Google Drive labels, returning each label's ID and display name without requiring a file ID.
Tool to list MeasurementProtocolSecrets under a data stream. Use when you need to retrieve measurement protocol secrets for server-side event tracking.
Lists photos and videos created by this application in the user's Google Photos library, with pagination. It cannot list the user's entire library.
List configured members of a Google Meet space, including their email and meeting role. Use to discover space member resource names, not participants attending a conference. Follow nextPageToken to retrieve subsequent pages.
Lists a page of participant sessions for a specific participant in a Google Meet conference, including session start and end times. Sessions represent joins from devices, with repeated joins creating separate sessions; use the returned page token to retrieve further sessions.
Lists the participants in a conference record. By default, ordered by join time descending. Use to retrieve all participants who joined a specific Google Meet conference, with support for filtering active participants (where `latest_end_time IS NULL`).
Lists a page of permissions for a file or shared drive. Use the returned next page token to retrieve further pages when present.
Tool to list a file's properties in Google Drive API v2. Use when you need to retrieve custom properties (key-value pairs) attached to a file.
Tool to list GA4 properties based on filter criteria. Use when you need to find properties under a specific parent account or with specific firebase projects. Supports pagination and including soft-deleted properties.
Tool to list recording resources from a conference record. Use when you need to retrieve recordings from a specific Google Meet conference. Recordings are created when meeting recording is enabled and saved to Google Drive as MP4 files.
List a page of recurring audience lists for a GA4 property, with a continuation token when more results are available. Use it to find existing recurring audience lists.
List a page of replies to a specific comment on a Google Drive file. Supports pagination and optionally including deleted replies.
List a page of report tasks for a Google Analytics property, including task definitions and execution status. A continuation token can be used to retrieve subsequent pages.
List a page of Reporting Data Annotations for a specific GA4 property, optionally filtering the results. Annotations document important events or periods in reporting data.
Lists S/MIME certificate configurations for a specified Gmail send-as alias. If Gmail reports that the feature is not enabled, returns an empty list with S/MIME marked disabled.
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.
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.
Lists the authenticated user's calendar settings, returning a page of settings identified by their id fields. Supports pagination and incremental synchronization using a sync token.
Lists shared albums visible in the user's Google Photos Sharing tab, with pagination. DEPRECATED: Google removed shared-album listing after March 31, 2025; use the Google Photos app to manage sharing instead.
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. Results may differ from the web UI due to admin policies; listing a drive does not guarantee access to its contents. Paginated calls may trigger 403 rateLimitExceeded or 429 tooManyRequests; apply exponential backoff when iterating many pages.
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.
List metadata for smart notes generated by Take Notes with Gemini in a Google Meet conference. Returns resource names, generation states, timestamps, and Google Docs destinations, not note text. Follow nextPageToken to retrieve subsequent pages.
List direct child/sub-accounts under a Google Ads manager (MCC) account. Use this before account-scoped read or mutate calls when a user needs to choose which child account to target. The returned customer_id values can be passed to other Google Ads tools as their customer_id.
List a page of subproperty event filters on a property, including filters that route events to subproperties. Use the returned page token to retrieve subsequent pages.
Tool to list SubpropertySyncConfig resources for managing subproperty synchronization configurations. Use when you need to fetch subproperty sync configs for a GA4 property.
Deprecated: Lists heuristically detected tables in a Google Spreadsheet. It scans up to the first 1,000 rows and skips sheets with more than 2,000 rows or 100 columns.
Fetches the authenticated user's task lists from Google Tasks; results may be paginated. Response contains task lists under the `items` key. Multiple lists may share similar names β confirm the correct list by ID before passing to other tools.
Retrieves tasks from a Google Tasks list with optional date, status, and pagination filters; date inputs can use human-readable formats, and a completion range forces an explicit false showCompleted value to true. Tasks are returned under `tasks`, ordered by position; filter titles or notes client-side for text search.
Retrieves a list of email threads from a Gmail account, identified by `user_id` (email address or 'me'), supporting filtering and pagination. Spam and trash are excluded by default unless explicitly targeted via `label:spam` or `label:trash` in the query.
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.
Finds the first row in a specified A1 range or the first sheet where a cell matches the query after Unicode and invisible-character normalization. Matching is case-insensitive and trims surrounding whitespace by default; both behaviors are configurable.
Tool to look up an aerial view video by address or video ID. Returns video metadata including state and URIs for playback. Use when you need to retrieve a previously rendered aerial video or check the status of a video render request. A PROCESSING response includes metadata.videoId for a later lookup and no playback URIs. Only a lookup returning a ready video is billable.
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).
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.
Adds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid. To modify a single message only, use a message-level tool instead.
Moves a default event to another calendar, changing its organizer. Other event types cannot be moved.
Moves a file to another Google Drive folder. At least one of `add_parents` or `remove_parents` is required; calls with neither are rejected. Supply `add_parents` with the destination folder ID; if `remove_parents` is omitted, the action checks and removes the current parent automatically before adding the destination. For My Drive files only, `remove_parents` without `add_parents` moves the file to My Drive root. For shared-drive items, set `supports_all_drives=true` and provide `add_parents` because the item must retain exactly one parent; membership, role, and domain policies can restrict moves, and the Drive API cannot move a folder from My Drive into a shared drive. Google Drive files have one parent, so use a shortcut for additional placements.
Move or resize an existing chart on a Google Sheets spreadsheet. Use this action when you need to reposition a chart to a different location on the same or different sheet, move it to a brand-new sheet, or change its size. This action wraps the updateEmbeddedObjectPosition batchUpdate request type and supports three positioning modes: moving to a new sheet, moving to an existing sheet, or repositioning via pixel-perfect overlay coordinates.
Move an existing Google Spreadsheet to a different Google Drive folder.
Moves the specified task to another position in the task list or to a different task list. Use cases: - Reorder tasks within a list (use 'previous' parameter) - Create subtasks by moving a task under a parent (use 'parent' parameter) - Move tasks between different task lists (use 'destinationTasklist' parameter) - Move a subtask back to top-level (omit 'parent' parameter)
Moves an existing, non-deleted email message to the trash for the specified user. Trashed messages are recoverable and still count toward storage quota until purged. Prefer this over GMAIL_BATCH_DELETE_MESSAGES when recovery may be needed. For bulk operations, use GMAIL_BATCH_MODIFY_MESSAGES or GMAIL_BATCH_DELETE_MESSAGES instead of repeated calls to this tool.
Create, update, or remove ads in Google Ads ad groups, including responsive search ads. Use this after creating campaigns, budgets, ad groups, and keywords so the ad group has creative that can serve.
Create, update, or remove links between assets and ad groups. Use this after creating assets to attach sitelinks, callouts, snippets, images, and other asset types at ad group level.
Create, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.
Create, update, or remove Google Ads ad group criteria in a batch, including keywords, audiences, demographics, mobile apps, YouTube placements, topics, webpages, and Shopping listing groups. Manage bids or remove criteria; removal is irreversible, and validate-only requests test changes without committing them.
Create, update, or remove ad groups within Google Ads campaigns. Supports batch operations with multiple ad group changes in a single request. Use when you need to manage ad groups programmatically, such as creating new ad groups for campaigns, updating ad group settings or status, or removing ad groups that are no longer needed. This action is irreversible for remove operations β deleted ad groups cannot be recovered once removed.
Update existing Google Ads ad creative fields. Does not create or remove ads or modify ad-group association/status. Updating TextAd, ExpandedDynamicSearchAd, GmailAd, and ImageAd is not supported. Use validate_only for a dry run and inspect partial_failure_error when partial_failure is enabled.
Create, update, or remove links between assets and Performance Max asset groups. Use this after creating compatible assets and an asset group.
Create, update, or remove Google Ads asset groups for Performance Max campaigns. Use validate_only to check operations without making changes. Link assets separately with Mutate Asset Group Assets. Creating Performance Max asset groups may require a GoogleAdsService mutate with asset links in the same request to satisfy minimum asset requirements.
Create, update, or remove Google Ads asset sets, which group assets for feeds, locations, and other campaign uses. Link assets to a set separately with an AssetSetAsset mutation, and attach sets to campaigns with Mutate Campaign Asset Sets.
Create or update supported Google Ads assets such as sitelinks, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets. Use Create Callout Asset for validated immutable callouts. Google Ads does not allow removing assets; cleanup removes their resource associations.
Create or update Google Ads audiences combining segment attributes. Does not support removal. Use validate_only to check operations without changing audiences. Inspect partial_failure_error when partial_failure is true.
Create, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion Value, and Target Impression Share.
Create, update, or remove links between assets and campaigns. Use this after creating assets to attach sitelinks, callouts, snippets, and other asset types at campaign level.
Create, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign_budget resource name.
Create, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules, audiences, and IP exclusions.
Create or remove relationships between campaigns and labels. Use this after creating labels to organize campaigns for filtering and reporting.
Create, update, or remove Google Ads campaigns in a batch; removal is irreversible and validate-only can check changes before applying them. Creates default to a declaration that the campaign does not contain EU political advertising and to Manual CPC when no bidding strategy is supplied.
Create, update, or remove Search and Display Google Ads campaigns in a batch; new campaigns default to paused when status is omitted. Removal is irreversible, and validate-only can check changes before applying them.
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).
Create, update, or remove Google Ads conversion actions for conversion tracking configuration. This manages Google Ads conversion action resources; installing website/app tags remains outside this action.
Create, update, or remove Google Ads custom audiences used to reach users by interests, searches, visited URLs, place categories, or installed apps.
Update one Google Ads customer's mutable account settings using CustomerService. This is not the GoogleAdsService batch mutate endpoint. Use validate_only=true to check an update without changing account settings.
Create or remove customer-level asset associations. Removal irreversibly removes the current association; recreate it to restore the link. Use this after creating assets to attach callouts, sitelinks, snippets, and other asset types across a Google Ads customer account.
Create, update, or remove Google Ads Keyword Planner ad group keywords. These are planning resources, not serving keywords. Creates need an existing Keyword Plan ad group. Use validate_only to validate without applying changes; validation returns no results. Inspect partial_failure_error when partial_failure is enabled, even on HTTP 200.
Create, update, or remove Google Ads Keyword Planner ad groups. These are planning resources, not serving ad groups. A create needs an existing keyword plan campaign. Use validate_only to check operations without applying changes; validation returns no results. Inspect partial_failure_error when partial_failure is enabled, even on HTTP 200.
Create, update, or remove negative keywords in Keyword Plan campaigns. These planning resources do not change serving campaign keywords. Set validate_only to validate without changes. With partial_failure, inspect partial_failure_error even on HTTP success; valid operations may be applied.
Create, update, or remove campaigns in an existing Keyword Plan. These planning resources do not create serving ad campaigns. Set validate_only to validate without changes. With partial_failure, inspect partial_failure_error even on HTTP success; successful operations may still have been applied.
Create, update, or remove saved Google Ads Keyword Planner plans. These plans are planning resources, not live advertising campaigns. Use validate_only to validate without saving changes. With partial_failure, inspect partial_failure_error even when the HTTP request succeeds.
Create, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering.
Create, edit, or remove typed Target CPA and Target ROAS portfolio strategies. Attach with Mutate Campaigns, read with Get Required Google Ads Report, and transition all campaigns before removal. Budget alignment is not exposed because Google requires the bidding strategy and campaign budget to be changed atomically with GoogleAdsService.Mutate, while this action uses the resource-specific mutate endpoint. currency_code can be set on create only for manager-account strategies.
Create or remove criteria in a Google Ads shared set, such as negative keywords or excluded placements shared across campaigns.
Create, update, or remove Google Ads shared sets used to group shared criteria, such as negative keyword lists, for reuse across campaigns.
Create, update, or remove general Google Ads user-list resources used for audience targeting and remarketing.
Searches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned fields and number of results.
Partially updates the role or scope of an existing Google Calendar access control rule. Provide at least one of role or scope; you can also choose whether to send sharing notifications. This operation modifies an existing rule rather than creating one.
Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided. At least one of summary, description, location, or timezone must be provided. Empty strings for `description` or `location` clear them.
Updates an existing calendar on the user's calendar list using patch semantics. This method allows partial updates, modifying only the specified fields.
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.
Patches the specified user-created label. System labels (e.g., INBOX, SENT, SPAM) cannot be modified and will be rejected.
Tool to update a permission using patch semantics. Use when you need to modify specific fields of an existing permission without affecting other fields. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.
Tool to update a property on a file using PATCH semantics (v2 API). Use when you need to partially update custom key-value metadata attached to a Google Drive file.
Patches a Gmail send-as alias, including its display name, reply-to address, signature, default status, or SMTP configuration. This tool declares support for service-account OAuth, not standard OAuth.
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.
Updates the title of an existing Google Tasks task list.
Tool to request a ticket for creating a Google Analytics account. Use when you need to initiate the account creation flow that requires user acceptance of Terms of Service.
Tool to query a completed audience export. Use when you need to fetch user rows with pagination.
Tool to query an audience list. Use when you need to retrieve user rows from a GA4 audience list with pagination.
Queries raw busy intervals for one or more calendars or groups over an exact time range. Returns per-calendar and per-group availability and errors, without event titles or details. Use GOOGLECALENDAR_FIND_FREE_SLOTS when you want default time bounds and computed free intervals; use GOOGLECALENDAR_EVENTS_LIST when you need event records.
Tool to retrieve a report task's content. Use this after creating a report task with CreateReportTask and confirming it is in ACTIVE state. This method returns an error if the report task's state is not ACTIVE.
Executes SQL-like SELECT queries against detected tables in a native Google spreadsheet, with filtering, sorting, and limits. Sheet names can refer to the first detected table; detection and query processing are heuristic, and results may omit rows. DEPRECATED: Use GOOGLESHEETS_VALUES_GET or GOOGLESHEETS_BATCH_GET for table reads, and GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW for row lookup or filtering.
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'.
Read values from one or more ranges in a Google spreadsheet.
Validate or asynchronously remove all members of Data Manager audiences.
Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist. Concurrent calls on the same event can overwrite attendee lists β apply changes sequentially per event.
Remove specific users from Data Manager audience destinations. Set validate_only=true to validate without removing users. Execution is asynchronous: a request ID indicates acceptance, not completion. Query its status for errors and partial failures.
Removes a calendar from the user's calendar list, unsubscribing from it without deleting the calendar itself.
Remove users identified by hashed user data from Data Manager destinations. Available only to allowlisted accounts; takes user_data, not audience_members or mobile IDs. Set validate_only=true to validate without removal. A request ID indicates asynchronous acceptance, not completion; query request status for processing errors and partial failures.
Starts rendering an aerial view video for a US postal address. Returns a video ID that can be used with lookupVideo to retrieve the video once rendering completes. Rendering typically takes up to a few hours.
Replaces occurrences of text in a Google Document, either across the document or in selected tabs. Supports case-sensitive matching and regular expressions.
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.
Sends a reply to a Gmail thread using a Re: subject and quoting the latest delivered message. Draft messages are ignored because their Message-IDs have not reached recipients. Requires a thread ID and at least one recipient, and supports optional file attachments.
Upload a file to Google Drive using a resumable session, creating a new file or updating an existing file by ID. The upload is sent in chunks.
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. A single coordinate pair may return multiple results; verify formattedAddress, region, and addressComponents before committing to a result.
Tool to run a GA4 funnel report. Use when you need a customized funnel analysis report for a given property. Funnel step sequence is determined by step attributes in the response, not row order.
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.
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.
Run a customized GA4 event-data report for a property using dimensions, metrics, filters and date ranges or a cohort specification. Requests can include up to 9 dimensions and 10 metrics, with offset and limit for pagination. Dimensions, metrics and filters must be compatible; use GOOGLE_ANALYTICS_CHECK_COMPATIBILITY to check combinations. The invalid `dateRange` dimension is removed from requests; use a date dimension for date-based grouping.
Schedule a Google Ads experiment and return its long-running operation. This materializes the treatment campaign and can begin serving and spending on its start date; the experiment cannot return to SETUP after scheduling. When validate_only is true, Google validates the request and returns no operation.
Tool to search for developer metadata in a spreadsheet. Use when you need to find specific metadata entries based on filters.
Search for Google Documents using various filters including name, content, date ranges, and more.
Run one page of a GAQL search and return its continuation token.
Search the Google Ads v26 field metadata catalog with GAQL.
Searches for app-created media items in a user's Google Photos library.
Searches saved contacts and optionally Other Contacts by query, returning matching person records. When both sources are requested, results may be partial if one search fails.
Search for Google spreadsheets accessible in Drive by name, content, dates, and other filters, including starred and shared-with-me status. Results are paginated, with up to 1,000 items per page; shared drives are included by default and searches across them may be incomplete.
Execute a Google Ads Query Language (GAQL) query and aggregate every streamed response batch in order. For very large reports, select only needed fields and use WHERE and LIMIT because action responses are returned inline and are not automatically offloaded.
Sends an existing Gmail draft immediately to the recipients already in its To, Cc, and Bcc headers. The draft's recipients and content cannot be changed by this action; confirm them before sending.
Sends an email immediately through Gmail to specified To, Cc, or Bcc recipients, with a subject or body and optional attachments. Supports plain text or HTML and may append the configured Gmail signature; attachments are limited to 20 MiB in total before encoding.
Send GA4 web-stream events using the Measurement Protocol and an API secret. A successful response indicates HTTP receipt, not that Google Analytics processed the events.
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.
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.
Sorts data within a specified range in a Google Sheet based on one or more sort criteria. Use this action when you need to reorder rows in a range by column values, with support for multi-level (cascading) sorts.
Tool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription.
Tool to stop watching resources through a specified channel. Use this when you want to stop receiving notifications for a previously established watch. Both `id` and `resourceId` must be saved from the original watch response β they cannot be retrieved after the fact.
Tool to stop receiving push notifications for a Gmail mailbox. Use when you need to disable watch notifications previously set up via the watch endpoint.
Searches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower"). Results may include CLOSED_PERMANENTLY or TEMPORARILY_CLOSED places β filter by businessStatus=OPERATIONAL. Include city/region and business type in textQuery to avoid empty or irrelevant results. Deduplicate using id or formattedAddress, not name alone. Throttle to ~1 req/s; OVER_QUERY_LIMIT (HTTP 429) requires exponential backoff.
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.
Moves the specified thread to the trash. Any messages that belong to the thread are also moved to the trash.
Tool to unhide a shared drive. Use when you need to restore a shared drive to the default view.
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.
Restore a file from Google Drive trash. The file must still be in the trash; this does not recover permanently deleted files.
Tool to remove a message from trash in Gmail. Use when you need to restore a previously trashed email message.
Tool to remove a thread from trash in Gmail. Use when you need to restore a deleted thread and its messages.
Updates an access control rule for the specified calendar.
Updates the title or cover photo of a Google Photos album created by this app.
Full PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. Use GOOGLECALENDAR_PATCH_CALENDAR to update only a subset of fields. Mutates the underlying calendar resource (title, description, timeZone, etc.); use GOOGLECALENDAR_CALENDAR_LIST_UPDATE to change per-user display properties like color.
Updates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user β does not modify the underlying calendar resource (title, timezone, etc.). To modify the calendar itself, use GOOGLECALENDAR_CALENDARS_UPDATE.
Updates an existing chart in a Google Sheets spreadsheet by replacing its chart specification. The specification can change its title, chart type, data ranges, colors, axes, and other visual settings without moving or resizing the chart.
Tool to update an existing comment on a Google Drive file. Use when you need to change the content of a comment. NOTE: The 'resolved' field is read-only in the Google Drive API. To resolve or reopen a comment, use CREATE_REPLY with action='resolve' or action='reopen'.
Update mutable Data Manager user-list metadata, optionally validating only.
Update selected data retention settings for a Google Analytics property. Requires the connection to grant the https://www.googleapis.com/auth/analytics.edit scope, which is not requested by default.
Update a stream's display name, web default URI, or both. Requires the connection to grant the https://www.googleapis.com/auth/analytics.edit scope, which is not requested by default.
Tool to hide/unhide rows or columns and set row heights or column widths. Use when you need to change visibility or pixel sizing of dimensions in a Google Sheet.
Replaces the body content of a Google Docs tab with rendered Markdown; requires edit permissions. If no tab is specified, the first tab is updated.
Insert or replace a section of a Google Docs document with rendered Markdown, using start and optional end indices, or append when no start index is provided. A replacement may leave the original content in place while inserting the new content.
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.
Updates a Gmail draft by ID by replacing its message. The tool reads the existing draft to preserve omitted recipients, subject, body, sender, and attachments. Supplying `attachment` replaces the existing attachments.
Applies a batch of edits to a specified Google Doc, such as inserting, deleting, or formatting text.
Update mutable fields on one Google Ads experiment.
Update one or more Google Ads experiment arms.
Updates file metadata. Uses PATCH semantics (partial update) as per Google Drive API v3 β only explicitly provided fields are updated, so omit fields you do not intend to overwrite. Use this tool to modify attributes of an existing file like its name, description, or parent folders. To move a file, supply add_parents and remove_parents together; omitting remove_parents creates multiple parents, omitting add_parents can orphan the file. Bulk updates may trigger 429 Too Many Requests; apply exponential backoff. Note: supports metadata updates only; file content updates are not yet implemented.
Tool to update file metadata using the Drive API v2 PATCH method. Use when you need to modify file properties like title, description, or labels using patch semantics.
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.
Replace selected fields on an existing saved Google contact.
Replaces an existing Google Calendar event using its event ID and required start time. Omitted fields can be cleared, but existing conference data is preserved by default when available; supply the desired event details for the replacement.
Update an existing Google Meet space member's email or meeting role. Requires meetings.space.created. Use update_mask to select fields; omitted or empty updates provided values, while '*' also clears fields not provided.
Updates the configuration of an existing Google Meet space, including access, moderation and artifact settings, using a supplied or automatically derived update mask. Requires an applicable meetings.space.created or meetings.space.settings OAuth scope.
Tool to update IMAP settings for a Gmail account. Use when you need to modify IMAP configuration such as enabling/disabling IMAP, setting auto-expunge behavior, or configuring folder size limits.
Updates an existing Gmail label's name, visibility settings, or color to help organize the mailbox. Color is available for user labels and requires both a background and text color from Gmail's supported palette.
Tool to update the language settings for a Gmail user. Use when you need to change the display language preference for the authenticated user or a specific Gmail account. The returned displayLanguage may differ from the requested value if Gmail selects a close variant.
Updates the description of an app-created media item in Google Photos.
Tool to update a permission with patch semantics. Use when you need to modify an existing permission for a file or shared drive. Inherited or domain-managed permissions may not be editable; verify editability with GOOGLEDRIVE_LIST_PERMISSIONS before updating.
Tool to update POP settings for a Gmail account. Use when you need to configure POP access window or message disposition behavior.
Update a Google Slides presentation using markdown or raw API requests. Markdown supports themes and multiple slide types; images may be skipped when their URLs fail validation or Google cannot retrieve them.
Tool to update an existing GA4 Property. Use when you need to modify property settings such as display name, time zone, currency code, or industry category.
Tool to update a property on a file using Google Drive API v2. Use when you need to modify an existing custom property attached to a file.
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.
Updates a Gmail send-as alias, including its display name, signature, reply-to address, or SMTP settings; Gmail sanitizes HTML signatures before saving. The tool declares support for service-account OAuth, not standard OAuth; non-primary addresses require domain-wide delegation.
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.
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.
Tool to update SPREADSHEET-LEVEL properties such as the spreadsheet's title, locale, time zone, or auto-recalculation settings. Use when you need to modify the overall configuration of a Google Spreadsheet. NOTE: To update individual SHEET properties (like renaming a specific sheet/tab), use GOOGLESHEETS_UPDATE_SHEET_PROPERTIES instead.
Sets or overwrites values in a Google Spreadsheet range, adjusting the range to fit the supplied values and potentially expanding the sheet by default. Unmatched common default sheet names may resolve to the first sheet.
Write values to one exact Google Sheets range.
Updates properties of a document tab such as title, parent tab, index, and icon emoji. Use this action when you need to rename a tab, change its emoji icon, move it within the tab hierarchy, or reorganize tab structure.
Updates the style of selected rows in a Google Document table, including minimum row height and overflow prevention.
Tool to fully replace an existing Google Task using PUT method. Use when you need to update the entire task resource, not just specific fields. This method requires all required fields (id, title) and replaces the complete task, unlike PATCH which supports partial updates.
Updates the authenticated user's specified task list.
Tool to update vacation responder settings for a Gmail user. Use when you need to configure out-of-office auto-replies.
Upload offline call conversions to Google Ads, or validate them without uploading using validate_only. Inspect partial_failure_error for row failures even when the request succeeds.
Upload offline click conversions with optional enhanced-conversion identifiers, consent, and cart data. Restricted to existing allowlisted upload integrations; new integrations should use the Data Manager API. This records conversions unless validate_only is true. Inspect partial_failure_error for row failures even on HTTP 200; validate-only does not return conversion results.
Upload retractions, restatements, or enhancements of existing conversions. Set validate_only=true to check without changing conversions. Inspect partial_failure_error even when HTTP succeeds.
Upload a file of 5 MiB or less to Google Drive using multipart upload.
Upload a new file to Google Drive, optionally placing it in a specified folder. If no folder ID is provided, it is uploaded to the Drive root.
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.
Upload an image or video to Google Photos from a file or public URL and create a media item. Uploading requires the photoslibrary.appendonly authorization scope, which is not included in the default connection scopes.
Append or remove already-hashed user data in a Google Ads Customer Match list. This endpoint performs real uploads: it has no validation-only or partial-failure mode. Supply consent as appropriate; per-user consent overrides list metadata. Uploads through this service are not visible in the UI's Segment members section. Requires an existing Google-approved Customer Match upload integration; new integrations should use Data Manager audience ingestion instead.
Tool to update file content in Google Drive by uploading new binary content. Use when you need to replace the contents of an existing file with new file data.
Upserts rows in a Google Sheet by matching a key column: updates matching rows and appends new ones. It maps columns by header name, adds missing columns, and supports partial updates.
Validate Measurement Protocol events for a web stream before sending them to production, checking event structure and parameters.
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.
Creates a push-notification channel for changes to the user's calendar list. Notifications signal changes rather than providing full change details, and delivery is not completely reliable.
Subscribe to Google Drive changes for a user or shared drive and receive notifications at a webhook URL. Supply a start or continuation page token; notifications may cover multiple changes, so fetch changes since the last known token.
Watch for changes to Events resources. Watch channels expire; persist the channel `id` per `calendarId` to re-establish watches after expiration or restarts.
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.
Watch for changes to Settings resources.
Return the identity (email, name) of the connected Gmail account.
Replace values in one range of a Google spreadsheet.
Nothing matches that.
More in File management & storage
See them all βGoogle Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices, with robust search and offline access
92 toolsβ OOneDrive is Microsoftβs cloud storage solution enabling users to store, sync, and share files across devices, offering offline access, real-timeβ¦
101 toolsβ DDropbox is a cloud storage service offering file syncing, sharing, and collaboration across devices with version control and robust integrations
175 toolsβ BBox is a cloud content management platform for secure file storage, sharing, collaboration, and governance.
284 toolsβ CCloudConvert is a file conversion service supporting over 200 formats, including audio, video, document, ebook, archive, image, spreadsheet, andβ¦
9 toolsβ DUpload files and publish HTML pages to public CDN URLs, then list, inspect, and delete hosted files.
6 toolsβ