@mcp-z/mcp-sheets 1.0.0

package/dist/esm/mcp/tools/sheet-find.js

@@ -0,0 +1,90 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { SheetGidOutput, SheetRefSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+import { findSheetByRef } from '../../spreadsheet/sheet-operations.js';
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    sheetRef: SheetRefSchema
+});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    id: SpreadsheetIdOutput,
+    gid: SheetGidOutput,
+    title: z.string().describe('Sheet tab name'),
+    sheetUrl: z.string().optional().describe('URL to view the sheet')
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Find an existing sheet/tab within a known spreadsheet by title or GUID',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, sheetRef }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.sheet.find called', {
+        id,
+        sheetRef
+    });
+    try {
+        var _ref;
+        var _sheet_properties, _sheet_properties1;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // Find sheet within the known spreadsheet
+        const sheet = await findSheetByRef(sheets, id, sheetRef, logger);
+        if (!sheet) {
+            throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');
+        }
+        const title = (_ref = sheet === null || sheet === void 0 ? void 0 : (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : String(sheetRef);
+        const gid = (sheet === null || sheet === void 0 ? void 0 : (_sheet_properties1 = sheet.properties) === null || _sheet_properties1 === void 0 ? void 0 : _sheet_properties1.sheetId) != null ? String(sheet.properties.sheetId) : '';
+        const sheetUrl = gid ? `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}` : `https://docs.google.com/spreadsheets/d/${id}`;
+        logger.info('sheets.sheet.find success', {
+            id,
+            gid,
+            title
+        });
+        const result = {
+            type: 'success',
+            id,
+            gid,
+            title,
+            sheetUrl
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('sheets.sheet.find error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error finding sheet: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'sheet-find',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/sheet-find.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/sheet-find.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetRefSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\nimport { findSheetByRef } from '../../spreadsheet/sheet-operations.js';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  sheetRef: SheetRefSchema,\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  title: z.string().describe('Sheet tab name'),\n  sheetUrl: z.string().optional().describe('URL to view the sheet'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find an existing sheet/tab within a known spreadsheet by title or GUID',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, sheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.find called', { id, sheetRef });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Find sheet within the known spreadsheet\n    const sheet = await findSheetByRef(sheets, id, sheetRef, logger);\n    if (!sheet) {\n      throw new McpError(ErrorCode.InvalidParams, 'Sheet not found');\n    }\n\n    const title = sheet?.properties?.title ?? String(sheetRef);\n    const gid = sheet?.properties?.sheetId != null ? String(sheet.properties.sheetId) : '';\n    const sheetUrl = gid ? `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}` : `https://docs.google.com/spreadsheets/d/${id}`;\n\n    logger.info('sheets.sheet.find success', { id, gid, title });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid,\n      title,\n      sheetUrl,\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.sheet.find error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error finding sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-find',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetRefSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","findSheetByRef","inputSchema","object","id","sheetRef","successBranchSchema","type","literal","gid","title","string","describe","sheetUrl","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sheet","sheets","version","auth","authContext","InvalidParams","properties","String","sheetId","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"AACA,SAASA,OAAO,QAAQ,sBAAsB;AAE9C,MAAM,EAAEC,wBAAwB,EAAE,GAAGD;AAIrC,SAASE,SAAS,EAAEC,QAAQ,QAAQ,qCAAqC;AACzE,SAASC,MAAM,QAAQ,aAAa;AACpC,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,cAAc,EAAEC,cAAc,EAAEC,mBAAmB,EAAEC,mBAAmB,QAAQ,yBAAyB;AAClH,SAASC,cAAc,QAAQ,wCAAwC;AAEvE,MAAMC,cAAcN,EAAEO,MAAM,CAAC;IAC3BC,IAAIJ;IACJK,UAAUP;AACZ;AAEA,MAAMQ,sBAAsBV,EAAEO,MAAM,CAAC;IACnCI,MAAMX,EAAEY,OAAO,CAAC;IAChBJ,IAAIL;IACJU,KAAKZ;IACLa,OAAOd,EAAEe,MAAM,GAAGC,QAAQ,CAAC;IAC3BC,UAAUjB,EAAEe,MAAM,GAAGG,QAAQ,GAAGF,QAAQ,CAAC;AAC3C;AAEA,MAAMG,eAAenB,EAAEoB,kBAAkB,CAAC,QAAQ;IAACV;IAAqBd;CAAyB;AAEjG,MAAMyB,SAAS;IACbC,aAAa;IACbhB;IACAa,cAAcnB,EAAEO,MAAM,CAAC;QACrBgB,QAAQJ;IACV;AACF;AAKA,eAAeK,QAAQ,EAAEhB,EAAE,EAAEC,QAAQ,EAAS,EAAEgB,KAAoB;IAClE,MAAMC,SAASD,MAAMC,MAAM;IAC3BA,OAAOC,IAAI,CAAC,4BAA4B;QAAEnB;QAAIC;IAAS;IAEvD,IAAI;;YASYmB,mBACFA;QATZ,MAAMC,SAAS9B,OAAO8B,MAAM,CAAC;YAAEC,SAAS;YAAMC,MAAMN,MAAMO,WAAW,CAACD,IAAI;QAAC;QAE3E,0CAA0C;QAC1C,MAAMH,QAAQ,MAAMvB,eAAewB,QAAQrB,IAAIC,UAAUiB;QACzD,IAAI,CAACE,OAAO;YACV,MAAM,IAAI9B,SAASD,UAAUoC,aAAa,EAAE;QAC9C;QAEA,MAAMnB,gBAAQc,kBAAAA,6BAAAA,oBAAAA,MAAOM,UAAU,cAAjBN,wCAAAA,kBAAmBd,KAAK,uCAAIqB,OAAO1B;QACjD,MAAMI,MAAMe,CAAAA,kBAAAA,6BAAAA,qBAAAA,MAAOM,UAAU,cAAjBN,yCAAAA,mBAAmBQ,OAAO,KAAI,OAAOD,OAAOP,MAAMM,UAAU,CAACE,OAAO,IAAI;QACpF,MAAMnB,WAAWJ,MAAM,CAAC,uCAAuC,EAAEL,GAAG,UAAU,EAAEK,KAAK,GAAG,CAAC,uCAAuC,EAAEL,IAAI;QAEtIkB,OAAOC,IAAI,CAAC,6BAA6B;YAAEnB;YAAIK;YAAKC;QAAM;QAE1D,MAAMS,SAAiB;YACrBZ,MAAM;YACNH;YACAK;YACAC;YACAG;QACF;QAEA,OAAO;YACLoB,SAAS;gBAAC;oBAAE1B,MAAM;oBAAiB2B,MAAMC,KAAKC,SAAS,CAACjB;gBAAQ;aAAE;YAClEkB,mBAAmB;gBAAElB;YAAO;QAC9B;IACF,EAAE,OAAOmB,OAAO;QACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAGR,OAAOO;QAChEhB,OAAOgB,KAAK,CAAC,2BAA2B;YAAEA,OAAOC;QAAQ;QAEzD,MAAM,IAAI7C,SAASD,UAAUgD,aAAa,EAAE,CAAC,qBAAqB,EAAEF,SAAS,EAAE;YAC7EG,OAAOJ,iBAAiBE,QAAQF,MAAMI,KAAK,GAAGC;QAChD;IACF;AACF;AAEA,eAAe,SAASC;IACtB,OAAO;QACLC,MAAM;QACN5B;QACAG;IACF;AACF"}

package/dist/esm/mcp/tools/sheet-rename.d.ts

@@ -0,0 +1,60 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    gid: z.ZodCoercedString<unknown>;
+    newTitle: z.ZodCoercedString<unknown>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    operationSummary: z.ZodString;
+    itemsProcessed: z.ZodNumber;
+    itemsChanged: z.ZodNumber;
+    completedAt: z.ZodString;
+    id: z.ZodString;
+    gid: z.ZodString;
+    sheetUrl: z.ZodString;
+    oldTitle: z.ZodString;
+    newTitle: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, gid, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Rename a sheet within a spreadsheet.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            newTitle: z.ZodCoercedString<unknown>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                operationSummary: z.ZodString;
+                itemsProcessed: z.ZodNumber;
+                itemsChanged: z.ZodNumber;
+                completedAt: z.ZodString;
+                id: z.ZodString;
+                gid: z.ZodString;
+                sheetUrl: z.ZodString;
+                oldTitle: z.ZodString;
+                newTitle: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/sheet-rename.js

@@ -0,0 +1,128 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    gid: SheetGidSchema,
+    newTitle: z.coerce.string().trim().min(1).describe('New name for the sheet tab')
+});
+// Success branch schema
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    operationSummary: z.string().describe('Summary of the rename operation'),
+    itemsProcessed: z.number().describe('Total items attempted (always 1 for single sheet)'),
+    itemsChanged: z.number().describe('Successfully renamed sheets (always 1 on success)'),
+    completedAt: z.string().describe('ISO datetime when operation completed'),
+    id: SpreadsheetIdOutput,
+    gid: SheetGidOutput,
+    sheetUrl: z.string().describe('URL of the renamed sheet'),
+    oldTitle: z.string().describe('Previous title of the sheet'),
+    newTitle: z.string().describe('New title of the sheet')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Rename a sheet within a spreadsheet.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, gid, newTitle }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.sheet.rename called', {
+        id,
+        gid,
+        newTitle
+    });
+    try {
+        var _spreadsheetInfo_data_sheets;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // First, get the current sheet title
+        const spreadsheetInfo = await sheets.spreadsheets.get({
+            spreadsheetId: id,
+            fields: 'sheets.properties.sheetId,sheets.properties.title'
+        });
+        const sheetInfo = (_spreadsheetInfo_data_sheets = spreadsheetInfo.data.sheets) === null || _spreadsheetInfo_data_sheets === void 0 ? void 0 : _spreadsheetInfo_data_sheets.find((s)=>{
+            var _s_properties;
+            return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === gid;
+        });
+        if (!(sheetInfo === null || sheetInfo === void 0 ? void 0 : sheetInfo.properties)) {
+            throw new McpError(ErrorCode.InvalidParams, `Sheet with gid "${gid}" not found in spreadsheet`);
+        }
+        const oldTitle = sheetInfo.properties.title || '';
+        // Rename the sheet
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: id,
+            requestBody: {
+                requests: [
+                    {
+                        updateSheetProperties: {
+                            properties: {
+                                sheetId: Number(gid),
+                                title: newTitle
+                            },
+                            fields: 'title'
+                        }
+                    }
+                ]
+            }
+        });
+        logger.info('sheets.sheet.rename success', {
+            id,
+            gid,
+            oldTitle,
+            newTitle
+        });
+        const result = {
+            type: 'success',
+            operationSummary: `Renamed sheet "${oldTitle}" to "${newTitle}"`,
+            itemsProcessed: 1,
+            itemsChanged: 1,
+            completedAt: new Date().toISOString(),
+            id,
+            gid,
+            sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,
+            oldTitle,
+            newTitle
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        if (error instanceof McpError) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('sheets.sheet.rename error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error renaming sheet: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'sheet-rename',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/sheet-rename.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/sheet-rename.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  newTitle: z.coerce.string().trim().min(1).describe('New name for the sheet tab'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the rename operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1 for single sheet)'),\n  itemsChanged: z.number().describe('Successfully renamed sheets (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  sheetUrl: z.string().describe('URL of the renamed sheet'),\n  oldTitle: z.string().describe('Previous title of the sheet'),\n  newTitle: z.string().describe('New title of the sheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Rename a sheet within a spreadsheet.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, gid, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.rename called', { id, gid, newTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // First, get the current sheet title\n    const spreadsheetInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sheetInfo = spreadsheetInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheetInfo?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Sheet with gid \"${gid}\" not found in spreadsheet`);\n    }\n\n    const oldTitle = sheetInfo.properties.title || '';\n\n    // Rename the sheet\n    await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [\n          {\n            updateSheetProperties: {\n              properties: { sheetId: Number(gid), title: newTitle },\n              fields: 'title',\n            },\n          },\n        ],\n      },\n    });\n\n    logger.info('sheets.sheet.rename success', { id, gid, oldTitle, newTitle });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Renamed sheet \"${oldTitle}\" to \"${newTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      gid,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${gid}`,\n      oldTitle,\n      newTitle,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    if (error instanceof McpError) {\n      throw error;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.sheet.rename error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error renaming sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-rename',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","newTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sheetUrl","oldTitle","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sheetInfo","data","find","s","String","properties","sheetId","InvalidParams","title","batchUpdate","requestBody","requests","updateSheetProperties","Number","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/spreadsheet-copy.d.ts

@@ -0,0 +1,58 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    id: z.ZodString;
+    newTitle: z.ZodOptional<z.ZodCoercedString<unknown>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    operationSummary: z.ZodString;
+    itemsProcessed: z.ZodNumber;
+    itemsChanged: z.ZodNumber;
+    completedAt: z.ZodString;
+    sourceId: z.ZodString;
+    sourceTitle: z.ZodString;
+    newId: z.ZodString;
+    newTitle: z.ZodString;
+    spreadsheetUrl: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ id, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Copy an entire spreadsheet/workbook (all sheets, formatting, charts, named ranges, etc.). Creates in the same folder as the original. Uses Google Drive API.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            newTitle: z.ZodOptional<z.ZodCoercedString<unknown>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                operationSummary: z.ZodString;
+                itemsProcessed: z.ZodNumber;
+                itemsChanged: z.ZodNumber;
+                completedAt: z.ZodString;
+                sourceId: z.ZodString;
+                sourceTitle: z.ZodString;
+                newId: z.ZodString;
+                newTitle: z.ZodString;
+                spreadsheetUrl: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/spreadsheet-copy.js

@@ -0,0 +1,117 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { SpreadsheetIdSchema } from '../../schemas/index.js';
+// Note: Using contextual descriptions for sourceId/newId since they describe different spreadsheets
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    newTitle: z.coerce.string().trim().min(1).optional().describe('Name for the copy (optional, defaults to "Copy of [original]")')
+});
+// Success branch schema
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    operationSummary: z.string().describe('Summary of the copy operation'),
+    itemsProcessed: z.number().describe('Total items attempted (always 1)'),
+    itemsChanged: z.number().describe('Successfully copied (always 1 on success)'),
+    completedAt: z.string().describe('ISO datetime when operation completed'),
+    sourceId: z.string().describe('Source spreadsheet ID'),
+    sourceTitle: z.string().describe('Source spreadsheet title'),
+    newId: z.string().describe('Copied spreadsheet ID'),
+    newTitle: z.string().describe('Title of the copied spreadsheet'),
+    spreadsheetUrl: z.string().describe('URL of the copied spreadsheet')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Copy an entire spreadsheet/workbook (all sheets, formatting, charts, named ranges, etc.). Creates in the same folder as the original. Uses Google Drive API.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, newTitle }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.spreadsheet.copy called', {
+        id,
+        newTitle
+    });
+    try {
+        var _sourceInfo_data_properties;
+        const drive = google.drive({
+            version: 'v3',
+            auth: extra.authContext.auth
+        });
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // Get the original spreadsheet title
+        const sourceInfo = await sheets.spreadsheets.get({
+            spreadsheetId: id,
+            fields: 'properties.title'
+        });
+        const sourceTitle = ((_sourceInfo_data_properties = sourceInfo.data.properties) === null || _sourceInfo_data_properties === void 0 ? void 0 : _sourceInfo_data_properties.title) || '';
+        // Copy the spreadsheet using Drive API
+        const copyResponse = await drive.files.copy({
+            fileId: id,
+            requestBody: {
+                ...newTitle && {
+                    name: newTitle
+                }
+            }
+        });
+        const newId = copyResponse.data.id;
+        const resultTitle = copyResponse.data.name || '';
+        if (!newId) {
+            throw new Error('Failed to retrieve new spreadsheet ID from API response');
+        }
+        logger.info('sheets.spreadsheet.copy success', {
+            sourceId: id,
+            newId,
+            newTitle: resultTitle
+        });
+        const result = {
+            type: 'success',
+            operationSummary: `Copied spreadsheet "${sourceTitle}" to "${resultTitle}"`,
+            itemsProcessed: 1,
+            itemsChanged: 1,
+            completedAt: new Date().toISOString(),
+            sourceId: id,
+            sourceTitle,
+            newId,
+            newTitle: resultTitle,
+            spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${newId}`
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('sheets.spreadsheet.copy error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error copying spreadsheet: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'spreadsheet-copy',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/spreadsheet-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/spreadsheet-copy.ts"],"sourcesContent":["import type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { SpreadsheetIdSchema } from '../../schemas/index.js';\n\n// Note: Using contextual descriptions for sourceId/newId since they describe different spreadsheets\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  newTitle: z.coerce.string().trim().min(1).optional().describe('Name for the copy (optional, defaults to \"Copy of [original]\")'),\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Summary of the copy operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1)'),\n  itemsChanged: z.number().describe('Successfully copied (always 1 on success)'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  sourceId: z.string().describe('Source spreadsheet ID'),\n  sourceTitle: z.string().describe('Source spreadsheet title'),\n  newId: z.string().describe('Copied spreadsheet ID'),\n  newTitle: z.string().describe('Title of the copied spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the copied spreadsheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy an entire spreadsheet/workbook (all sheets, formatting, charts, named ranges, etc.). Creates in the same folder as the original. Uses Google Drive API.',\n  inputSchema,\n  outputSchema: z.object({\n    result: outputSchema,\n  }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ id, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.spreadsheet.copy called', { id, newTitle });\n\n  try {\n    const drive = google.drive({ version: 'v3', auth: extra.authContext.auth });\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get the original spreadsheet title\n    const sourceInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title',\n    });\n\n    const sourceTitle = sourceInfo.data.properties?.title || '';\n\n    // Copy the spreadsheet using Drive API\n    const copyResponse = await drive.files.copy({\n      fileId: id,\n      requestBody: {\n        ...(newTitle && { name: newTitle }),\n      },\n    });\n\n    const newId = copyResponse.data.id;\n    const resultTitle = copyResponse.data.name || '';\n\n    if (!newId) {\n      throw new Error('Failed to retrieve new spreadsheet ID from API response');\n    }\n\n    logger.info('sheets.spreadsheet.copy success', { sourceId: id, newId, newTitle: resultTitle });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Copied spreadsheet \"${sourceTitle}\" to \"${resultTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      sourceId: id,\n      sourceTitle,\n      newId,\n      newTitle: resultTitle,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${newId}`,\n    };\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(result),\n        },\n      ],\n      structuredContent: { result },\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    logger.error('sheets.spreadsheet.copy error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error copying spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'spreadsheet-copy',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SpreadsheetIdSchema","inputSchema","object","id","newTitle","coerce","string","trim","min","optional","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sourceId","sourceTitle","newId","spreadsheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sourceInfo","drive","version","auth","authContext","sheets","spreadsheets","get","spreadsheetId","fields","data","properties","title","copyResponse","files","copy","fileId","requestBody","name","resultTitle","Error","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","String","InternalError","stack","undefined","createTool"],"mappings":"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"}

package/dist/esm/mcp/tools/spreadsheet-create.d.ts

@@ -0,0 +1,52 @@
+import type { EnrichedExtra } from '@mcp-z/oauth-google';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    title: z.ZodCoercedString<unknown>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    operationSummary: z.ZodString;
+    itemsProcessed: z.ZodNumber;
+    itemsChanged: z.ZodNumber;
+    completedAt: z.ZodString;
+    id: z.ZodString;
+    spreadsheetUrl: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"auth_required">;
+    provider: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type Input = z.infer<typeof inputSchema>;
+export type Output = z.infer<typeof outputSchema>;
+declare function handler({ title }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Create a new spreadsheet";
+        readonly inputSchema: z.ZodObject<{
+            title: z.ZodCoercedString<unknown>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                operationSummary: z.ZodString;
+                itemsProcessed: z.ZodNumber;
+                itemsChanged: z.ZodNumber;
+                completedAt: z.ZodString;
+                id: z.ZodString;
+                spreadsheetUrl: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"auth_required">;
+                provider: z.ZodString;
+                message: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">;
+        }, z.core.$strip>;
+    };
+    handler: typeof handler;
+};
+export {};

package/dist/esm/mcp/tools/spreadsheet-create.js

@@ -0,0 +1,97 @@
+import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { SpreadsheetIdOutput } from '../../schemas/index.js';
+const inputSchema = z.object({
+    title: z.coerce.string().trim().min(1).describe('Title for the new spreadsheet')
+});
+// Success branch schema
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    operationSummary: z.string().describe('Summary of the spreadsheet creation operation'),
+    itemsProcessed: z.number().describe('Total items attempted (always 1 for single spreadsheet)'),
+    itemsChanged: z.number().describe('Successfully created spreadsheets (always 1 on success)'),
+    completedAt: z.string().describe('ISO datetime when operation completed'),
+    id: SpreadsheetIdOutput,
+    spreadsheetUrl: z.string().describe('URL of the created spreadsheet'),
+    title: z.string().describe('Title of the created spreadsheet')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Create a new spreadsheet',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ title }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.spreadsheet.create called', {
+        title
+    });
+    try {
+        var _res_spreadsheetId, _res_spreadsheetUrl;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        const response = await sheets.spreadsheets.create({
+            requestBody: {
+                properties: {
+                    title: title
+                }
+            }
+        });
+        const res = response.data;
+        const id = (_res_spreadsheetId = res.spreadsheetId) !== null && _res_spreadsheetId !== void 0 ? _res_spreadsheetId : '';
+        const url = (_res_spreadsheetUrl = res.spreadsheetUrl) !== null && _res_spreadsheetUrl !== void 0 ? _res_spreadsheetUrl : '';
+        logger.info('sheets.spreadsheet.create success', {
+            id,
+            title,
+            url
+        });
+        const result = {
+            type: 'success',
+            operationSummary: `Created spreadsheet "${title}"`,
+            itemsProcessed: 1,
+            itemsChanged: 1,
+            completedAt: new Date().toISOString(),
+            id,
+            spreadsheetUrl: url,
+            title
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('sheets.spreadsheet.create error', {
+            error: message
+        });
+        // Throw McpError for proper MCP error handling
+        throw new McpError(ErrorCode.InternalError, `Error creating spreadsheet: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'spreadsheet-create',
+        config,
+        handler
+    };
+}