googleworkspace/cli · Official

gws-sheets-read

Google Sheets: Read values from a spreadsheet.

All-time #550 Trending #1061 Hot #5482 First seen Mar 4, 2026
8-week activity · all time api

Installation

$ npx skills add googleworkspace/cli --skill gws-sheets-read

Summary

  • Read cell values from a Google Sheet by spreadsheet ID and range.
  • Requires spreadsheet ID and range specification (e.g., Sheet1!A1:D10 or entire sheet name) Read-only operation; never modifies the spreadsheet Supports both specific ranges and full sheet reads Depends on gws-shared for authentication and global configuration

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Apr 1, 2026

This skill provides instructions for reading spreadsheet data using the 'gws' command-line interface. It is a standard productivity tool provided by Google Workspace and contains no malicious code or suspicious patterns.

snyk LOW

Analyzed Apr 1, 2026

No issues detected.

socket Score 0.9000 · 0 alerts

Analyzed Apr 1, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli

Browse all from googleworkspace/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 30.8K
License LICENSE
Default branch main
Open issues 129
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws sheets +read --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,128 B
  • docs SUMMARY.md 69 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 45,204 installs

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

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](../gws-shared/SKILL.md) — Global flags and auth
  • [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands