gogcli-mcp-sheets 4.2.3 → 4.2.5

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
-    "version": "4.2.3"
+    "version": "4.2.5"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli (Sheets)",
       "source": "./",
       "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
-      "version": "4.2.3",
+      "version": "4.2.5",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp-sheets",
   "displayName": "gogcli (Sheets)",
-  "version": "4.2.3",
+  "version": "4.2.5",
   "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
   "author": {
     "name": "Chris Hall",

package/dist/index.js

@@ -35608,7 +35608,7 @@ function registerSheetsTools(server) {
 }
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "4.2.3" : "0.0.0";
+var VERSION = true ? "4.2.5" : "0.0.0";
 
 // ../gogcli-mcp/src/bootstrap-auth.ts
 import { join as join2 } from "node:path";
@@ -36352,6 +36352,7 @@ ${resultText2(result) ?? ""}` }] };
   });
   server.registerTool("gog_sheets_table_create", {
     description: "Create a Google Sheets table over a range. columnsJson is a JSON array of column definitions (each {columnName, columnType?}); valid columnType values: TEXT, DOUBLE, BOOLEAN, DATE, DROPDOWN. Inline JSON or @/path/to/file.json.",
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       range: external_exports.string().describe("Range the table covers (e.g. Sheet1!A1:D20)"),
@@ -36367,6 +36368,7 @@ ${resultText2(result) ?? ""}` }] };
   });
   server.registerTool("gog_sheets_table_append", {
     description: "Append data rows to a table. valuesJson is a JSON 2D array of row values.",
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       tableId: external_exports.string().describe("Table ID to append to"),
@@ -36452,6 +36454,7 @@ ${errorText(err)}`
   });
   server.registerTool("gog_sheets_banding_set", {
     description: "Apply alternating colors to a range. Provide rowPropertiesJson and/or columnPropertiesJson \u2014 each a Sheets API BandingProperties JSON object ({headerColor, firstBandColor, secondBandColor, footerColor}). At least one is required.",
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       range: external_exports.string().describe("Range to band (e.g. Sheet1!A1:D20)"),
@@ -36485,6 +36488,7 @@ ${errorText(err)}`
   });
   server.registerTool("gog_sheets_filter_set", {
     description: "Set a basic filter on a range (the filter/sort header Sheets shows on a data range). A sheet can hold one basic filter; replacing an existing one requires replace=true \u2014 without it, gog refuses rather than silently overwriting.",
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       range: external_exports.string().describe("Range to filter (A1 notation with sheet name, e.g. Sheet1!A1:C100, or a named range name)"),
@@ -36511,6 +36515,7 @@ ${errorText(err)}`
   });
   server.registerTool("gog_sheets_conditional_format_add", {
     description: 'Add a conditional formatting rule to a range. Boolean rules: type picks the condition, expr is its value/formula (omit for blank/not-blank), formatJson is the CellFormat to apply when the condition matches (inline or @file); use formatFields to force-send zero/false fields (e.g. backgroundColor,textFormat.bold). Gradient rules (color scales): pass gradientRuleJson instead \u2014 a GradientRule JSON with minpoint/maxpoint (and optional midpoint), each {"color":{...},"type":"MIN|MAX|NUMBER|PERCENT|PERCENTILE","value":"..."}. The two modes are mutually exclusive.',
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       range: external_exports.string().describe("Range the rule applies to (e.g. Sheet1!A1:A100)"),
@@ -36639,6 +36644,7 @@ ${errorText(err)}`
   const bigQueryChargeNote = " COSTS MONEY AND RUNS ASYNCHRONOUSLY: this starts a BigQuery execution billed to the billing project, and returns once the execution has been REQUESTED \u2014 not once it has finished. Poll gog_sheets_datasource_describe until its dataExecutionStatus state is SUCCEEDED or FAILED before treating the data as current.";
   server.registerTool("gog_sheets_datasource_add", {
     description: "Add a BigQuery Connected Sheets data source to a spreadsheet, creating its linked DATA_SOURCE sheet. Point it at EITHER a custom SQL query (query) OR an existing native table (dataset + table) \u2014 never both. billingProject is the BigQuery project charged for the query; tableProject only names which project OWNS the table, and defaults to the billing project. Returns the new dataSourceId, which every other datasource tool takes." + bigQueryChargeNote + bigQueryScopeNote,
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       billingProject: external_exports.string().describe("Billing-enabled BigQuery project charged for this source's queries"),
@@ -36694,6 +36700,7 @@ ${errorText(err)}`
   });
   server.registerTool("gog_sheets_datasource_refresh", {
     description: "Re-run a Connected Sheets data source so its sheet and extracts pick up current BigQuery data. Google refuses to refresh a source whose previous execution FAILED; forceRefresh overrides that, which is what you want after fixing the underlying query or permissions." + bigQueryChargeNote + bigQueryScopeNote,
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       dataSourceId: external_exports.string().describe("Data source ID, as reported by gog_sheets_datasource_list"),

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-sheets",
   "display_name": "gogcli (Sheets)",
-  "version": "4.2.3",
+  "version": "4.2.5",
   "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
   "author": {
     "name": "Chris Hall",

package/mint.yaml

@@ -92,7 +92,7 @@ dependencies:
   # bumping these nine pins, and the pin stored on each mcp-host registration.
   - kind: github-release
     repo: openclaw/gogcli
-    tag: v0.40.0
+    tag: v0.41.0
     asset: "gogcli_*_linux_amd64.tar.gz"
     bin: [gog]
 state:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-sheets",
-  "version": "4.2.3",
+  "version": "4.2.5",
   "mcpName": "io.github.chrischall/gogcli-mcp-sheets",
   "description": "Extended Google Sheets MCP server via gogcli — all base tools plus full Sheets support",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -7,12 +7,12 @@
     "source": "github",
     "subfolder": "packages/gogcli-mcp-sheets"
   },
-  "version": "4.2.3",
+  "version": "4.2.5",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp-sheets",
-      "version": "4.2.3",
+      "version": "4.2.5",
       "transport": {
         "type": "stdio"
       },

package/src/tools/sheets-extra.ts

@@ -759,6 +759,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_table_create', {
     description: 'Create a Google Sheets table over a range. columnsJson is a JSON array of column definitions (each {columnName, columnType?}); valid columnType values: TEXT, DOUBLE, BOOLEAN, DATE, DROPDOWN. Inline JSON or @/path/to/file.json.',
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       range: z.string().describe('Range the table covers (e.g. Sheet1!A1:D20)'),
@@ -775,6 +776,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_table_append', {
     description: 'Append data rows to a table. valuesJson is a JSON 2D array of row values.',
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       tableId: z.string().describe('Table ID to append to'),
@@ -885,6 +887,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_banding_set', {
     description: 'Apply alternating colors to a range. Provide rowPropertiesJson and/or columnPropertiesJson — each a Sheets API BandingProperties JSON object ({headerColor, firstBandColor, secondBandColor, footerColor}). At least one is required.',
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       range: z.string().describe('Range to band (e.g. Sheet1!A1:D20)'),
@@ -922,6 +925,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_filter_set', {
     description: 'Set a basic filter on a range (the filter/sort header Sheets shows on a data range). A sheet can hold one basic filter; replacing an existing one requires replace=true — without it, gog refuses rather than silently overwriting.',
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       range: z.string().describe('Range to filter (A1 notation with sheet name, e.g. Sheet1!A1:C100, or a named range name)'),
@@ -952,6 +956,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_conditional_format_add', {
     description: 'Add a conditional formatting rule to a range. Boolean rules: type picks the condition, expr is its value/formula (omit for blank/not-blank), formatJson is the CellFormat to apply when the condition matches (inline or @file); use formatFields to force-send zero/false fields (e.g. backgroundColor,textFormat.bold). Gradient rules (color scales): pass gradientRuleJson instead — a GradientRule JSON with minpoint/maxpoint (and optional midpoint), each {"color":{...},"type":"MIN|MAX|NUMBER|PERCENT|PERCENTILE","value":"..."}. The two modes are mutually exclusive.',
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       range: z.string().describe('Range the rule applies to (e.g. Sheet1!A1:A100)'),
@@ -1143,6 +1148,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
       'BigQuery project charged for the query; tableProject only names which project OWNS the table, and defaults to the ' +
       'billing project. Returns the new dataSourceId, which every other datasource tool takes.' +
       bigQueryChargeNote + bigQueryScopeNote,
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       billingProject: z.string().describe('Billing-enabled BigQuery project charged for this source\'s queries'),
@@ -1223,6 +1229,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
       'Re-run a Connected Sheets data source so its sheet and extracts pick up current BigQuery data. Google refuses to ' +
       'refresh a source whose previous execution FAILED; forceRefresh overrides that, which is what you want after fixing ' +
       'the underlying query or permissions.' + bigQueryChargeNote + bigQueryScopeNote,
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       dataSourceId: z.string().describe('Data source ID, as reported by gog_sheets_datasource_list'),