sheets +append

SkillFiles & storage

gws-sheets-append is a skill that lets an AI agent add a new row to a Google Sheets spreadsheet. It handles the append operation so the agent can record data without manual copying. Use it when a workflow needs to log a result, add a record, or push a value into an existing sheet.

Use sheets +append in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add sheets +append and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the sheets +append skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Have a Google Sheets spreadsheet and the target sheet name ready.

sheets +appendStart free

What your AI can do with it

  • Append a row to a Google Sheets spreadsheet
  • Add new data to an existing sheet
  • Record a result or log entry in a sheet
  • Push a value into a spreadsheet row

Getting started

  1. Have a Google Sheets spreadsheet and the target sheet name ready.
  2. Add the gws-sheets-append skill to your agent's available skills.
  3. Configure the skill with access to the spreadsheet, such as a service account or OAuth credentials.
  4. Ask the agent to append a row with the values you want to add.

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
--spreadsheet✓—Spreadsheet ID
--values——Comma-separated values (simple strings)
--json-values——JSON array of rows, e.g. '[["a","b"],["c","d"]]'
--range—A1Target 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

Questions

What does gws-sheets-append do?
It appends a new row to a Google Sheets spreadsheet. The agent can add data to an existing sheet without manual entry.
Can it update existing rows?
No. It only appends new rows. It does not update or delete existing rows.
Does it work with Excel files?
No. It works with Google Sheets spreadsheets.
What do I need to set up before using it?
You need a Google Sheets spreadsheet and credentials that allow the skill to write to it, such as a service account or OAuth access.
Advanced
Item type
skill
Key
gws-sheets-append
Source
github.com/googleworkspace/cli