# Gws Sheets Read

Google Sheets: Read values from a spreadsheet.

- Repository: https://github.com/googleworkspace/cli (32044 stars)
- Category: Documents
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add googleworkspace/cli --skill gws-sheets-read -g -a claude-code -y`
Codex: `npx skills add googleworkspace/cli --skill gws-sheets-read -g -a codex -y`
Cursor: `npx skills add googleworkspace/cli --skill gws-sheets-read -g -a cursor -y`
Gemini CLI: `npx skills add googleworkspace/cli --skill gws-sheets-read -g -a gemini-cli -y`

## Description

Google Sheets: Read values from a spreadsheet.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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