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

package/.claude-plugin/plugin.json

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

package/dist/index.js

@@ -31399,7 +31399,7 @@ function registerSheetsTools(server2) {
 }
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.3.0" : "0.0.0";
+var VERSION = true ? "2.4.1" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31548,13 +31548,32 @@ function registerExtraSheetsTools(server2) {
       start: external_exports.number().describe("Start index (0-based)"),
       count: external_exports.number().optional().describe("Number of rows/columns to insert (default: 1)"),
       after: external_exports.boolean().optional().describe("Insert after the start index instead of before. With after:true the new dimension lands at start+1, leaving the existing dimension at start untouched."),
+      inheritFromBefore: external_exports.boolean().optional().describe("Inherit number format / styling from the row/column before the insertion. Defaults to true with after:true, false otherwise; pass false to inherit from the row/column after the insertion instead. Cannot inherit from before when inserting at the first row/column."),
       account: accountParam
     }
-  }, async ({ spreadsheetId, sheet, dimension, start, count, after, account }) => {
+  }, async ({ spreadsheetId, sheet, dimension, start, count, after, inheritFromBefore, account }) => {
     const effectiveStart = after ? start + 1 : start;
     const args = ["sheets", "insert", spreadsheetId, sheet, dimension, String(effectiveStart)];
     if (count !== void 0) args.push(`--count=${count}`);
     if (after) args.push("--after");
+    if (inheritFromBefore !== void 0) args.push(`--inherit-from-before=${inheritFromBefore}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_copy_paste", {
+    description: "Copy a source range's values/formulas/format to a destination range via the Sheets CopyPasteRequest. A destination larger than the source tiles the source to fill it \u2014 the canonical way to fill formulas down or across with relative references adjusted (aliases: fill, copy-range). Use type to control what is pasted (NORMAL pastes everything; FORMULA fills formulas with adjusted references; VALUES/FORMAT/etc. paste only that aspect).",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      source: external_exports.string().describe("Source range (e.g. Sheet1!A2:H71)"),
+      dest: external_exports.string().describe("Destination range (e.g. Sheet1!A2:H120). Larger than the source tiles/fills it."),
+      type: external_exports.enum(["NORMAL", "VALUES", "FORMAT", "FORMULA", "NO_BORDERS", "DATA_VALIDATION", "CONDITIONAL_FORMATTING"]).optional().describe("Paste type (default: NORMAL pastes everything)"),
+      transpose: external_exports.boolean().optional().describe("Paste transposed (swap rows and columns)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, source, dest, type, transpose, account }) => {
+    const args = ["sheets", "copy-paste", spreadsheetId, source, dest];
+    if (type) args.push(`--type=${type}`);
+    if (transpose) args.push("--transpose");
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_sheets_merge", {
@@ -31835,11 +31854,11 @@ ${result.content[0].text}` }] };
     return runOrDiagnose(["sheets", "named-ranges", "delete", spreadsheetId, nameOrId], { account });
   });
   server2.registerTool("gog_sheets_batch_update", {
-    description: 'Update values in multiple ranges with one Sheets API request. dataJson is a JSON array of {range, values} objects (or "@/path/to/file.json"). Atomic \u2014 either all ranges update or none do.',
+    description: `Update values in multiple ranges with one Sheets API request. dataJson is a JSON array of {range, values} objects \u2014 pass it inline as a literal JSON string. Atomic \u2014 either all ranges update or none do. (The CLI also accepts "@/path/to/file.json", but that file is read on the gog server's filesystem, not the caller's, so inline JSON is the right form for remote MCP callers.)`,
     annotations: { destructiveHint: true },
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
-      dataJson: external_exports.string().describe('Value ranges as JSON array, or @file (e.g. [{"range":"Sheet1!A1:B2","values":[["a","b"]]}])'),
+      dataJson: external_exports.string().describe('Value ranges as an inline JSON array, e.g. [{"range":"Sheet1!A1:B2","values":[["a","b"]]}]. (An "@/path" form is read on the gog server filesystem, not yours \u2014 inline the JSON instead.)'),
       input: external_exports.enum(["RAW", "USER_ENTERED"]).optional().describe("Value input option (default: USER_ENTERED)"),
       includeValuesInResponse: external_exports.boolean().optional().describe("Include updated values in the response"),
       responseRender: external_exports.enum(["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"]).optional().describe("Response value render option"),

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-sheets",
   "display_name": "gogcli (Sheets)",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
   "author": {
     "name": "Chris Hall",
@@ -136,6 +136,10 @@
       "name": "gog_sheets_insert",
       "description": "Insert rows or columns into a sheet."
     },
+    {
+      "name": "gog_sheets_copy_paste",
+      "description": "Copy a range's values/formulas/format to another range (tiles to fill down/across)."
+    },
     {
       "name": "gog_sheets_merge",
       "description": "Merge cells in a range."

package/package.json

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

package/src/tools/sheets-extra.ts

@@ -178,9 +178,10 @@ export function registerExtraSheetsTools(server: McpServer): void {
       start: z.number().describe('Start index (0-based)'),
       count: z.number().optional().describe('Number of rows/columns to insert (default: 1)'),
       after: z.boolean().optional().describe('Insert after the start index instead of before. With after:true the new dimension lands at start+1, leaving the existing dimension at start untouched.'),
+      inheritFromBefore: z.boolean().optional().describe('Inherit number format / styling from the row/column before the insertion. Defaults to true with after:true, false otherwise; pass false to inherit from the row/column after the insertion instead. Cannot inherit from before when inserting at the first row/column.'),
       account: accountParam,
     },
-  }, async ({ spreadsheetId, sheet, dimension, start, count, after, account }) => {
+  }, async ({ spreadsheetId, sheet, dimension, start, count, after, inheritFromBefore, account }) => {
     // The underlying `gog sheets insert` treats `start` as 1-based with `--after` shifting +1.
     // To honor our 0-based `start` and make `after:true` actually shift the insertion to start+1
     // (issue #42), we send `start+1` when `after:true`. With after:false the CLI's `start-1`
@@ -189,6 +190,25 @@ export function registerExtraSheetsTools(server: McpServer): void {
     const args = ['sheets', 'insert', spreadsheetId, sheet, dimension, String(effectiveStart)];
     if (count !== undefined) args.push(`--count=${count}`);
     if (after) args.push('--after');
+    if (inheritFromBefore !== undefined) args.push(`--inherit-from-before=${inheritFromBefore}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_sheets_copy_paste', {
+    description: 'Copy a source range\'s values/formulas/format to a destination range via the Sheets CopyPasteRequest. A destination larger than the source tiles the source to fill it — the canonical way to fill formulas down or across with relative references adjusted (aliases: fill, copy-range). Use type to control what is pasted (NORMAL pastes everything; FORMULA fills formulas with adjusted references; VALUES/FORMAT/etc. paste only that aspect).',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: z.string().describe('Spreadsheet ID'),
+      source: z.string().describe('Source range (e.g. Sheet1!A2:H71)'),
+      dest: z.string().describe('Destination range (e.g. Sheet1!A2:H120). Larger than the source tiles/fills it.'),
+      type: z.enum(['NORMAL', 'VALUES', 'FORMAT', 'FORMULA', 'NO_BORDERS', 'DATA_VALIDATION', 'CONDITIONAL_FORMATTING']).optional().describe('Paste type (default: NORMAL pastes everything)'),
+      transpose: z.boolean().optional().describe('Paste transposed (swap rows and columns)'),
+      account: accountParam,
+    },
+  }, async ({ spreadsheetId, source, dest, type, transpose, account }) => {
+    const args = ['sheets', 'copy-paste', spreadsheetId, source, dest];
+    if (type) args.push(`--type=${type}`);
+    if (transpose) args.push('--transpose');
     return runOrDiagnose(args, { account });
   });
 
@@ -485,11 +505,11 @@ export function registerExtraSheetsTools(server: McpServer): void {
   });
 
   server.registerTool('gog_sheets_batch_update', {
-    description: 'Update values in multiple ranges with one Sheets API request. dataJson is a JSON array of {range, values} objects (or "@/path/to/file.json"). Atomic — either all ranges update or none do.',
+    description: 'Update values in multiple ranges with one Sheets API request. dataJson is a JSON array of {range, values} objects — pass it inline as a literal JSON string. Atomic — either all ranges update or none do. (The CLI also accepts "@/path/to/file.json", but that file is read on the gog server\'s filesystem, not the caller\'s, so inline JSON is the right form for remote MCP callers.)',
     annotations: { destructiveHint: true },
     inputSchema: {
       spreadsheetId: z.string().describe('Spreadsheet ID'),
-      dataJson: z.string().describe('Value ranges as JSON array, or @file (e.g. [{"range":"Sheet1!A1:B2","values":[["a","b"]]}])'),
+      dataJson: z.string().describe('Value ranges as an inline JSON array, e.g. [{"range":"Sheet1!A1:B2","values":[["a","b"]]}]. (An "@/path" form is read on the gog server filesystem, not yours — inline the JSON instead.)'),
       input: z.enum(['RAW', 'USER_ENTERED']).optional().describe('Value input option (default: USER_ENTERED)'),
       includeValuesInResponse: z.boolean().optional().describe('Include updated values in the response'),
       responseRender: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('Response value render option'),

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

@@ -149,6 +149,43 @@ describe('gog_sheets_insert', () => {
     await handlers.get('gog_sheets_insert')!({ spreadsheetId: 'sid', sheet: 'S1', dimension: 'ROWS', start: 0, after: false });
     expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'S1', 'ROWS', '0'], { account: undefined });
   });
+
+  it('passes --inherit-from-before=true when set', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_insert')!({ spreadsheetId: 'sid', sheet: 'S1', dimension: 'ROWS', start: 5, after: true, inheritFromBefore: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'S1', 'ROWS', '6', '--after', '--inherit-from-before=true'], { account: undefined });
+  });
+
+  it('passes --inherit-from-before=false to inherit from the following neighbor', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_insert')!({ spreadsheetId: 'sid', sheet: 'S1', dimension: 'ROWS', start: 5, after: true, inheritFromBefore: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'insert', 'sid', 'S1', 'ROWS', '6', '--after', '--inherit-from-before=false'], { account: undefined });
+  });
+});
+
+describe('gog_sheets_copy_paste', () => {
+  it('calls runOrDiagnose with required source/dest', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_copy_paste')!({ spreadsheetId: 'sid', source: 'Sheet1!A2:H71', dest: 'Sheet1!A2:H120' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'copy-paste', 'sid', 'Sheet1!A2:H71', 'Sheet1!A2:H120'], { account: undefined });
+  });
+
+  it('appends --type and --transpose when provided', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_copy_paste')!({ spreadsheetId: 'sid', source: 'A1:B2', dest: 'D1:E2', type: 'FORMULA', transpose: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'copy-paste', 'sid', 'A1:B2', 'D1:E2', '--type=FORMULA', '--transpose'], { account: undefined });
+  });
+
+  it('forwards account', async () => {
+    vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+    const handlers = setupHandlers();
+    await handlers.get('gog_sheets_copy_paste')!({ spreadsheetId: 'sid', source: 'A1', dest: 'B1', account: 'a@b.com' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['sheets', 'copy-paste', 'sid', 'A1', 'B1'], { account: 'a@b.com' });
+  });
 });
 
 // 8. merge