AutoGineer
Generated banner for Gws Sheets Read
Generated logo for Gws Sheets Read

Gws Sheets Read

Google WorkspaceOfficialPublished by Google Workspace

  • Skill
  • Tool integration
  • Automation and integrations
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Google Sheets: Read values from a spreadsheet.
— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The gws-sheets-read skill provides a command-line interface to extract data from Google Sheets. It is designed as a read-only utility, ensuring that no modifications are made to the target spreadsheet during the retrieval process. Users can specify a spreadsheet ID and a target range to pull specific data points or entire sheets into their workflow.

What it does

  • Retrieves cell values from a specified Google Sheets spreadsheet.
  • Supports targeted data extraction using range notation.
  • Operates in a strictly read-only mode to prevent accidental data changes.
  • Integrates with the broader gws command suite for authentication and global configuration.

When to use it

  • When you need to pull data from a Google Sheet into a local script or automated pipeline.
  • When you want to perform data analysis or reporting based on spreadsheet content.
  • When you require a secure, read-only method to access shared spreadsheet data.

Advantages

  • Ensures data integrity by preventing write operations.
  • Simplifies data retrieval from Google Sheets via CLI.
  • Flexible range selection allows for precise data extraction.

Usage examples

“Read the data from Sheet1 cells A1 to D10 in my spreadsheet.”
The agent executes the command to fetch and display the values contained within the specified range of the Google Sheet.
“Get all data from the sheet named Sheet1.”
The agent retrieves the contents of the entire specified sheet and presents the data for further use.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/googleworkspace/gws-sheets-read/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip gws-sheets-read.zip -d .agents/skills

Documentation by Google Workspace

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

FlagRequiredDefaultDescription
--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

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Google Workspace
Publisher
Google Workspace (Official)
Source
googleworkspace/cli · skills/gws-sheets-read · commit cd3697e
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google Workspace or Google Workspace.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download gws-sheets-read.zip