gogcli-mcp-sheets 2.6.1 → 2.7.1

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Hall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -31399,7 +31399,7 @@ function registerSheetsTools(server2) {
 }
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.6.1" : "0.0.0";
+var VERSION = true ? "2.7.1" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31815,6 +31815,71 @@ ${result.content[0].text}` }] };
     if (cellsJson) args.push(`--cells-json=${cellsJson}`);
     return runOrDiagnose(args, { account });
   });
+  server2.registerTool("gog_sheets_validation_get", {
+    description: "Read the data-validation rules (dropdowns, checkboxes, number/date conditions, custom formulas) applied to a range.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range to inspect (e.g. Sheet1!A1:A10)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, account }) => {
+    return runOrDiagnose(["sheets", "validation", "get", spreadsheetId, range], { account });
+  });
+  server2.registerTool("gog_sheets_validation_set", {
+    description: "Set a data-validation rule on a range \u2014 dropdowns (ONE_OF_LIST / ONE_OF_RANGE), checkboxes (BOOLEAN), number/date conditions, or custom formulas. Overwrites any existing rule on the range. Repeat values for list entries or between-bounds.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range to apply the rule to (e.g. Sheet1!A1:A10)"),
+      type: external_exports.string().describe("Condition type, e.g. ONE_OF_LIST, ONE_OF_RANGE, NUMBER_BETWEEN, NUMBER_GREATER, DATE_AFTER, BOOLEAN, CUSTOM_FORMULA"),
+      values: external_exports.array(external_exports.string()).optional().describe("Condition values (repeatable): list entries for ONE_OF_LIST, two bounds for *_BETWEEN, a range for ONE_OF_RANGE, a formula for CUSTOM_FORMULA"),
+      strict: external_exports.boolean().optional().describe("Reject invalid input instead of showing a warning"),
+      inputMessage: external_exports.string().optional().describe("Message shown when the cell is selected"),
+      showCustomUi: external_exports.boolean().optional().describe("Show dropdown or checkbox UI where supported"),
+      filteredRowsIncluded: external_exports.boolean().optional().describe("Apply the rule to filtered rows too; required for table-managed dropdown columns"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, type, values, strict, inputMessage, showCustomUi, filteredRowsIncluded, account }) => {
+    const args = ["sheets", "validation", "set", spreadsheetId, range, `--type=${type}`];
+    if (values) for (const v of values) args.push(`--value=${v}`);
+    if (strict) args.push("--strict");
+    if (inputMessage) args.push(`--input-message=${inputMessage}`);
+    if (showCustomUi) args.push("--show-custom-ui");
+    if (filteredRowsIncluded) args.push("--filtered-rows-included");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_validation_clear", {
+    description: "Remove all data-validation rules from a range.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range to clear (e.g. Sheet1!A1:A10)"),
+      filteredRowsIncluded: external_exports.boolean().optional().describe("Clear rules from filtered rows too; required for table-managed dropdown columns"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, filteredRowsIncluded, account }) => {
+    const args = ["sheets", "validation", "clear", spreadsheetId, range];
+    if (filteredRowsIncluded) args.push("--filtered-rows-included");
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_delete_dimension", {
+    description: "Delete a span of rows or columns, table-aware: intersecting table objects are preserved (shrunk) along with their remaining data, instead of being corrupted as with a raw DeleteDimension batch update. Target by A1 range (e.g. Sheet1!5:7 or Sheet1!C:D) or by sheet name plus start/end.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      rangeOrSheet: external_exports.string().describe("A1 range covering the rows/columns to delete, or a sheet name (then start/end are required)"),
+      dimension: external_exports.enum(["ROWS", "COLUMNS"]).describe("Dimension to delete"),
+      start: external_exports.number().int().optional().describe("First row/column to delete (1-based, inclusive; required with a sheet-name target)"),
+      end: external_exports.number().int().optional().describe("Last row/column to delete (1-based, inclusive; required with a sheet-name target)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, rangeOrSheet, dimension, start, end, account }) => {
+    const args = ["sheets", "delete-dimension", spreadsheetId, rangeOrSheet, `--dimension=${dimension}`];
+    if (start !== void 0) args.push(`--start=${start}`);
+    if (end !== void 0) args.push(`--end=${end}`);
+    return runOrDiagnose(args, { account });
+  });
   server2.registerTool("gog_sheets_named_ranges_list", {
     description: "List all named ranges in a spreadsheet.",
     annotations: { readOnlyHint: true },
@@ -32037,7 +32102,7 @@ ${result.content[0].text}` }] };
     return runOrDiagnose(["sheets", "table", "clear", spreadsheetId, tableId], { account });
   });
   server2.registerTool("gog_sheets_table_delete", {
-    description: "Delete a Google Sheets table. WARNING: the underlying `gog`/Sheets behaviour is that deleting a table also DESTROYS every cell value in the table range \u2014 not just the table styling/columns. By default this tool prevents that data loss by emulating the Sheets UI's \"Convert to range\": it reads the table's cells (values AND formulas) first, deletes the table, then restores the data into the now-plain range. Formatting, banding, and data-validation dropdowns are still lost (gog cannot round-trip those yet). Set keep_data=false to delete the table AND wipe its cell data (the raw destructive behaviour). To preserve everything, snapshot the whole spreadsheet first with gog_sheets_snapshot.",
+    description: "Delete a Google Sheets table. WARNING: the underlying `gog`/Sheets behaviour is that deleting a table also DESTROYS every cell value in the table range \u2014 not just the table styling/columns. By default this tool prevents that data loss by emulating the Sheets UI's \"Convert to range\": it reads the table's cells (values AND formulas) first, deletes the table, then restores the data into the now-plain range. Formatting and banding are still lost; data-validation dropdowns are also not restored automatically, but you can snapshot them first with gog_sheets_validation_get and re-apply with gog_sheets_validation_set. Set keep_data=false to delete the table AND wipe its cell data (the raw destructive behaviour). To preserve everything, snapshot the whole spreadsheet first with gog_sheets_snapshot.",
     annotations: { destructiveHint: true },
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-sheets",
   "display_name": "gogcli (Sheets)",
-  "version": "2.6.1",
+  "version": "2.7.1",
   "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
   "author": {
     "name": "Chris Hall",
@@ -184,6 +184,22 @@
       "name": "gog_sheets_links_set",
       "description": "Set native cell hyperlinks: single link, multi-link rich-text cell (runsJson), or batch (cellsJson)."
     },
+    {
+      "name": "gog_sheets_validation_get",
+      "description": "Read data-validation rules (dropdowns, checkboxes, conditions) on a range."
+    },
+    {
+      "name": "gog_sheets_validation_set",
+      "description": "Set a data-validation rule on a range: dropdowns, checkboxes, number/date conditions, or custom formulas."
+    },
+    {
+      "name": "gog_sheets_validation_clear",
+      "description": "Remove all data-validation rules from a range."
+    },
+    {
+      "name": "gog_sheets_delete_dimension",
+      "description": "Delete a row or column span, table-aware: intersecting tables are shrunk and their remaining data preserved."
+    },
     {
       "name": "gog_sheets_named_ranges_list",
       "description": "List all named ranges in a spreadsheet."

package/package.json

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

package/src/tools/sheets-extra.ts

@@ -466,6 +466,75 @@ export function registerExtraSheetsTools(server: McpServer): void {
     return runOrDiagnose(args, { account });
   });
 
+  server.registerTool('gog_sheets_validation_get', {
+    description: 'Read the data-validation rules (dropdowns, checkboxes, number/date conditions, custom formulas) applied to a range.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      range: z.string().describe('Range to inspect (e.g. Sheet1!A1:A10)'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, range, account }) => {
+    return runOrDiagnose(['sheets', 'validation', 'get', spreadsheetId, range], { account });
+  });
+
+  server.registerTool('gog_sheets_validation_set', {
+    description: 'Set a data-validation rule on a range — dropdowns (ONE_OF_LIST / ONE_OF_RANGE), checkboxes (BOOLEAN), number/date conditions, or custom formulas. Overwrites any existing rule on the range. Repeat values for list entries or between-bounds.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      range: z.string().describe('Range to apply the rule to (e.g. Sheet1!A1:A10)'),
+      type: z.string().describe('Condition type, e.g. ONE_OF_LIST, ONE_OF_RANGE, NUMBER_BETWEEN, NUMBER_GREATER, DATE_AFTER, BOOLEAN, CUSTOM_FORMULA'),
+      values: z.array(z.string()).optional().describe('Condition values (repeatable): list entries for ONE_OF_LIST, two bounds for *_BETWEEN, a range for ONE_OF_RANGE, a formula for CUSTOM_FORMULA'),
+      strict: z.boolean().optional().describe('Reject invalid input instead of showing a warning'),
+      inputMessage: z.string().optional().describe('Message shown when the cell is selected'),
+      showCustomUi: z.boolean().optional().describe('Show dropdown or checkbox UI where supported'),
+      filteredRowsIncluded: z.boolean().optional().describe('Apply the rule to filtered rows too; required for table-managed dropdown columns'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, range, type, values, strict, inputMessage, showCustomUi, filteredRowsIncluded, account }) => {
+    const args = ['sheets', 'validation', 'set', spreadsheetId, range, `--type=${type}`];
+    if (values) for (const v of values) args.push(`--value=${v}`);
+    if (strict) args.push('--strict');
+    if (inputMessage) args.push(`--input-message=${inputMessage}`);
+    if (showCustomUi) args.push('--show-custom-ui');
+    if (filteredRowsIncluded) args.push('--filtered-rows-included');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_sheets_validation_clear', {
+    description: 'Remove all data-validation rules from a range.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      range: z.string().describe('Range to clear (e.g. Sheet1!A1:A10)'),
+      filteredRowsIncluded: z.boolean().optional().describe('Clear rules from filtered rows too; required for table-managed dropdown columns'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, range, filteredRowsIncluded, account }) => {
+    const args = ['sheets', 'validation', 'clear', spreadsheetId, range];
+    if (filteredRowsIncluded) args.push('--filtered-rows-included');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_sheets_delete_dimension', {
+    description: 'Delete a span of rows or columns, table-aware: intersecting table objects are preserved (shrunk) along with their remaining data, instead of being corrupted as with a raw DeleteDimension batch update. Target by A1 range (e.g. Sheet1!5:7 or Sheet1!C:D) or by sheet name plus start/end.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      rangeOrSheet: z.string().describe('A1 range covering the rows/columns to delete, or a sheet name (then start/end are required)'),
+      dimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension to delete'),
+      start: z.number().int().optional().describe('First row/column to delete (1-based, inclusive; required with a sheet-name target)'),
+      end: z.number().int().optional().describe('Last row/column to delete (1-based, inclusive; required with a sheet-name target)'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, rangeOrSheet, dimension, start, end, account }) => {
+    const args = ['sheets', 'delete-dimension', spreadsheetId, rangeOrSheet, `--dimension=${dimension}`];
+    if (start !== undefined) args.push(`--start=${start}`);
+    if (end !== undefined) args.push(`--end=${end}`);
+    return runOrDiagnose(args, { account });
+  });
+
   server.registerTool('gog_sheets_named_ranges_list', {
     description: 'List all named ranges in a spreadsheet.',
     annotations: { readOnlyHint: true },
@@ -712,7 +781,7 @@ export function registerExtraSheetsTools(server: McpServer): void {
     description:
       'Delete a Google Sheets table. WARNING: the underlying `gog`/Sheets behaviour is that deleting a table also DESTROYS every cell value in the table range — not just the table styling/columns. ' +
       'By default this tool prevents that data loss by emulating the Sheets UI\'s "Convert to range": it reads the table\'s cells (values AND formulas) first, deletes the table, then restores the data into the now-plain range. ' +
-      'Formatting, banding, and data-validation dropdowns are still lost (gog cannot round-trip those yet). ' +
+      'Formatting and banding are still lost; data-validation dropdowns are also not restored automatically, but you can snapshot them first with gog_sheets_validation_get and re-apply with gog_sheets_validation_set. ' +
       'Set keep_data=false to delete the table AND wipe its cell data (the raw destructive behaviour). To preserve everything, snapshot the whole spreadsheet first with gog_sheets_snapshot.',
     annotations: { destructiveHint: true },
     inputSchema: {

package/tests/tools/sheets-extra.test.ts

@@ -1284,3 +1284,82 @@ describe('gog_sheets_snapshot', () => {
     expect(lib.runOrDiagnose).toHaveBeenCalledWith(['drive', 'copy', 'sid', 'Backup A', '--parent=folder1'], { account: 'a@b.com' });
   });
 });
+
+// gog 0.24.0
+describe('gog_sheets_validation_get', () => {
+  it('reads validation rules for a range', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_validation_get')!({ spreadsheetId: 'sid', range: 'Sheet1!A1:A10' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'validation', 'get', 'sid', 'Sheet1!A1:A10'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_sheets_validation_set', () => {
+  it('sets a dropdown rule with repeated values', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_validation_set')!({
+      spreadsheetId: 'sid', range: 'A1:A10', type: 'ONE_OF_LIST', values: ['Red', 'Green'],
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'validation', 'set', 'sid', 'A1:A10', '--type=ONE_OF_LIST', '--value=Red', '--value=Green'],
+      { account: undefined },
+    );
+  });
+
+  it('passes strict, input message, custom UI and filtered-rows flags', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_validation_set')!({
+      spreadsheetId: 'sid', range: 'A1', type: 'NUMBER_BETWEEN', values: ['1', '10'],
+      strict: true, inputMessage: 'Pick 1-10', showCustomUi: true, filteredRowsIncluded: true,
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'validation', 'set', 'sid', 'A1', '--type=NUMBER_BETWEEN', '--value=1', '--value=10',
+        '--strict', '--input-message=Pick 1-10', '--show-custom-ui', '--filtered-rows-included'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_sheets_validation_clear', () => {
+  it('clears rules from a range', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_validation_clear')!({ spreadsheetId: 'sid', range: 'A1:A10', filteredRowsIncluded: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'validation', 'clear', 'sid', 'A1:A10', '--filtered-rows-included'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_sheets_delete_dimension', () => {
+  it('deletes a row span from a sheet target', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_delete_dimension')!({
+      spreadsheetId: 'sid', rangeOrSheet: 'Sheet1', dimension: 'ROWS', start: 5, end: 7,
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'delete-dimension', 'sid', 'Sheet1', '--dimension=ROWS', '--start=5', '--end=7'],
+      { account: undefined },
+    );
+  });
+
+  it('deletes columns by A1 range without start/end', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_delete_dimension')!({
+      spreadsheetId: 'sid', rangeOrSheet: 'Sheet1!C:D', dimension: 'COLUMNS', account: 'a@b.com',
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['sheets', 'delete-dimension', 'sid', 'Sheet1!C:D', '--dimension=COLUMNS'],
+      { account: 'a@b.com' },
+    );
+  });
+});