@mcp-z/mcp-sheets 1.0.0

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

@@ -0,0 +1,177 @@
+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 MAX_BATCH_SIZE = 100;
+const copyItemSchema = z.object({
+    newTitle: z.coerce.string().trim().min(1).describe('Name for the copied sheet'),
+    insertIndex: z.number().int().min(0).optional().describe('Position to insert the new sheet (0-indexed)')
+});
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    gid: SheetGidSchema,
+    copies: z.array(copyItemSchema).min(1).max(MAX_BATCH_SIZE).describe('Array of copies to create from the source sheet')
+});
+// Created sheet info
+const createdSheetSchema = z.object({
+    gid: SheetGidOutput,
+    title: z.string().describe('Title of the created sheet'),
+    sheetUrl: z.string().describe('URL of the created sheet')
+});
+// Success branch schema - uses items: for consistency with standard vocabulary
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    operationSummary: z.string().describe('Summary of the copy operation'),
+    itemsProcessed: z.number().describe('Total copies attempted'),
+    itemsChanged: z.number().describe('Successfully created copies'),
+    completedAt: z.string().describe('ISO datetime when operation completed'),
+    id: SpreadsheetIdOutput,
+    sourceGid: z.string().describe('Source sheet ID'),
+    sourceTitle: z.string().describe('Source sheet title'),
+    items: z.array(createdSheetSchema).describe('Information about created sheets'),
+    failures: z.array(z.object({
+        title: z.string(),
+        error: z.string()
+    })).optional().describe('Failed copies with error messages')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Copy a sheet/tab within the same spreadsheet. Supports batch copying: create multiple copies from a single source sheet (e.g., create 12 monthly sheets from a template). Copies all data, formatting, charts, and conditional formatting verbatim.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, gid, copies }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.sheet.copy called', {
+        id,
+        gid,
+        copyCount: copies.length
+    });
+    try {
+        var _spreadsheetInfo_data_sheets;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // First, get the source sheet info
+        const spreadsheetInfo = await sheets.spreadsheets.get({
+            spreadsheetId: id,
+            fields: 'sheets.properties.sheetId,sheets.properties.title'
+        });
+        const sourceSheet = (_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 (!(sourceSheet === null || sourceSheet === void 0 ? void 0 : sourceSheet.properties)) {
+            throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid "${gid}" not found in spreadsheet`);
+        }
+        const sourceTitle = sourceSheet.properties.title || '';
+        const sourceSheetId = Number(gid);
+        // Execute copies using Promise.allSettled for partial failure handling
+        const results = await Promise.allSettled(copies.map(async (copy)=>{
+            var _response_data_replies__duplicateSheet_properties, _response_data_replies__duplicateSheet, _response_data_replies_, _response_data_replies, _response_data_replies__duplicateSheet_properties1, _response_data_replies__duplicateSheet1, _response_data_replies_1, _response_data_replies1;
+            const response = await sheets.spreadsheets.batchUpdate({
+                spreadsheetId: id,
+                requestBody: {
+                    requests: [
+                        {
+                            duplicateSheet: {
+                                sourceSheetId,
+                                newSheetName: copy.newTitle,
+                                ...copy.insertIndex !== undefined && {
+                                    insertSheetIndex: copy.insertIndex
+                                }
+                            }
+                        }
+                    ]
+                }
+            });
+            const newSheetId = (_response_data_replies = response.data.replies) === null || _response_data_replies === void 0 ? void 0 : (_response_data_replies_ = _response_data_replies[0]) === null || _response_data_replies_ === void 0 ? void 0 : (_response_data_replies__duplicateSheet = _response_data_replies_.duplicateSheet) === null || _response_data_replies__duplicateSheet === void 0 ? void 0 : (_response_data_replies__duplicateSheet_properties = _response_data_replies__duplicateSheet.properties) === null || _response_data_replies__duplicateSheet_properties === void 0 ? void 0 : _response_data_replies__duplicateSheet_properties.sheetId;
+            const newTitle = (_response_data_replies1 = response.data.replies) === null || _response_data_replies1 === void 0 ? void 0 : (_response_data_replies_1 = _response_data_replies1[0]) === null || _response_data_replies_1 === void 0 ? void 0 : (_response_data_replies__duplicateSheet1 = _response_data_replies_1.duplicateSheet) === null || _response_data_replies__duplicateSheet1 === void 0 ? void 0 : (_response_data_replies__duplicateSheet_properties1 = _response_data_replies__duplicateSheet1.properties) === null || _response_data_replies__duplicateSheet_properties1 === void 0 ? void 0 : _response_data_replies__duplicateSheet_properties1.title;
+            if (!newSheetId || !newTitle) {
+                throw new Error('Failed to retrieve new sheet info from API response');
+            }
+            return {
+                gid: String(newSheetId),
+                title: newTitle,
+                sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${newSheetId}`
+            };
+        }));
+        // Separate successes and failures
+        const items = [];
+        const failures = [];
+        results.forEach((result, index)=>{
+            const copy = copies[index];
+            if (!copy) return;
+            if (result.status === 'fulfilled') {
+                items.push(result.value);
+            } else {
+                const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                failures.push({
+                    title: copy.newTitle,
+                    error: errorMessage
+                });
+            }
+        });
+        const successCount = items.length;
+        const failureCount = failures.length;
+        const totalCount = copies.length;
+        const summary = failureCount === 0 ? `Created ${successCount} cop${successCount === 1 ? 'y' : 'ies'} of "${sourceTitle}"` : `Created ${successCount} of ${totalCount} cop${totalCount === 1 ? 'y' : 'ies'} (${failureCount} failed)`;
+        logger.info('sheets.sheet.copy completed', {
+            totalCount,
+            successCount,
+            failureCount
+        });
+        const result = {
+            type: 'success',
+            operationSummary: summary,
+            itemsProcessed: totalCount,
+            itemsChanged: successCount,
+            completedAt: new Date().toISOString(),
+            id,
+            sourceGid: gid,
+            sourceTitle,
+            items,
+            ...failures.length > 0 && {
+                failures
+            }
+        };
+        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.copy error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error copying sheet: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'sheet-copy',
+        config,
+        handler
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/sheet-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 { SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\nconst MAX_BATCH_SIZE = 100;\n\nconst copyItemSchema = z.object({\n  newTitle: z.coerce.string().trim().min(1).describe('Name for the copied sheet'),\n  insertIndex: z.number().int().min(0).optional().describe('Position to insert the new sheet (0-indexed)'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  copies: z.array(copyItemSchema).min(1).max(MAX_BATCH_SIZE).describe('Array of copies to create from the source sheet'),\n});\n\n// Created sheet info\nconst createdSheetSchema = z.object({\n  gid: SheetGidOutput,\n  title: z.string().describe('Title of the created sheet'),\n  sheetUrl: z.string().describe('URL of the created sheet'),\n});\n\n// Success branch schema - uses items: for consistency with standard vocabulary\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 copies attempted'),\n  itemsChanged: z.number().describe('Successfully created copies'),\n  completedAt: z.string().describe('ISO datetime when operation completed'),\n  id: SpreadsheetIdOutput,\n  sourceGid: z.string().describe('Source sheet ID'),\n  sourceTitle: z.string().describe('Source sheet title'),\n  items: z.array(createdSheetSchema).describe('Information about created sheets'),\n  failures: z\n    .array(\n      z.object({\n        title: z.string(),\n        error: z.string(),\n      })\n    )\n    .optional()\n    .describe('Failed copies with error messages'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy a sheet/tab within the same spreadsheet. Supports batch copying: create multiple copies from a single source sheet (e.g., create 12 monthly sheets from a template). Copies all data, formatting, charts, and conditional formatting verbatim.',\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, copies }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.copy called', { id, gid, copyCount: copies.length });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // First, get the source sheet info\n    const spreadsheetInfo = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sourceSheet = spreadsheetInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sourceSheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid \"${gid}\" not found in spreadsheet`);\n    }\n\n    const sourceTitle = sourceSheet.properties.title || '';\n    const sourceSheetId = Number(gid);\n\n    // Execute copies using Promise.allSettled for partial failure handling\n    const results = await Promise.allSettled(\n      copies.map(async (copy) => {\n        const response = await sheets.spreadsheets.batchUpdate({\n          spreadsheetId: id,\n          requestBody: {\n            requests: [\n              {\n                duplicateSheet: {\n                  sourceSheetId,\n                  newSheetName: copy.newTitle,\n                  ...(copy.insertIndex !== undefined && { insertSheetIndex: copy.insertIndex }),\n                },\n              },\n            ],\n          },\n        });\n\n        const newSheetId = response.data.replies?.[0]?.duplicateSheet?.properties?.sheetId;\n        const newTitle = response.data.replies?.[0]?.duplicateSheet?.properties?.title;\n\n        if (!newSheetId || !newTitle) {\n          throw new Error('Failed to retrieve new sheet info from API response');\n        }\n\n        return {\n          gid: String(newSheetId),\n          title: newTitle,\n          sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${newSheetId}`,\n        };\n      })\n    );\n\n    // Separate successes and failures\n    const items: Array<{ gid: string; title: string; sheetUrl: string }> = [];\n    const failures: Array<{ title: string; error: string }> = [];\n\n    results.forEach((result, index) => {\n      const copy = copies[index];\n      if (!copy) return;\n\n      if (result.status === 'fulfilled') {\n        items.push(result.value);\n      } else {\n        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n        failures.push({ title: copy.newTitle, error: errorMessage });\n      }\n    });\n\n    const successCount = items.length;\n    const failureCount = failures.length;\n    const totalCount = copies.length;\n\n    const summary = failureCount === 0 ? `Created ${successCount} cop${successCount === 1 ? 'y' : 'ies'} of \"${sourceTitle}\"` : `Created ${successCount} of ${totalCount} cop${totalCount === 1 ? 'y' : 'ies'} (${failureCount} failed)`;\n\n    logger.info('sheets.sheet.copy completed', { totalCount, successCount, failureCount });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: summary,\n      itemsProcessed: totalCount,\n      itemsChanged: successCount,\n      completedAt: new Date().toISOString(),\n      id,\n      sourceGid: gid,\n      sourceTitle,\n      items,\n      ...(failures.length > 0 && { failures }),\n    };\n\n    return {\n      content: [{ type: 'text' as const, text: JSON.stringify(result) }],\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.copy error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error copying sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-copy',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","MAX_BATCH_SIZE","copyItemSchema","object","newTitle","coerce","string","trim","min","describe","insertIndex","number","int","optional","inputSchema","id","gid","copies","array","max","createdSheetSchema","title","sheetUrl","successBranchSchema","type","literal","operationSummary","itemsProcessed","itemsChanged","completedAt","sourceGid","sourceTitle","items","failures","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","copyCount","length","spreadsheetInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","sourceSheetId","Number","results","Promise","allSettled","map","copy","response","batchUpdate","requestBody","requests","duplicateSheet","newSheetName","undefined","insertSheetIndex","newSheetId","replies","Error","forEach","index","status","push","value","errorMessage","reason","message","successCount","failureCount","totalCount","summary","Date","toISOString","content","text","JSON","stringify","structuredContent","InternalError","stack","createTool","name"],"mappings":"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"}

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

@@ -0,0 +1,56 @@
+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;
+    sheetTitle: 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;
+    sheetTitle: 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, sheetTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Create a new sheet/tab in the spreadsheet/workbook";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            sheetTitle: 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;
+                sheetTitle: 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-create.js

@@ -0,0 +1,110 @@
+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, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    sheetTitle: z.coerce.string().trim().min(1).describe('Name for the new sheet tab')
+});
+// Success branch schema
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    operationSummary: z.string().describe('Summary of the sheet creation operation'),
+    itemsProcessed: z.number().describe('Total items attempted (always 1 for single sheet)'),
+    itemsChanged: z.number().describe('Successfully created 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 created sheet'),
+    sheetTitle: z.string().describe('Title of the created sheet')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Create a new sheet/tab in the spreadsheet/workbook',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, sheetTitle }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.sheet.create called', {
+        id,
+        sheetTitle
+    });
+    try {
+        var _batchResult_replies__addSheet_properties, _batchResult_replies__addSheet, _batchResult_replies_, _batchResult_replies;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        const response = await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: id,
+            requestBody: {
+                requests: [
+                    {
+                        addSheet: {
+                            properties: {
+                                title: sheetTitle
+                            }
+                        }
+                    }
+                ]
+            }
+        });
+        const batchResult = response.data;
+        const sheetId = (_batchResult_replies = batchResult.replies) === null || _batchResult_replies === void 0 ? void 0 : (_batchResult_replies_ = _batchResult_replies[0]) === null || _batchResult_replies_ === void 0 ? void 0 : (_batchResult_replies__addSheet = _batchResult_replies_.addSheet) === null || _batchResult_replies__addSheet === void 0 ? void 0 : (_batchResult_replies__addSheet_properties = _batchResult_replies__addSheet.properties) === null || _batchResult_replies__addSheet_properties === void 0 ? void 0 : _batchResult_replies__addSheet_properties.sheetId;
+        if (!sheetId) {
+            throw new Error('Failed to retrieve sheetId from Google Sheets API response');
+        }
+        logger.info('sheets.sheet.create success', {
+            id,
+            sheetTitle,
+            sheetId
+        });
+        const result = {
+            type: 'success',
+            operationSummary: `Created sheet "${sheetTitle}"`,
+            itemsProcessed: 1,
+            itemsChanged: 1,
+            completedAt: new Date().toISOString(),
+            id,
+            gid: String(sheetId),
+            sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`,
+            sheetTitle
+        };
+        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.create error', {
+            error: message
+        });
+        // Throw McpError for proper MCP error handling
+        throw new McpError(ErrorCode.InternalError, `Error creating sheet: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'sheet-create',
+        config,
+        handler
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/sheet-create.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, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  sheetTitle: z.coerce.string().trim().min(1).describe('Name for the new 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 sheet creation operation'),\n  itemsProcessed: z.number().describe('Total items attempted (always 1 for single sheet)'),\n  itemsChanged: z.number().describe('Successfully created 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 created sheet'),\n  sheetTitle: z.string().describe('Title of the created sheet'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Create a new sheet/tab in the spreadsheet/workbook',\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, sheetTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.create called', { id, sheetTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ addSheet: { properties: { title: sheetTitle } } }],\n      },\n    });\n    const batchResult = response.data;\n    const sheetId = batchResult.replies?.[0]?.addSheet?.properties?.sheetId;\n    if (!sheetId) {\n      throw new Error('Failed to retrieve sheetId from Google Sheets API response');\n    }\n    logger.info('sheets.sheet.create success', { id, sheetTitle, sheetId });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Created sheet \"${sheetTitle}\"`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      id,\n      gid: String(sheetId),\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetId}`,\n      sheetTitle,\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.sheet.create error', { error: message });\n\n    // Throw McpError for proper MCP error handling\n    throw new McpError(ErrorCode.InternalError, `Error creating sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-create',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidOutput","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","sheetTitle","coerce","string","trim","min","describe","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","gid","sheetUrl","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","batchResult","sheets","version","auth","authContext","response","spreadsheets","batchUpdate","spreadsheetId","requestBody","requests","addSheet","properties","title","data","sheetId","replies","Error","Date","toISOString","String","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

