1---
2name: gws-sheets-read
3description: "Google Sheets: Read values from a spreadsheet."
4metadata:
5  version: 0.22.5
6  openclaw:
7    category: "productivity"
8    requires:
9      bins:
10        - gws
11    cliHelp: "gws sheets +read --help"
12---
13 
14# sheets +read
15 
16> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
17 
18Read values from a spreadsheet
19 
20## Usage
21 
22```bash
23gws sheets +read --spreadsheet <ID> --range <RANGE>
24```
25 
26## Flags
27 
28| Flag | Required | Default | Description |
29|------|----------|---------|-------------|
30| `--spreadsheet` | ✓ | — | Spreadsheet ID |
31| `--range` | ✓ | — | Range to read (e.g. 'Sheet1!A1:B2') |
32 
33## Examples
34 
35```bash
36gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
37gws sheets +read --spreadsheet ID --range Sheet1
38```
39 
40## Tips
41 
42- Read-only — never modifies the spreadsheet.
43- For advanced options, use the raw values.get API.
44 
45## See Also
46 
47- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
48- [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands
49