Skip to content

Release history

freema/mcp-gsheets releases

MCP server for Google Sheets API integration with comprehensive reading, writing, formatting, and sheet management capabilities.

All releases

19 shown

v1.8.1 New feature
Notable features
  • Publishes the tool to MCP Registry on each release
Full changelog

What's Changed

  • feat: publish to MCP Registry on release (v1.8.1) by @freema in https://github.com/freema/mcp-gsheets/pull/127

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.8.0...v1.8.1

1.8.0 Breaking risk
⚠ Upgrade required
  • Removed the unused `mode` parameter from the `sheets_compare_ranges` schema.
  • Simplified axis title assignment in `create-chart` (no operational impact).
Notable features
  • Added `sheets_get_border_map` to produce a compact 2D border line map.
  • Added `sheets_compare_ranges` for position‑by‑position formatting diff between equal‑sized ranges.
  • Added `sheets_delete_columns` and `sheets_delete_rows` for deleting full columns or rows via A1 range syntax.
Full changelog

Highlights

Two major community contributions plus a locale fix.

✨ New tools

Formatting analysis (by @marcin-uliasz in #125)

  • sheets_get_border_map — compact 2D map of horizontal/vertical border lines. Resolves the "right border of N vs left border of N+1" ambiguity that makes per-cell border JSON hard to reason about.
  • sheets_compare_ranges — position-by-position formatting diff between two equally-sized ranges. Great for verifying repeated patterns ("do rows 6–85 all match the template?").

Structural editing (by @master-nevi in #126)

  • sheets_delete_columns — delete columns via full-column A1 range (e.g. Sheet1!B:D).
  • sheets_delete_rows — delete rows via full-row A1 range (e.g. Sheet1!2:4).

🌍 Locale fix

Conditional formatting formulas are now normalized to English locale by default (semicolons → commas), which fixes a real pain point for non-English Sheets users (notably Polish). Original formulas are preserved under _formulaLocaleRaw and normalization can be disabled with normalizeFormulas: false.

New options:

  • normalizeFormulas on sheets_get_conditional_formatting and sheets_get_full_sheet_snapshot (default: true)
  • includeConditionalFormatting on sheets_get_full_sheet_snapshot (default: true)

🧪 Test coverage

Big coverage bump: google-auth, validation-helpers, response-helpers, formula-locale, json-parser, error-messages, plus edge cases across existing tools. 485/485 passing.

🧹 Cleanup

  • Removed unused mode parameter from sheets_compare_ranges schema (was documented but never read).
  • Simplified axis title assignment in create-chart.

🙏 Thanks

  • @marcin-uliasz — border-map + compare-ranges + locale fix + massive test coverage
  • @master-nevi — delete-columns + delete-rows

Full changelog: https://github.com/freema/mcp-gsheets/blob/main/CHANGELOG.md

1.7.1 Maintenance

Routine maintenance release for freema/mcp-gsheets.

Changelog

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.7.0...1.7.1

1.7.0 Bug fix
Notable features
  • New sheet read tools added
  • ESLint refactor applied
  • Schema fixes implemented
Full changelog

What's Changed

  • fix: only load dotenv in explicit development mode by @translunar in https://github.com/freema/mcp-gsheets/pull/121
  • change: new sheet read tools, ESLint refactor, and schema fixes by @marcin-uliasz in https://github.com/freema/mcp-gsheets/pull/124

New Contributors

  • @translunar made their first contribution in https://github.com/freema/mcp-gsheets/pull/121
  • @marcin-uliasz made their first contribution in https://github.com/freema/mcp-gsheets/pull/124

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.6.0...1.7.0

1.6.0 New feature
Notable features
  • Added Claude Code plugin
  • Improved Google Sheets API resource handling
Full changelog

What's Changed

  • feat: Add Claude Code plugin by @freema in https://github.com/freema/mcp-gsheets/pull/114
  • Bump version to 1.6.0 and add resource handling for Google Sheets API by @freema in https://github.com/freema/mcp-gsheets/pull/108

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.5.4...1.6.0

1.5.4 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • Update README with personal website link by @freema in https://github.com/freema/mcp-gsheets/pull/106
  • Minor update readme on How to Get GCP service account JSON Credentials by @rifqimfahmi in https://github.com/freema/mcp-gsheets/pull/105
  • deps: bump @types/node from 24.2.1 to 24.9.1 by @dependabot[bot] in https://github.com/freema/mcp-gsheets/pull/102
  • deps: bump googleapis from 140.0.1 to 164.1.0 by @dependabot[bot] in https://github.com/freema/mcp-gsheets/pull/101
  • deps: bump typescript from 5.9.2 to 5.9.3 by @dependabot[bot] in https://github.com/freema/mcp-gsheets/pull/97
  • Update library version by @freema in https://github.com/freema/mcp-gsheets/pull/107

New Contributors

  • @rifqimfahmi made their first contribution in https://github.com/freema/mcp-gsheets/pull/105

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.5.3...1.5.4

1.5.3 New feature
Notable features
  • Private key authentication method added
Full changelog

What's Changed

  • Add private key authentication method by @freema in https://github.com/freema/mcp-gsheets/pull/103
  • chore: bump version to 1.5.3 by @freema in https://github.com/freema/mcp-gsheets/pull/104

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.5.2...1.5.3

1.5.2 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • feat: bump version to 1.5.2 by @freema in https://github.com/freema/mcp-gsheets/pull/92

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.5.1...1.5.2

1.5.1 New feature
Notable features
  • Updated README with clearer instructions for MCP client configuration
Full changelog

What's Changed

  • feat: update README for improved clarity on MCP client configuration … by @freema in https://github.com/freema/mcp-gsheets/pull/91

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.5.0...1.5.1

1.5.0 New feature
Notable features
  • Added sheets_insert_rows tool allowing row insertion with optional data
Full changelog

What's Changed

  • feat: add sheets_insert_rows tool for inserting rows with optional da… by @freema in https://github.com/freema/mcp-gsheets/pull/80

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.4.3...1.5.0

1.4.3 Maintenance

Routine maintenance release for freema/mcp-gsheets.

Changelog

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.4.2...1.4.3

1.4.2 Maintenance

Routine maintenance release for freema/mcp-gsheets.

Changelog

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.4.1...1.4.2

1.4.1 Maintenance

Routine maintenance release for freema/mcp-gsheets.

Changelog

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.4...1.4.1

1.4 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • deps: bump @modelcontextprotocol/sdk from 0.5.0 to 1.17.1 by @dependabot[bot] in https://github.com/freema/mcp-gsheets/pull/54
  • deps: bump @types/node from 20.17.57 to 24.1.0 by @dependabot[bot] in https://github.com/freema/mcp-gsheets/pull/53
  • deps: bump dotenv from 16.5.0 to 17.2.1 by @dependabot[bot] in https://github.com/freema/mcp-gsheets/pull/52

New Contributors

  • @dependabot[bot] made their first contribution in https://github.com/freema/mcp-gsheets/pull/54

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.3.1...1.4

1.3.1 New feature
Notable features
  • Support JSON string format for service account credentials
Full changelog

What's Changed

  • feat: enhance authentication options by adding JSON string support an… by @freema in https://github.com/freema/mcp-gsheets/pull/39
  • feat: add support for service account credentials as JSON string and … by @freema in https://github.com/freema/mcp-gsheets/pull/40

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.3...1.3.1

1.3 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • chore: Remove test-serialization.js file and its associated error han… by @freema in https://github.com/freema/mcp-gsheets/pull/10
  • Refactoring add new by @freema in https://github.com/freema/mcp-gsheets/pull/26

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.2...1.3

1.2 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • docs: Update cloning instructions in README to include HTTPS and SSH … by @freema in https://github.com/freema/mcp-gsheets/pull/2
  • Ref imports by @freema in https://github.com/freema/mcp-gsheets/pull/8
  • feat: Update README and package.json with author and repository details by @freema in https://github.com/freema/mcp-gsheets/pull/9

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.1...1.2

1.1 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • refactor: Consolidate tool imports and enhance input validation with … by @freema in https://github.com/freema/mcp-gsheets/pull/1

New Contributors

  • @freema made their first contribution in https://github.com/freema/mcp-gsheets/pull/1

Full Changelog: https://github.com/freema/mcp-gsheets/compare/1.0...1.1

1.0 Maintenance

Routine maintenance release for freema/mcp-gsheets.

Changelog

Full Changelog: https://github.com/freema/mcp-gsheets/commits/1.0

Beta — feedback welcome: [email protected]