Gws Sheets Read

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.

skills.sh installs: 52K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill gws-sheets-read --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

Details

Repository: github.com/googleworkspace/cli
Categories: CLI & Terminal, Office & Documents