gogcli-mcp-sheets 4.2.2 → 4.2.4

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.2"
+    "version": "4.2.4"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli (Sheets)",
       "source": "./",
       "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
-      "version": "4.2.2",
+      "version": "4.2.4",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

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

package/dist/index.js

@@ -35584,7 +35584,7 @@ function registerSheetsTools(server) {
   });
   server.registerTool("gog_sheets_create", {
     description: "Create a new Google Spreadsheet. Returns JSON with the new spreadsheetId and URL.",
-    annotations: { destructiveHint: false },
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       title: external_exports.string().describe("Title for the new spreadsheet"),
       account: accountParam
@@ -35608,7 +35608,7 @@ function registerSheetsTools(server) {
 }
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "4.2.2" : "0.0.0";
+var VERSION = true ? "4.2.4" : "0.0.0";
 
 // ../gogcli-mcp/src/bootstrap-auth.ts
 import { join as join2 } from "node:path";
@@ -35741,6 +35741,7 @@ function registerExtraSheetsTools(server) {
   });
   server.registerTool("gog_sheets_add_tab", {
     description: "Add a new sheet tab to a spreadsheet.",
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID (from the URL)"),
       tabName: external_exports.string().describe("Name for the new tab"),
@@ -35762,7 +35763,7 @@ function registerExtraSheetsTools(server) {
   });
   server.registerTool("gog_sheets_rename_tab", {
     description: "Rename a sheet tab.",
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       oldName: external_exports.string().describe("Current tab name"),
@@ -35774,6 +35775,7 @@ function registerExtraSheetsTools(server) {
   });
   server.registerTool("gog_sheets_copy", {
     description: "Copy a spreadsheet to a new spreadsheet with the given title.",
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID to copy"),
       title: external_exports.string().describe("Title for the new copy"),
@@ -36188,6 +36190,7 @@ ${resultText2(result) ?? ""}` }] };
   });
   server.registerTool("gog_sheets_named_ranges_add", {
     description: "Create a new named range.",
+    annotations: { destructiveHint: true },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       name: external_exports.string().describe("Name for the range"),
@@ -36282,6 +36285,7 @@ ${resultText2(result) ?? ""}` }] };
   });
   server.registerTool("gog_sheets_chart_create", {
     description: "Create an embedded chart from a JSON spec. specJson is a Sheets API ChartSpec (or full EmbeddedChart) \u2014 inline or @/path/to/file.json. Anchor the chart with sheet + anchor (A1 cell), and optionally size it with width/height pixels.",
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       specJson: external_exports.string().describe("ChartSpec or EmbeddedChart JSON (inline or @file)"),
@@ -36301,7 +36305,7 @@ ${resultText2(result) ?? ""}` }] };
   });
   server.registerTool("gog_sheets_chart_update", {
     description: "Replace a chart spec by chart ID. specJson is a Sheets API ChartSpec (or full EmbeddedChart) \u2014 inline or @/path/to/file.json.",
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       chartId: external_exports.string().describe("Numeric chart ID to update"),
@@ -36348,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)"),
@@ -36363,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"),
@@ -36448,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)"),
@@ -36481,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)"),
@@ -36507,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)"),
@@ -36558,6 +36567,7 @@ ${errorText(err)}`
   });
   server.registerTool("gog_sheets_snapshot", {
     description: "Make a backup copy of an entire spreadsheet \u2014 a one-call safety snapshot to take BEFORE a risky or destructive edit (table delete, bulk clear, large rewrite). Returns the new copy's file ID and URL; if the edit goes wrong, restore by copying the backup back or sharing it. The copy is independent \u2014 later edits to the original do not affect it.",
+    annotations: { destructiveHint: false },
     inputSchema: external_exports.object({
       spreadsheetId: external_exports.string().describe("Spreadsheet ID to back up"),
       name: external_exports.string().describe('Name for the backup copy, e.g. "Budget \u2014 backup before table delete"'),
@@ -36634,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"),
@@ -36689,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.2",
+  "version": "4.2.4",
   "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
   "author": {
     "name": "Chris Hall",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-sheets",
-  "version": "4.2.2",
+  "version": "4.2.4",
   "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.2",
+  "version": "4.2.4",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp-sheets",
-      "version": "4.2.2",
+      "version": "4.2.4",
       "transport": {
         "type": "stdio"
       },

package/src/tools/sheets-extra.ts

@@ -95,6 +95,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_add_tab', {
     description: 'Add a new sheet tab to a spreadsheet.',
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID (from the URL)'),
       tabName: z.string().describe('Name for the new tab'),
@@ -118,7 +119,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_rename_tab', {
     description: 'Rename a sheet tab.',
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       oldName: z.string().describe('Current tab name'),
@@ -131,6 +132,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_copy', {
     description: 'Copy a spreadsheet to a new spreadsheet with the given title.',
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID to copy'),
       title: z.string().describe('Title for the new copy'),
@@ -579,6 +581,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_named_ranges_add', {
     description: 'Create a new named range.',
+    annotations: { destructiveHint: true },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       name: z.string().describe('Name for the range'),
@@ -682,6 +685,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_chart_create', {
     description: 'Create an embedded chart from a JSON spec. specJson is a Sheets API ChartSpec (or full EmbeddedChart) — inline or @/path/to/file.json. Anchor the chart with sheet + anchor (A1 cell), and optionally size it with width/height pixels.',
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       specJson: z.string().describe('ChartSpec or EmbeddedChart JSON (inline or @file)'),
@@ -702,7 +706,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
 
   server.registerTool('gog_sheets_chart_update', {
     description: 'Replace a chart spec by chart ID. specJson is a Sheets API ChartSpec (or full EmbeddedChart) — inline or @/path/to/file.json.',
-    annotations: { destructiveHint: true },
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID'),
       chartId: z.string().describe('Numeric chart ID to update'),
@@ -755,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)'),
@@ -771,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'),
@@ -881,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)'),
@@ -918,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)'),
@@ -948,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)'),
@@ -994,6 +1003,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
     description:
       'Make a backup copy of an entire spreadsheet — a one-call safety snapshot to take BEFORE a risky or destructive edit (table delete, bulk clear, large rewrite). ' +
       'Returns the new copy\'s file ID and URL; if the edit goes wrong, restore by copying the backup back or sharing it. The copy is independent — later edits to the original do not affect it.',
+    annotations: { destructiveHint: false },
     inputSchema: z.object({
       spreadsheetId: z.string().describe('Spreadsheet ID to back up'),
       name: z.string().describe('Name for the backup copy, e.g. "Budget — backup before table delete"'),
@@ -1138,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'),
@@ -1218,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'),