Agent skill

Spreadsheet Management

by freema in freema/mcp-gsheets

This skill should be used when the user asks about Google Sheets, spreadsheets, cells, rows, columns, charts, or data tables.

MITAuto-check passedDocuments & Office

Install Spreadsheet Management

skills CLI
$ npx skills add freema/mcp-gsheets --skill spreadsheet-management -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install freema/mcp-gsheets spreadsheet-management --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/freema/mcp-gsheets.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/claude/gsheets/skills/spreadsheet-management .claude/skills/spreadsheet-management && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spreadsheet-management
GitHub stars
100
Token cost
~486 tokens
SKILL.md length
131 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when the user asks about Google Sheets, spreadsheets, cells, rows, columns, charts, or data tables.

  • Asks about Google Sheets
  • SKILL.md covers When to Use This Skill, Tools Reference, Spreadsheet ID and Range Notation, plus 1 more section
  • Reaches docs.google.com
  • Tasks that involve Excel spreadsheets

What it does

Spreadsheet Management is an agent skill from freema/mcp-gsheets. This skill should be used when the user asks about Google Sheets, spreadsheets, cells, rows, columns, charts, or data tables. Activates for reading, writing, formatting, or analyzing spreadsheet data.

Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Excel spreadsheets. It works with Google Sheets, Model Context Protocol, TypeScript and Node.js. The repository describes itself as: MCP server for Google Sheets - Read, write and manipulate spreadsheets through Claude Desktop. The licence is MIT.

When your agent uses it

  • Asks about Google Sheets
  • Tasks that involve Excel spreadsheets

Example prompts

  • “/spreadsheet-management”

What it can do on your machine

Read from SKILL.md and the folder at commit 632b685. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • docs.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spreadsheet Management loads about 486 tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 131 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~486

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from freema/mcp-gsheets at commit 632b685, republished under its MIT licence (© freema). 131 words, ~486 tokens.

Download SKILL.mdSave it as .claude/skills/spreadsheet-management/SKILL.md (or your agent's skills folder).
name
spreadsheet-management
description
This skill should be used when the user asks about Google Sheets, spreadsheets, cells, rows, columns, charts, or data tables. Activates for reading, writing, formatting, or analyzing spreadsheet data.

When the user asks about spreadsheets or data in Google Sheets, use the gsheets MCP tools.

When to Use This Skill

Activate when the user:

  • Wants to read spreadsheet data ("Get data from sheet", "Read column A")
  • Needs to write data ("Update cell A1", "Add a row", "Append data")
  • Formats cells ("Make header bold", "Add borders", "Change colors")
  • Creates charts ("Create a bar chart", "Add a pie chart")
  • Manages sheets ("Create new sheet", "Delete sheet", "Copy sheet")

Tools Reference

TaskTool
Read rangesheets_get_values
Read multiplesheets_batch_get_values
Get infosheets_get_metadata
Write rangesheets_update_values
Append rowssheets_append_values
Insert rowssheets_insert_rows
Format cellssheets_format_cells
Borderssheets_update_borders
Mergesheets_merge_cells
Create chartsheets_create_chart
New sheetsheets_insert_sheet

Spreadsheet ID

Found in the URL: https://docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/edit

Range Notation

Sheet1!A1:D10     # Specific range
Sheet1!A:A        # Entire column
Sheet1!1:1        # Entire row
A1:D10            # First sheet, specific range
'Sheet Name'!A1   # Sheet name with spaces

Example Workflows

Read and summarize:

sheets_get_metadata spreadsheetId="1Bxi..."
sheets_get_values spreadsheetId="1Bxi..." range="Data!A1:F100"

Format header row:

sheets_format_cells spreadsheetId="1Bxi..." range="A1:Z1" bold=true backgroundColor="#4285f4"

Create chart:

sheets_create_chart spreadsheetId="1Bxi..." sheetId=0 chartType="BAR" dataRange="A1:B10"

© freema, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/claude/gsheets/skills/spreadsheet-management of freema/mcp-gsheets.

Open the folder on GitHubat commit 632b685

Compare with similar skills

Spreadsheet Management next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spreadsheet Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spreadsheet Management this skillfreema/mcp-gsheets100—~486Automated safety check: PassMIT
Bilig Workpaperagent-skills-hub/agent-skills-hub111—~931Automated safety check: PassMIT
Google SheetCraftOS-dev/CraftBot392—~1kAutomated safety check: PassMIT
Managing Google Workspacetaylorwilsdon/google_workspace_mcp3.3k—~2.9kAutomated safety check: PassMIT
Gdoc To Markdowniurykrieger/claude-bedrock1051 repos~3.8kAutomated safety check: NotesMIT
Agent Squad for TypeScript2FastLabs/agent-squad7.8k—~4.3kAutomated safety check: PassApache-2.0

Similar skills

  • Bilig Workpaper

    agent-skills-hub/agent-skills-hub

    Formula WorkPaper runtime and MCP server for AI agents and Node.js services.

    111 GitHub stars~931 tokensUpdated 6 days ago
    Documents & OfficeAuto-check passed
  • Google Sheet

    CraftOS-dev/CraftBot

    Read, write, append, and manage Google Sheets via the Google Sheets API (Node.js SDK).

    392 GitHub stars~1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Managing Google Workspace

    taylorwilsdon/google_workspace_mcp

    Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search).

    3.3k GitHub stars~2.9k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Gdoc To Markdown

    iurykrieger/claude-bedrock

    Internal fetcher module for Google Docs and Sheets. An agent skill from iurykrieger/claude-bedrock.

    105 GitHub starsUsed in 1 repo~3.8k tokens
    Documents & OfficeAuto-check: notes
  • Agent Squad for TypeScript

    2FastLabs/agent-squad

    Guide to building Node.js and TypeScript apps on the agent-squad package: orchestrator, agent types, classifier routing, storage, retrievers and MCP tools.

    7.8k GitHub stars~4.3k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Claude Historian

    Vvkmnn/claude-historian-mcp

    Use before WebSearch to check if you already have the answer, when stuck on an error to find past fixes, or when entering a familiar project to recall past sessions and file changes.

    179 GitHub stars~616 tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed

Questions about Spreadsheet Management

What does Spreadsheet Management do?

This skill should be used when the user asks about Google Sheets, spreadsheets, cells, rows, columns, charts, or data tables. Spreadsheet Management is an agent skill from freema/mcp-gsheets. This skill should be used when the user asks about Google Sheets, spreadsheets, cells, rows, columns, charts, or data tables.

When should I use Spreadsheet Management?

Spreadsheet Management fits situations like: asks about Google Sheets; tasks that involve Excel spreadsheets.

How do I install Spreadsheet Management in Claude Code?

Run `npx skills add freema/mcp-gsheets --skill spreadsheet-management -a claude-code`. Or copy the skill folder (plugins/claude/gsheets/skills/spreadsheet-management in freema/mcp-gsheets) into .claude/skills/spreadsheet-management in your project. Claude Code loads it when a task matches its description.

How do I install Spreadsheet Management in Codex?

Run `npx skills add freema/mcp-gsheets --skill spreadsheet-management -a codex`. Or copy the skill folder (plugins/claude/gsheets/skills/spreadsheet-management in freema/mcp-gsheets) into .agents/skills/spreadsheet-management in your project. Codex loads it when a task matches its description.

Can I use Spreadsheet Management in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add freema/mcp-gsheets --skill spreadsheet-management -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spreadsheet-management, .gemini/skills/spreadsheet-management, .github/skills/spreadsheet-management and .opencode/skills/spreadsheet-management in your project.

What does Spreadsheet Management need to run?

SKILL.md names no scripts, command-line tools or credentials: Spreadsheet Management is instructions for the agent only.

Does Spreadsheet Management access the network?

SKILL.md names 1 domain. In commands or code: docs.google.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Spreadsheet Management safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Spreadsheet Management use?

Spreadsheet Management is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spreadsheet Management use?

About 486 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Spreadsheet Management?

Skills that share tags, products or a category with Spreadsheet Management: Bilig Workpaper (agent-skills-hub/agent-skills-hub, 111 stars), Google Sheet (CraftOS-dev/CraftBot, 392 stars), Managing Google Workspace (taylorwilsdon/google_workspace_mcp, 3.3k stars) and Gdoc To Markdown (iurykrieger/claude-bedrock, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spreadsheet Management?

freema (a GitHub user) maintains it in freema/mcp-gsheets, which has 100 GitHub stars. The repository was last updated on October 4, 2026.

Source: freema/mcp-gsheets on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.