Back to Skills

gws-sheets-append

Google Sheets: Append a row to a spreadsheet.

24,602stars1,249forksUpdated 4/14/2026

Security Assessment

Safe(100/100)
Security Score100/100

About gws-sheets-append

The `gws-sheets-append` skill is designed to simplify the process of adding data to Google Sheets by appending rows directly to a spreadsheet. This skill addresses the common challenge of programmatically updating spreadsheets without manually opening Google Sheets or performing repetitive copy-paste operations. By providing a command-line interface, users can efficiently insert new rows into their spreadsheets, streamlining workflows that involve regular data updates or automated reporting.

The skill offers several features to accommodate different data entry needs. Users can append a single row using simple comma-separated values with the `--values` flag or insert multiple rows at once using a JSON array with the `--json-values` flag. It also supports specifying the target range in A1 notation, allowing precise control over which sheet tab and starting cell the data is appended to. This flexibility ensures that both small updates and bulk inserts can be handled seamlessly. Additionally, the skill includes safety guidance, emphasizing user confirmation before executing write operations, which is crucial for preventing accidental data overwrites.

Typical use cases for `gws-sheets-append` include automated reporting, logging events or transactions into a spreadsheet, syncing data from external sources, and batch data entry tasks. It is ideal for productivity-focused users, data analysts, developers, or anyone managing structured data in Google Sheets who wants to reduce manual effort and ensure consistent, error-free updates. Its command-line approach is particularly beneficial for users integrating spreadsheet updates into scripts or automation pipelines.

FAQ

How do I append a single row to a Google Sheet using this skill?

You can append a single row by using the `--values` flag with comma-separated values, for example: `gws sheets +append --spreadsheet <ID> --values 'Alice,100,true'`.

Can I insert multiple rows at once?

Yes, by using the `--json-values` flag, you can provide a JSON array of rows to insert multiple entries in a single command, e.g. `'[['a','b'],['c','d']]'`.

Is it possible to append data to a specific sheet or tab?

Yes, you can specify the target sheet tab and starting cell using the `--range` flag in A1 notation, such as `Sheet2!A1`. By default, it appends to the first sheet starting at A1.

What prerequisites are required before using this skill?

You need to have authentication and global flags configured as described in the `gws-shared` skill. Make sure the required `gws` binaries are installed.

Are there any precautions I should take?

Since this is a write command, it is recommended to confirm the operation with the user before executing to avoid accidental overwrites of spreadsheet data.

Install gws-sheets-append

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill