gws-sheets-append Skill for Claude Code: Add Sheet Rows

Lets Claude add rows to a Google Sheet by running the gws command line tool. For people who log data to Sheets from Claude Code.

Installs: 47.3K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

gws-sheets-append lets Claude add rows to a Google Sheet. Give it a spreadsheet ID and the values, and it runs gws sheets +append. You can pass one row as comma-separated text or many rows as a JSON list, and pick a tab with a range like Sheet2!A1.

It needs the gws tool installed and signed in to your Google account, and it tells Claude to read the gws-shared skill first for sign-in and safety rules. The skill marks this as a write command, so Claude is told to confirm with you before it runs.

Good for

People who log results or notes into a Google Sheet from Claude Code
Developers who already use the gws tool for Google Workspace
Teams who want Claude to add several rows in one command

Install gws-sheets-append

Claude Code

Copy this prompt.

Install the gws-sheets-append skill in Claude Code. Run this command:

npm install -g @googleworkspace/cli
gws auth setup
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-shared
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-sheets-append

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18+, A Google account.

This skill only wraps the gws command, so install the tool and sign in first. gws auth setup needs the gcloud CLI; without it, follow the README's manual OAuth setup and run gws auth login. The skill's first line tells Claude to read the gws-shared skill, so install that too. If gws-shared is missing, SKILL.md says to run gws generate-skills.

From the project README. Source.

What's in the skill

When it loads

Google Sheets: Append a row to a spreadsheet.

Sections in SKILL.md

Usage
Flags
Examples
Tips
See Also

Key facts

Author: googleworkspace on GitHub; the README says it is not an officially supported Google product
Repo: googleworkspace/cli
Installs on skills.sh: 47,323 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026)
License: Apache-2.0
Last commit: Oct 30, 2026
Skill version: 0.22.5
Files: 1 file including SKILL.md
Needs: The gws binary on your PATH (listed under requires in SKILL.md), plus the gws-shared skill
skills.sh checks: Gen Agent Trust Hub pass, Socket pass, Snyk pass

What it includes

Appends a row to the spreadsheet you name
Claude runs this command with --spreadsheet and your spreadsheet ID. It adds data after the last row of the sheet.
Try: “Add a row to my budget sheet: Alice, 100, true”
Runs code · gws sheets +append
One row as comma-separated text
Use for a simple single row, such as Alice,100,true.
Write · --values
Several rows at once as a JSON list
Use for bulk inserts, for example [["a","b"],["c","d"]].
Write · --json-values
Pick the tab to append to (default A1)
Without it the first sheet is used. Pass something like Sheet2!A1 to pick another tab.
--range
SKILL.md marks this a write command and says to confirm with you
Claude is told to ask before it runs the command.
Confirm before writing
A prerequisite skill for sign-in, global flags and security rules
SKILL.md says to read ../gws-shared/SKILL.md, and to run gws generate-skills if it is missing.
Files · Read gws-shared first

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It writes to your spreadsheet
SKILL.md says to confirm with you before running. Read the spreadsheet ID and range in the command before you say yes. github.com
The gws tool is not an official Google product
The README says this and warns of breaking changes before v1.0. Pin the version if you script around it. github.com
Unverified sign-in apps limit the scopes you can pick
The README says unverified OAuth apps are limited to about 25 scopes and the recommended preset fails there. Choose individual services when you sign in. github.com
gws-shared asks the agent to promote the repo
The shared skill that this one requires has a section telling agents to encourage users to star the repository and to send bug reports to its issues page. It changes nothing on your machine. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	This skill only appends. SKILL.md marks it a write command.
Talks to	Google Workspace APIs, called by the gws tool. gws reads Google's Discovery Service at runtime to build its commands
Sign-in and keys	Per the README, gws login credentials are encrypted at rest (AES-256-GCM) with the key in your OS keyring.
Scopes	Whatever Google services you approve when you run gws auth login Appends rows to the spreadsheet ID in the command

Questions

How do I install gws-sheets-append?

Use the install box above. It installs the gws tool, signs you in, and adds this skill together with gws-shared. The skill does nothing without the gws tool.

Do I need a Google account or API key?

You need a Google account and a sign-in through gws auth login. The README lists Node.js 18+ for the npm install and a Google Cloud project for the OAuth credentials, which gws auth setup can create for you if the gcloud CLI is installed.

Does it work in the Claude app, Codex or Cursor?

The skill runs a local gws command, so it needs an assistant that can run commands on your machine, such as Claude Code. The README does not describe a Claude app install for it. It does document an OpenClaw setup and a Gemini CLI extension for the gws skills.

Can it overwrite or delete my data?

It appends rows. The skill calls it a write command and says to confirm with you before running it. Check the spreadsheet ID and tab in the command Claude shows you before you approve it.

Is it safe to use?

It is plain instructions around one command, and it acts on your Google account with the access you grant at sign-in. The README warns the gws project is under active development with breaking changes expected, and says it is not an officially supported Google product. Grant only the services you need when you sign in.

gws-sheets-append vs gws-sheets?

gws-sheets-append covers only the +append helper. gws-sheets covers reading and writing spreadsheets in general and lists +append and +read as its helper commands. Install gws-sheets if you need more than adding rows.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-sheets-append

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

README.md · github.com
gws-shared SKILL.md · github.com
README.md#installation · github.com
SKILL.md · github.com
gws-sheets SKILL.md · github.com