Gws Sheets Read
googleworkspace/cliOfficial
A straightforward read-only interface to Google Sheets that pulls cell ranges into Claude's context for analysis or processing. You pass it a spreadsheet ID and range like "Sheet1!A1:D10" and it returns the raw values without any formatting or formulas. Handy when you need Claude to analyze data, generate reports from existing sheets, or extract specific information without risking accidental modifications. The simplicity is the point here, it's essentially a direct wrapper around Google's sheets API that handles auth through the gws toolchain. Works well for quick data pulls but you'll need the full API for anything complex.
- installs
- 50.8K
- GitHub stars
- 31.9K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add googleworkspace/cli --skill gws-sheets-read --agent claude-codeInstalls into .claude/skills of the current project.
Files
sheets +read
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
Sponsors
Details
- Repository
- github.com/googleworkspace/cli
- Categories
- CLI & Terminal, Office & Documents
