sheets +read
SkillFiles & storagegws-sheets-read is a skill that lets an AI agent read values from a Google Sheets spreadsheet. It gives the agent a way to pull cell contents from a sheet so it can use that data in a task. The skill is for reading only and does not write or change the spreadsheet.
Use sheets +read in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add sheets +read and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the sheets +read skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Have a Google Sheets spreadsheet with the values you want the agent to read.
What your AI can do with it
- Read values from a Google Sheets spreadsheet
- Fetch cell contents from a specified range
- Return sheet data to the agent for use in a task
Getting started
- Have a Google Sheets spreadsheet with the values you want the agent to read.
- Add the gws-sheets-read skill to your agent's available skills.
- Configure the skill with the spreadsheet identifier and the range to read.
- Run the agent and ask it to read values from that spreadsheet.
What this skill tells your AI
The instructions your AI receives, as published by googleworkspace/cli in skills/gws-sheets-read/SKILL.md and read by Ahel’s review.
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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.
See Also
- gws-shared — Global flags and auth
- gws-sheets — All read and write spreadsheets commands
Signals
- GitHub stars
- 31k
- Forks
- 2k
- Last commit
- Sep 2026
Questions
- Can it write to a spreadsheet?
- No. This skill only reads values from a Google Sheets spreadsheet. It does not write, edit, or change any cell contents.
- What does it need to read a sheet?
- It needs the spreadsheet identifier and the range of cells to read. The agent must have the skill added and configured with those details.
- Does it work with any spreadsheet?
- It works with Google Sheets spreadsheets. The skill reads values from a specified range in a spreadsheet.
Advanced
- Item type
- skill
- Key
gws-sheets-read- Source
- github.com/googleworkspace/cli
github.com/googleworkspace/cli