Gogcli Mcp Sheets

io.github.chrischallPublished by GitHub account chrischallv4.10.0Updated Nov 7, 2026

Extended Google Sheets for Claude via gogcli — auth + full Sheets support

Overview

AI-generated overview

Lets an assistant read, edit, format and manage Google Sheets through the gogcli command-line tool, including tabs, charts, tables and Connected Sheets data…

What you can do
  • Read and write cell values, append, clear, batch-update and find-replace across ranges
  • Manage tabs and structure: add, delete, rename, copy, reorder, freeze, insert or delete rows and columns, merge cells
  • Format sheets: cell and number formats, column and row sizing, banding, conditional formatting, data validation, notes and hyperlinks
  • Work with named ranges, Google Sheets tables, embedded charts and basic filters
  • Inspect and manage Connected Sheets data sources from BigQuery or Looker, including refresh and bounded reads
  • Export spreadsheets as CSV, TSV, XLSX, PDF, ODS or HTML, and snapshot a spreadsheet before risky edits
When to use it
Use it when an assistant needs to work directly in Google Sheets rather than just read values: building or restructuring spreadsheets, applying formatting and validation, managing charts and tables, or refreshing BigQuery-backed Connected Sheets data.
Requirements
Runs locally as an npm package on Node.js 22 or newer, with gogcli installed and authenticated for the target Google account. Set GOG_ACCOUNT to the account email; optionally set GOG_PATH, DISPLAY_TZ and GOG_TIMEZONE. Desktop client only.
Before you install
Many tools write, restructure or delete spreadsheet content, including deleting tabs, data sources, tables and charts; GOG_READONLY blocks mutating requests unless set to 0, false, no or off. The README states the codebase is AI-developed and advises reviewing code and tool permissions before use. It relies on your existing gogcli Google authentication.

Installation

In SourceWeft

  1. Open Gogcli Mcp Sheets in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

gogcli-mcp-sheets

[!WARNING] AI-developed project. This codebase was built and is actively maintained by Claude Code. Review all code and tool permissions before use.

Extended Google Sheets MCP server via gogcli. Includes auth tools plus 55 additional dedicated Sheets tools for tab management, formatting, named ranges, Connected Sheets, and more.

Requirements

  • gogcli installed and authenticated
  • Node.js 22+
bash
brew install gogcligog auth add [email protected] --services sheets

Installation

bash
npm install -g gogcli-mcp-sheets

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "gogcli-sheets": {      "command": "gogcli-mcp-sheets",      "env": {        "GOG_ACCOUNT": "[email protected]"      }    }  }}

Claude Code

bash
claude mcp add gogcli-sheets -- gogcli-mcp-sheets

Extra Sheets Tools (59)

Plus 8 auth tools and 8 base Sheets tools (get, update, append, clear, metadata, create, find-replace, run) — 75 in all.

ToolDescription
gog_sheets_add_tabAdd a new sheet tab
gog_sheets_delete_tabDelete a sheet tab
gog_sheets_rename_tabRename a sheet tab
gog_sheets_copyCopy a sheet to another spreadsheet
gog_sheets_exportExport as CSV, TSV, XLSX, PDF, ODS, or HTML
gog_sheets_freezeFreeze rows and/or columns
gog_sheets_insertInsert rows or columns
gog_sheets_mergeMerge cells
gog_sheets_unmergeUnmerge cells
gog_sheets_formatApply cell formatting (bold, color, etc.)
gog_sheets_number_formatSet number format (currency, percent, date, etc.)
gog_sheets_read_formatRead cell formatting
gog_sheets_resize_columnsResize column widths or auto-fit
gog_sheets_resize_rowsResize row heights or auto-fit
gog_sheets_named_ranges_listList named ranges
gog_sheets_named_ranges_getGet a named range by name or ID
gog_sheets_named_ranges_addCreate a named range
gog_sheets_named_ranges_updateUpdate a named range
gog_sheets_named_ranges_deleteDelete a named range
gog_sheets_notesRead cell notes
gog_sheets_update_noteAdd or update cell notes
gog_sheets_linksList hyperlinks in a range
gog_sheets_links_setSet =HYPERLINK() cells in one call (batch)
gog_sheets_snapshotBack up a whole spreadsheet before a risky edit
gog_sheets_datasource_listList Connected Sheets data sources (BigQuery / Looker) with sheet + execution status
gog_sheets_datasource_describeFull data-source spec, including its query, status and refresh schedules
gog_sheets_datasource_table_listList anchored data-source tables (extracts) and their A1 anchors
gog_sheets_datasource_table_describeDescribe the extract anchored at an A1 cell
gog_sheets_datasource_table_readRead a bounded number of rows out of an extract
gog_sheets_datasource_addAdd a BigQuery Connected Sheets data source (custom SQL or a native table)
gog_sheets_datasource_updateRepoint a data source's SQL, table or billing project
gog_sheets_datasource_refreshRe-run a data source so its sheet and extracts pick up current data
gog_sheets_datasource_deleteDelete a data source, its linked sheet, and unlink dependent objects
gog_sheets_list_tabsList tabs in a spreadsheet (sheetId, title, index, gridProperties)
gog_sheets_copy_pasteCopy a range's values/formulas/format to another range (tiles to fill down/across).
gog_sheets_validation_getRead data-validation rules (dropdowns, checkboxes, conditions) on a range.
gog_sheets_validation_setSet a data-validation rule on a range: dropdowns, checkboxes, number/date conditions, or custom formulas.
gog_sheets_validation_clearRemove all data-validation rules from a range.
gog_sheets_delete_dimensionDelete a row or column span, table-aware: intersecting tables are shrunk and their remaining data preserved.
gog_sheets_batch_updateUpdate values in multiple ranges atomically with one Sheets API request.
gog_sheets_reorder_tabMove a tab to a specific 0-based position.
gog_sheets_chart_listList embedded charts in a spreadsheet.
gog_sheets_chart_getGet a chart's full definition (spec + position) by chart ID.
gog_sheets_chart_createCreate an embedded chart from a JSON ChartSpec.
gog_sheets_chart_updateReplace a chart's spec by chart ID.
gog_sheets_chart_deleteDelete a chart by chart ID.
gog_sheets_table_listList Google Sheets tables in a spreadsheet.
gog_sheets_table_getGet a Google Sheets table by table ID.
gog_sheets_table_createCreate a Google Sheets table over a range with typed columns.
gog_sheets_table_appendAppend data rows to a table.
gog_sheets_table_clearClear all data rows from a table.
gog_sheets_table_deleteDelete a Google Sheets table. By default preserves the table's cell values and formulas (emulates "Convert to range"); set keep_data=false to also wipe the data.
gog_sheets_banding_listList alternating-color banded ranges.
gog_sheets_banding_setApply alternating colors to a range.
gog_sheets_banding_clearRemove alternating-color banding by ID or for a whole sheet.
gog_sheets_filter_setSet a basic filter on a range; replacing an existing filter requires replace=true.
gog_sheets_conditional_format_listList conditional formatting rules.
gog_sheets_conditional_format_addAdd a conditional formatting rule to a range (boolean or gradient).
gog_sheets_conditional_format_clearRemove conditional formatting rules from a sheet.

License

MIT

Source: packages/gogcli-mcp-sheets/README.md at commit 5ce766c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

22
  1. v4.10.0LatestNov 7, 2026
  2. v4.9.1Nov 5, 2026
  3. v4.8.1Oct 16, 2026
  4. v4.8.0Oct 12, 2026
  5. v4.7.1Oct 10, 2026
  6. v4.7.0Oct 7, 2026
  7. v4.6.3Oct 5, 2026
  8. v4.6.2Oct 5, 2026
  9. v4.6.1Oct 3, 2026
  10. v4.6.0Oct 2, 2026
  11. v4.5.2Sep 28, 2026
  12. v4.5.1Sep 25, 2026
  13. v4.5.0Sep 24, 2026
  14. v4.3.0Sep 23, 2026
  15. v4.2.5Sep 22, 2026
  16. v4.2.4Sep 21, 2026
  17. v4.2.3Sep 21, 2026
  18. v4.2.0Sep 20, 2026
  19. v4.1.0Sep 20, 2026
  20. v4.0.1Sep 18, 2026
  21. v3.0.0Sep 17, 2026
  22. v2.30.0Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts