Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
googleworkspace avatar

Gws Sheets Append

  • 36.5k installs
  • 30k repo stars
  • Updated July 22, 2026
  • googleworkspace/cli

gws sheets append is a Google Workspace CLI skill for appending rows to spreadsheets using the --values or --json-values flags.

About

gws sheets append is a Google Workspace CLI skill for programmatically adding rows to spreadsheets. Use it when integrating Google Sheets into workflows, automating data writes, or when developers need to append data to a spreadsheet via command line. It supports single-row and bulk multi-row inserts.

  • Append rows to Google Sheets via CLI with --values or --json-values flags
  • Target specific sheet tabs using A1 notation ranges
  • Support bulk multi-row inserts with JSON array syntax

Gws Sheets Append by the numbers

  • 36,535 all-time installs (skills.sh)
  • +1,205 installs in the week ending Jul 28, 2026 (Skillselion tracking)
  • Ranked #24 of 690 Office & Documents skills by installs in the Skillselion catalog
  • Security screen: LOW risk (skills.sh audit)
  • Data as of Jul 28, 2026 (Skillselion catalog sync)
At a glance

gws-sheets-append capabilities & compatibility

Capabilities
data write · automation · spreadsheet integration
Works with
google drive
From the docs

What gws-sheets-append says it does

Append a row to a spreadsheet
SKILL.md
npx skills add https://github.com/googleworkspace/cli --skill gws-sheets-append

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs36.5k
repo stars30k
Security audit3 / 3 scanners passed
Last updatedJuly 22, 2026
Repositorygoogleworkspace/cli

How do you append rows to Google Sheets from CLI?

Automate spreadsheet data entry and bulk row appends via the gws CLI.

Who is it for?

Developers building workflows that write to Google Sheets, automating data entry, and integrating Sheets with scripts or apps.

Skip if: Bulk sheet imports, complex multi-range updates, or spreadsheet access without the authenticated `gws` CLI.

When should I use this skill?

Adding rows to a spreadsheet, bulk data imports, or automating spreadsheet updates.

What you get

Appended spreadsheet rows, updated sheet ranges, and Sheets API write confirmations in CLI output.

  • appended sheet rows
  • sheets api append responses

By the numbers

  • Skill metadata version 0.22.5
  • Required flag: --spreadsheet

Files

SKILL.mdMarkdownGitHub ↗

sheets +append

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

  • gws-shared — Global flags and auth
  • gws-sheets — All read and write spreadsheets commands

Related skills

How it compares

Choose gws-sheets-append over custom Sheets writers when you already use `gws` and only need a single-row append from shell or agent jobs.

FAQ

How do I append a single row?

Use the --values flag: gws sheets +append --spreadsheet ID --values 'Alice,100,true'

How do I insert multiple rows at once?

Use the --json-values flag with a JSON array: --json-values '["a","b"],["c","d"]'

Is Gws Sheets Append safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.