---
name: gws-sheets-read
description: "Google Sheets: Read values from a spreadsheet."
license: "Apache-2.0"
metadata:
  decimalai-skill-id: "a9286aed-05ed-4f3f-bfeb-8fcc510031c0"
  decimalai-version-id: "630e3f7a-1806-4345-a4dd-f3902cd3cb16"
  decimalai-version: "1"
  decimalai-body-sha256: "25a7739515d7241e23f0f7ab8c38931bf619cc9dae2dc41bbc22fcc5d9665324"
  decimalai-name: "gws-sheets-read"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "data"
  decimalai-source: "https://app.decimal.ai/s/gws-sheets-read@1/SKILL.md"
---
# 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