sheets +read
SkillFiles & storageThis skill gives your AI the ability to read data from your Google Sheets spreadsheets. Once added, your AI can look up the contents of a sheet and use that information to answer questions or report the numbers you need. It is part of the Google Workspace command-line tool.
Available today. Use it from your connected AI after setup.
No other account needed.
After adding the skill, tell your AI which spreadsheet to read and ask for the data you need. It can then pull that information whenever you ask.
Then ask your AI: use the sheets +read skill
What your AI can do with it
- Read data from your Google Sheets spreadsheets
- Look up specific values or rows in a spreadsheet
- Report the latest figures from a shared sheet
- Answer questions using the contents of a spreadsheet
What this skill tells your AI
The instructions your AI receives, as published by googleworkspace/cli in skills/gws-sheets-read/SKILL.md and read by ahel’s review.
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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
- gws-shared — Global flags and auth
- gws-sheets — All read and write spreadsheets commands
Signals
- GitHub stars
- 31k
- Forks
- 2k
- Last commit
- Sep 2026
- Installs
- 46k installs
Advanced
- Catalog kind
- skill
- Gateway key
gws-sheets-read- Source
- github.com/googleworkspace/cli