Google Sheets: Read values from a spreadsheet.
Install with the open skills CLI (global, non-interactive — available in every Claude Code session):
npx skills add googleworkspace/cli --skill "gws-sheets-read" -g -a claude-code -yOr manually — copy the SKILL.md below into:
~/.claude/skills/gws-sheets-read-googleworkspace/SKILL.md---
name: gws-sheets-read
description: "Google Sheets: Read values from a spreadsheet."
metadata:
version: 0.22.5
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
```bash
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
```bash
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](../gws-shared/SKILL.md) — Global flags and auth
- [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Use when you have a written implementation plan to execute in a separate session with review checkpoints
Use when executing implementation plans with independent tasks in the current session