Nodal-Agents
ReferenceConnectors

Google Sheets

Google Sheets connector — OAuth flow — uses your Google credential (create one under Credentials).

Auth: OAuth 2.0 (credential type google-oauth)

Slug: google-sheets

Setup: OAuth flow — uses your Google credential (create one under Credentials).

Access requested

Grants access to ALL your spreadsheets, read and write. A read-only scope exists but would disable every editing tool.

OAuth scopes:

  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/userinfo.email
  • openid

Destructive operations (delete, overwrite) can be disabled per-agent: in the agent's Connectors tab, the "enabled operations" allowlist controls exactly which of the tools below an agent may call. Operations marked Destructive below are the ones to review first.

Tools (20)

Read (5)

ToolOperationDescription
sheets_read_rangeRead rangeRead values from a cell range (e.g. A1:C10).
sheets_read_allRead allRead all values from a sheet.
sheets_batch_read_rangesBatch read rangesRead multiple cell ranges in a single request.
sheets_get_metadataGet metadataRetrieve spreadsheet metadata and sheet list.
sheets_find_rowsFind rowsSearch rows matching a column value.

Write (14)

ToolOperationDescription
sheets_write_rangeWrite rangeWrite values to a cell range.
sheets_append_rowAppend rowAppend a new row at the end of a sheet.
sheets_clear_rangeClear rangeClear values in a cell range.
sheets_batch_update_valuesBatch update valuesWrite values to multiple ranges in one request.
sheets_create_spreadsheetCreate spreadsheetCreate a new Google Sheets spreadsheet.
sheets_add_sheetAdd sheetAdd a new sheet tab to a spreadsheet.
sheets_duplicate_sheetDuplicate sheetDuplicate an existing sheet tab.
sheets_rename_sheetRename sheetRename a sheet tab.
sheets_format_rangeFormat rangeApply formatting (bold, color, number format) to a cell range.
sheets_resize_columnsResize columnsResize column widths in a sheet.
sheets_freeze_panesFreeze panesFreeze rows or columns in a sheet.
sheets_set_basic_filterSet basic filterApply a basic filter to a sheet range.
sheets_clear_basic_filterClear basic filterRemove the basic filter from a sheet.
sheets_sort_rangeSort rangeSort a range by one or more columns.

Destructive (1)

ToolOperationDescription
sheets_delete_sheetDelete sheetPermanently delete a sheet tab from a spreadsheet.

On this page