
gws-sheets-read
Read cell values from a Google Sheet by spreadsheet ID and range
by googleworkspaceFree
Description
gws-sheets-read is an agent skill from the Google Workspace CLI project, listed on skills.sh. It reads cell values from a Google Sheet, identified by its spreadsheet ID and a range. The range can be a specific block of cells, such as Sheet1!A1:D10, or an entire sheet name to read the whole tab. The listing says it is a read-only operation and never modifies the spreadsheet, which makes it safe to use for looking up figures, checking a list or feeding data into another step. It is run with the --spreadsheet and --range flags, and the range is required. The skill depends on the shared gws authentication and security rules, which the agent reads first, and it can generate them if they are missing. It suits people who want an agent to pull numbers or rows from a sheet for a summary, a report or a check, while the sheet itself stays exactly as it is, under the account the user has authorised.…
Highlights
- Reads a specific range or a whole sheet
- Read-only, never modifies the sheet
- Spreadsheet ID and range flags
- Uses the shared gws authentication
Ratings & Reviews
No ratings yet
Be the first to rate gws-sheets-read.
People also visit

gws-calendar
Google Calendar API access for managing calendars, events, and sharing rules
gws-sheets-read FAQ
What does gws-sheets-read do?
It reads the cell values in a range of a Google Sheet, and never changes the sheet.
How do I install it?
Run: npx skills add https://github.com/googleworkspace/cli --skill gws-sheets-read
What range formats can I use?
A specific range such as Sheet1!A1:B2, or an entire sheet name to read the whole tab.
Does it need setup first?
Yes. It relies on the shared gws authentication and security rules, which it asks the agent to read first.
Has it been checked for security?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Warn. A Warn or Fail is worth reading before you install.
What are the best gws-sheets-read alternatives?
Popular alternatives to gws-sheets-read include gws-sheets-append, google-workspace-ops and gog. See all gws-sheets-read alternatives


