gws-sheets-read

Read cell values from Google Sheets via the gws CLI.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/cellarwood/figurio --skill gws-sheets-read-cellarwood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-sheets-read
Source: https://github.com/cellarwood/figurio/tree/main/skills/gws-sheets-read
Command: npx skills add https://github.com/cellarwood/figurio --skill gws-sheets-read-cellarwood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read cell values from Google Sheets without manual copying or browser navigation, making it easy to pull structured data into scripts and workflows.

Core Features & Use Cases

  • Read specific ranges: Retrieve values from an A1 range or entire sheet by providing a spreadsheet ID and range.
  • Read-only and safe: Designed to never modify sheet data and to rely on existing Google Workspace authentication.
  • Use Case: Extract a table of user data or metrics from a shared spreadsheet to feed into a reporting pipeline or automation.

Quick Start

Run gws sheets +read with the spreadsheet ID and the desired A1 range to fetch the values from the sheet.

Frequently Asked Questions about gws-sheets-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read values from a specific A1 range in Google Sheets?

To read values from a Google Sheets spreadsheet, provide the spreadsheet ID and the desired A1 range to retrieve specific cell contents for downstream processing without modifying the original data.

Can I pull an entire Google Sheets tab into an automation script?

Yes, you can pull full sheets or tabular data into automation scripts by specifying the sheet name as the range parameter, retrieving all cell values for immediate integration and reporting pipelines.

Do I need Google Workspace authentication to retrieve Google Sheets data?

Yes, retrieving Google Sheets data requires existing Google Workspace authentication to securely access and read spreadsheet values via the gws CLI without manual browser navigation or copying.

What is the best way to extract structured data from Google Sheets for reports?

The best way to extract structured data for reports is using a read-only retrieval method that accepts spreadsheet IDs and ranges to safely pull metrics into your reporting pipeline.

Is it safe to use a CLI to read Google Sheets without modifying cell contents?

Yes, reading Google Sheets via this method is safe because it is designed to be strictly read-only, ensuring it will never modify sheet data during the cell content retrieval process.