@@ -0,0 +1,62 @@
+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;
+    gids: z.ZodArray<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;
+    recoverable: z.ZodLiteral<false>;
+    id: z.ZodString;
+    spreadsheetUrl: z.ZodOptional<z.ZodString>;
+    failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        gid: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>>>;
+}, 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, gids }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Permanently delete sheets from a spreadsheet. Cannot delete the last remaining sheet.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gids: z.ZodArray<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;
+                recoverable: z.ZodLiteral<false>;
+                id: z.ZodString;
+                spreadsheetUrl: z.ZodOptional<z.ZodString>;
+                failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    gid: z.ZodString;
+                    error: z.ZodString;
+                }, z.core.$strip>>>;
+            }, 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-delete.js

@@ -0,0 +1,125 @@
+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 { SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+const MAX_BATCH_SIZE = 1000;
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    gids: z.array(SheetGidSchema).min(1).max(MAX_BATCH_SIZE).describe('Sheet grid IDs to permanently delete')
+});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    operationSummary: z.string().describe('Human-readable summary of the operation'),
+    itemsProcessed: z.number().describe('Total sheets attempted to delete'),
+    itemsChanged: z.number().describe('Number of sheets successfully deleted'),
+    completedAt: z.string().describe('ISO timestamp when operation completed'),
+    recoverable: z.literal(false).describe('Whether deletion can be undone (always false)'),
+    id: SpreadsheetIdOutput,
+    spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),
+    failures: z.array(z.object({
+        gid: z.string().describe('Grid ID of sheet that failed to delete'),
+        error: z.string().describe('Error message explaining the failure')
+    })).optional().describe('Details of any sheets that failed to delete')
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Permanently delete sheets from a spreadsheet. Cannot delete the last remaining sheet.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, gids }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.sheet.delete called', {
+        id,
+        count: gids.length
+    });
+    try {
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        const results = await Promise.allSettled(gids.map(async (gid)=>{
+            await sheets.spreadsheets.batchUpdate({
+                spreadsheetId: id,
+                requestBody: {
+                    requests: [
+                        {
+                            deleteSheet: {
+                                sheetId: Number(gid)
+                            }
+                        }
+                    ]
+                }
+            });
+            return gid;
+        }));
+        // Separate successes and failures
+        const failures = [];
+        results.forEach((result, index)=>{
+            const gid = gids[index];
+            if (!gid) return;
+            if (result.status === 'rejected') {
+                const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                failures.push({
+                    gid,
+                    error: errorMessage
+                });
+            }
+        });
+        const successCount = gids.length - failures.length;
+        const failureCount = failures.length;
+        const totalCount = gids.length;
+        const summary = failureCount === 0 ? `Permanently deleted ${successCount} sheet${successCount === 1 ? '' : 's'}` : `Deleted ${successCount} of ${totalCount} sheet${totalCount === 1 ? '' : 's'} (${failureCount} failed)`;
+        logger.info('sheets.sheet.delete completed', {
+            totalCount,
+            successCount,
+            failureCount
+        });
+        const result = {
+            type: 'success',
+            operationSummary: summary,
+            itemsProcessed: totalCount,
+            itemsChanged: successCount,
+            completedAt: new Date().toISOString(),
+            recoverable: false,
+            id,
+            spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,
+            ...failures.length > 0 && {
+                failures
+            }
+        };
+        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.delete error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error deleting sheet: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'sheet-delete',
+        config,
+        handler
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/sheet-delete.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 { SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\nconst MAX_BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gids: z.array(SheetGidSchema).min(1).max(MAX_BATCH_SIZE).describe('Sheet grid IDs to permanently delete'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  operationSummary: z.string().describe('Human-readable summary of the operation'),\n  itemsProcessed: z.number().describe('Total sheets attempted to delete'),\n  itemsChanged: z.number().describe('Number of sheets successfully deleted'),\n  completedAt: z.string().describe('ISO timestamp when operation completed'),\n  recoverable: z.literal(false).describe('Whether deletion can be undone (always false)'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().optional().describe('URL to view the spreadsheet'),\n  failures: z\n    .array(\n      z.object({\n        gid: z.string().describe('Grid ID of sheet that failed to delete'),\n        error: z.string().describe('Error message explaining the failure'),\n      })\n    )\n    .optional()\n    .describe('Details of any sheets that failed to delete'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Permanently delete sheets from a spreadsheet. Cannot delete the last remaining sheet.',\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, gids }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.delete called', { id, count: gids.length });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    const results = await Promise.allSettled(\n      gids.map(async (gid) => {\n        await sheets.spreadsheets.batchUpdate({\n          spreadsheetId: id,\n          requestBody: {\n            requests: [{ deleteSheet: { sheetId: Number(gid) } }],\n          },\n        });\n        return gid;\n      })\n    );\n\n    // Separate successes and failures\n    const failures: Array<{ gid: string; error: string }> = [];\n\n    results.forEach((result, index) => {\n      const gid = gids[index];\n      if (!gid) return;\n\n      if (result.status === 'rejected') {\n        const errorMessage = result.reason instanceof Error ? result.reason.message : String(result.reason);\n        failures.push({ gid, error: errorMessage });\n      }\n    });\n\n    const successCount = gids.length - failures.length;\n    const failureCount = failures.length;\n    const totalCount = gids.length;\n\n    const summary = failureCount === 0 ? `Permanently deleted ${successCount} sheet${successCount === 1 ? '' : 's'}` : `Deleted ${successCount} of ${totalCount} sheet${totalCount === 1 ? '' : 's'} (${failureCount} failed)`;\n\n    logger.info('sheets.sheet.delete completed', {\n      totalCount,\n      successCount,\n      failureCount,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: summary,\n      itemsProcessed: totalCount,\n      itemsChanged: successCount,\n      completedAt: new Date().toISOString(),\n      recoverable: false as const,\n      id,\n      spreadsheetUrl: `https://docs.google.com/spreadsheets/d/${id}`,\n      ...(failures.length > 0 && { failures }),\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.delete error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error deleting sheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-delete',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","MAX_BATCH_SIZE","inputSchema","object","id","gids","array","min","max","describe","successBranchSchema","type","literal","operationSummary","string","itemsProcessed","number","itemsChanged","completedAt","recoverable","spreadsheetUrl","optional","failures","gid","error","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","count","length","sheets","version","auth","authContext","results","Promise","allSettled","map","spreadsheets","batchUpdate","spreadsheetId","requestBody","requests","deleteSheet","sheetId","Number","forEach","index","status","errorMessage","reason","Error","message","String","push","successCount","failureCount","totalCount","summary","Date","toISOString","content","text","JSON","stringify","structuredContent","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

@@ -0,0 +1,48 @@
+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;
+    sheetRef: z.ZodString;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    title: z.ZodString;
+    sheetUrl: z.ZodOptional<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, sheetRef }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Find an existing sheet/tab within a known spreadsheet by title or GUID";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            sheetRef: z.ZodString;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                title: z.ZodString;
+                sheetUrl: z.ZodOptional<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 {};