Labsco
googleworkspace logo

gws-sheets-read

โœ“ Officialโ˜… 29,425

by Google ยท part of googleworkspace/cli

Google Sheets: Read values from a spreadsheet.

๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeQuick setup
๐Ÿงฐ Not standalone. This skill ships with googleworkspace/cli and only works together with that tool โ€” install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates โ€” you don't need to read it to use the skill, but it's here to audit before installing.

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

Flags

FlagRequiredDefaultDescription
--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

  • gws-shared โ€” Global flags and auth
  • gws-sheets โ€” All read and write spreadsheets commands