Google Sheets

Tools

• Add Sheet to Spreadsheet

  Adds a new sheet (worksheet) to a spreadsheet. use this tool to create a new tab within an existing google sheet, optionally specifying its title, index, size, and other properties.

• Aggregate Column Data

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

• Append Dimension

  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.

• Append Values to Spreadsheet

  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.

• Batch Clear Spreadsheet Values

  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.

• Batch Clear Values By Data Filter

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

• Batch get spreadsheet

  Retrieves data from specified cell ranges in a google spreadsheet; ensure the spreadsheet has at least one worksheet and any explicitly referenced sheet names in ranges exist.

• Batch Get Spreadsheet Values by Data Filter

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

• Batch update spreadsheet

  Updates a specified range in a google sheet with given values, or appends them as new rows if `first cell location` is omitted; ensure the target sheet exists and the spreadsheet contains at least one worksheet.

• Batch Update Values by Data Filter

  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.

• Clear Basic Filter

  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.

• Clear spreadsheet values

  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.

• Copy Sheet to Another Spreadsheet

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

• Create a Google Sheet

  Creates a new google spreadsheet in google drive using the provided title.

• Create Chart in Google Sheets

  Create a chart in a google sheets spreadsheet using the specified data range and chart type.

• Create sheet from JSON

  Creates a new google spreadsheet and populates its first worksheet from `sheet json`, which must be non-empty as its first item's keys establish the headers.

• Create spreadsheet column

  Creates a new column in a google spreadsheet, requiring a valid `spreadsheet id` and an existing `sheet id`; an out-of-bounds `insert index` may append/prepend the column.

• Create spreadsheet row

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

• Delete Dimension (Rows/Columns)

  destructive

  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.

• Delete Sheet

  destructive

  Tool to delete a sheet (worksheet) from a spreadsheet. use when you need to remove a specific sheet from a google sheet document.

• Execute SQL on Spreadsheet

  Execute sql queries against google sheets tables. supports select, insert, update, and delete operations with familiar sql syntax. tables are automatically detected and mapped from the spreadsheet structure.

• Find worksheet by title

  Finds a worksheet by its exact, case-sensitive title within a google spreadsheet; returns a boolean indicating if found and the complete metadata of the entire spreadsheet, regardless of whether the target worksheet is found.

• Format cell

  Applies text and background cell formatting to a specified range in a google sheets worksheet.

• Get sheet names

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

• Get Spreadsheet by Data Filter

  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.

• Get spreadsheet info

  Retrieves comprehensive metadata for a google spreadsheet using its id, excluding cell data.

• Get Table Schema

  This action is used to get the schema of a table in a google spreadsheet, call this action to get the schema of a table in a spreadsheet before you query the table. analyze table structure and infer column names, types, and constraints. use

• Insert Dimension in Google Sheet

  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.

• List Tables in Spreadsheet

  This action is used to list all tables in a google spreadsheet, call this action to get the list of tables in a spreadsheet. discover all tables in a google spreadsheet by analyzing sheet structure and detecting data patterns. uses heuristi

• Look up spreadsheet row

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

• Query Spreadsheet Table

  This action is used to query a table in a google spreadsheet, call this action to query a table in a spreadsheet. execute sql-like select queries against spreadsheet tables. supports where conditions, order by, limit clauses. call this acti

• Search Developer Metadata

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

• Search Spreadsheets

  Search for google spreadsheets using various filters including name, content, date ranges, and more.

• Set Basic Filter

  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.

• Update Sheet Properties

  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.

• Update Spreadsheet Properties

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

Works well with

How Switchy teams use it

Starter prompts

@Google Sheets append the following row to spreadsheet ID 1a2b3c4d5e in the 'Tasks' tab: [Today's date, 'Draft Q2 roadmap', 'Alice', 'In Progress'].

@Google Sheets batch get the range 'Revenue!B2:D15' from spreadsheet ID 9x8y7z6w5v and summarize the totals by month.

@Google Sheets batch clear the range 'Archive!A2:Z100' in spreadsheet ID 3f4g5h6j7k to prepare it for new data.

@Google Sheets aggregate column data in spreadsheet ID 2c3d4e5f6g: sum column D where column B equals 'Completed'.

@Google Sheets add a new sheet titled 'Q2 Goals' to spreadsheet ID 7h8j9k0l1m, positioned at index 2.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Use-case deep-dives

Frequently asked