
Gws Sheets Read
Read cell ranges from Google Sheets via the gws CLI so your agent can pull live spreadsheet data into scripts, validators, or dashboards without manual export.
Install
npx skills add https://github.com/googleworkspace/cli --skill gws-sheets-readWhat is this skill?
- Read-only `gws sheets +read`—never modifies the spreadsheet.
- Requires spreadsheet ID and A1-style range (e.g. Sheet1!A1:D10).
- Documents flags `--spreadsheet` and `--range` with CLI examples.
- Points to gws-shared for auth, global flags, and security rules.
- Suggests raw values.get API when advanced read options are needed.
Adoption & trust: 26.5k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
Recommended Skills
Journey fit
Canonical shelf is Build → integrations because the skill is a Google Workspace CLI binding agents use while wiring product logic to external data sources. Integrations captures read-only API/CLI access to Sheets as part of app or agent tooling, distinct from growth analytics interpretation.
Common Questions / FAQ
Is Gws Sheets Read safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Gws Sheets Read
# sheets +read > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. Read values from a spreadsheet ## Usage ```bash gws sheets +read --spreadsheet <ID> --range <RANGE> ``` ## Flags | Flag | Required | Default | Description | |------|----------|---------|-------------| | `--spreadsheet` | ✓ | — | Spreadsheet ID | | `--range` | ✓ | — | Range to read (e.g. 'Sheet1!A1:B2') | ## Examples ```bash gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10" gws sheets +read --spreadsheet ID --range Sheet1 ``` ## Tips - Read-only — never modifies the spreadsheet. - For advanced options, use the raw values.get API. ## See Also - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth - [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands