googleworkspace avatar

Gws Sheets Read

googleworkspace/cli
20.2k

This skill enables reading data from Google Sheets by specifying a spreadsheet ID and range, supporting read-only operations to prevent modifications. It is ideal for users who need to fetch spreadsheet values efficiently, with advanced options accessible via the raw API. Suitable for both human users and AI agents, it streamlines data extraction from Google Sheets within a comprehensive Google Workspace CLI tool.

npx skills add https://github.com/googleworkspace/cli --skill 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

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

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

GitHub Owner

Owner: googleworkspace

Files

gws-shared

gws-sheets

SKILL.md


name: gws-sheets-read version: 1.0.0 description: "Google Sheets: Read values from a spreadsheet." metadata: openclaw: category: "productivity" requires: bins: ["gws"] cliHelp: "gws sheets +read --help"

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

gws sheets +read --spreadsheet <ID> --range <RANGE>

Flags

FlagRequiredDefaultDescription
--spreadsheetSpreadsheet ID
--rangeRange to read (e.g. 'Sheet1!A1:B2')

Examples

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

More skills