sheets +append

SkillFiles & storage

This skill adds Google Sheets to your AI's abilities through the Google Workspace command-line tool. Once added, your AI can append rows of data to your spreadsheets, so you can log information, build lists, and keep records up to date just by asking. It works with the same Google account you already use for Workspace.

Available today. Use it from your connected AI after setup.

Add the skill, then connect it to your Google Workspace account. After that, tell your AI which spreadsheet to update and what data to add.

Then ask your AI: use the sheets +append skill

What your AI can do with it

  • Append new rows to an existing Google Sheet
  • Log entries or records into a spreadsheet on request
  • Build up lists over time by adding data as you go
  • Keep a running record updated without opening Sheets yourself

What this skill tells your AI

The instructions your AI receives, as published by googleworkspace/cli in skills/gws-sheets-append/SKILL.md and read by ahel’s review.

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Append a row to a spreadsheet

Usage

gws sheets +append --spreadsheet <ID>

Flags

FlagRequiredDefaultDescription
--spreadsheetSpreadsheet ID
--valuesComma-separated values (simple strings)
--json-valuesJSON array of rows, e.g. '[["a","b"],["c","d"]]'
--rangeA1Target range in A1 notation (e.g. 'Sheet2!A1') to select a specific tab

Examples

gws sheets +append --spreadsheet ID --values 'Alice,100,true'
gws sheets +append --spreadsheet ID --json-values '[["a","b"],["c","d"]]'
gws sheets +append --spreadsheet ID --range "Sheet2!A1" --values 'Alice,100'

Tips

  • Use --values for simple single-row appends.
  • Use --json-values for bulk multi-row inserts.
  • Use --range to append to a specific sheet tab (default: A1, i.e. first sheet).

[!CAUTION] This is a write command — confirm with the user before executing.

See Also

Signals

GitHub stars
31k
Forks
2k
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
gws-sheets-append
Source
github.com/googleworkspace/cli