A Google Sheets interface for reading, writing, creating, listing, summarising, and sharing spreadsheets through connected tools.

It is for listing files and folders, reading or updating cell ranges, creating spreadsheets, viewing sheet summaries, and sharing access.

It lets project workflows manage spreadsheet data without manually switching between separate spreadsheet operations.

gsheets — Skill for Claude Code by martineserios

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add martineserios/thebrana --skill gsheets

Clone the repo

git clone --depth 1 https://github.com/martineserios/thebrana

Made for: Claude Code.

Or install brana, the plugin that ships this one along with the rest of its 56 skills, 4 commands, 14 agents, 13 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/martineserios/thebrana/gsheets/github.svg)](https://agentmods.dev/skills/martineserios/thebrana/gsheets)

Your own site

<a href="https://agentmods.dev/skills/martineserios/thebrana/gsheets"><img src="https://agentmods.dev/badge/skills/martineserios/thebrana/gsheets/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/martineserios/thebrana/gsheets"><img src="https://agentmods.dev/badge/skills/martineserios/thebrana/gsheets.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,739 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00031	$0.01739
Opus 5	$0.00015	$0.00870
Sonnet 5	$0.00006	$0.00348
Haiku 4.5	$0.00003	$0.00174

Measured 5d ago against content hash 6b6ac92ea546, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

gsheets scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

system/skills/gsheets/SKILL.md · 171 lines

How it starts

The opening of the file, as written. The whole thing — 171 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Google Sheets — MCP Operations

Direct interface to Google Sheets via MCP. Read, write, create, and manage spreadsheets with performance-optimal tool usage.

When to use

User wants to read, write, or manage Google Sheets
Another skill needs Sheets access (growth-check, pipeline, financial-model, morning, monthly-close)
Discovering what spreadsheets exist
Creating or sharing a new spreadsheet

Usage

/brana:gsheets [action] [args...]

Actions:

/brana:gsheets list — list spreadsheets or folders
/brana:gsheets read <spreadsheet> [sheet] [range] — read data
/brana:gsheets write <spreadsheet> <sheet> <range> — update data
/brana:gsheets create <title> — create new spreadsheet
/brana:gsheets summary <spreadsheet> — quick overview (sheets, headers, row counts)
/brana:gsheets share <spreadsheet> <email> [role] — share access
/brana:gsheets (no args) — ask user what they need

Step 1: Check MCP Availability

Use ToolSearch to probe for mcp__google-sheets__* tools:

ToolSearch query: "+google-sheets list"

If no mcp__google-sheets__* tools are found:

Tell the user: "Google Sheets MCP is not configured."
Point to setup guide: thebrana/docs/google-sheets-mcp-setup.md
Stop here.

If tools are found, load the ones needed for the requested action and proceed.

Step 2: Route Action

Parse $ARGUMENTS to determine the action. If no arguments, ask the user what they need.

`list` — Discover Spreadsheets

ToolSearch query: "+google-sheets list"

Use mcp__google-sheets__list_spreadsheets to show recent spreadsheets
Use mcp__google-sheets__list_folders to browse by folder
Present results as a table: Title | ID | Last Modified

`read <spreadsheet> [sheet] [range]` — Read Data

ToolSearch query: "+google-sheets get_sheet"

If only spreadsheet given: use mcp__google-sheets__list_sheets to show available sheets, then ask which one
If sheet given but no range: use mcp__google-sheets__get_sheet_data with a sensible default range (A1:Z1 for headers, then A1:Z100 for data preview)
If full range given: use mcp__google-sheets__get_sheet_data with the exact range
For cross-sheet reads: use mcp__google-sheets__get_multiple_sheet_data in a single call

Read the full file on GitHub · 171 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

5d ago First seen · 171 lines · 31 tokens per session scan A 6b6ac92ea546

Subscribe to this mod's changes

gsheets is a skill published in the GitHub repository martineserios/thebrana (3 stars, last pushed today), licensed MIT. It adds 31 tokens to every session and 1,739 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Claude Code Documents Spreadsheets ai-agents ai-development claude-code-plugin csv data developer-tools google-sheets mcp read spreadsheet write

CSV / Spreadsheet Operations

List sheets, read rows, read a single line, and write back to spreadsheets. Supports .csv / .tsv / xlsx / Google Sheets. Canonical partner for agentbatch when iterating row-by-row.

winsenlabs/platos · 51 tokens

Workspace Data Analyst

Analyze CSV files in the workspace and summarize insights.

VoltAgent/voltagent · 14 tokens

xlsx

Working with Excel files programmatically.

bobmatnyc/claude-mpm-skills · 9 tokens

strategy-decompose

Decompose a strategy handed down from above into a hierarchy of aspects and states, audit it for necessity, sufficiency and overlap, and output it as an xlsx. Use before writing your own team's or unit's policy from a company/department/team strategy, when the user wants to break a strategy down into "what state we…

atman-33/workhub · 85 tokens

managing-google-sheets

Use when reading, writing, formatting, charting, or organizing data in Google Sheets via the sheets CLI (sheetcraft-mcp package). Triggers — the user mentions Google Sheets, a docs.google.com/spreadsheets URL, spreadsheet, sheet, tab, cells, rows, formulas, charts, formatting a sheet, pivot-style summaries, or asks to…

P4rthPat3l/sheetcraft-mcp · 87 tokens

data-analysis

Analyze spreadsheet data, generate insights, create visualizations, and build reports from Excel/CSV data.

claude-office-skills/skills · 23 tokens