@mcp-z/mcp-sheets 1.0.0

package/dist/esm/mcp/tools/rows-get.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;
+    gid: z.ZodCoercedString<unknown>;
+    range: z.ZodString;
+    render: z.ZodOptional<z.ZodEnum<{
+        FORMATTED_VALUE: "FORMATTED_VALUE";
+        UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
+        FORMULA: "FORMULA";
+    }>>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    range: z.ZodString;
+    rows: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>>;
+}, 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, range, render }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            range: z.ZodString;
+            render: z.ZodOptional<z.ZodEnum<{
+                FORMATTED_VALUE: "FORMATTED_VALUE";
+                UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
+                FORMULA: "FORMULA";
+            }>>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                range: z.ZodString;
+                rows: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>>;
+            }, 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/rows-get.js

@@ -0,0 +1,116 @@
+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 { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    gid: SheetGidSchema,
+    range: z.string().min(1).describe('A1 notation range to fetch (e.g., "B5", "A5:D5", "B:B", "5:5")'),
+    render: z.enum([
+        'FORMATTED_VALUE',
+        'UNFORMATTED_VALUE',
+        'FORMULA'
+    ]).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.')
+});
+// Success branch schema - uses rows: for consistency with standard vocabulary
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    range: z.string().describe('The A1 notation range that was retrieved'),
+    rows: z.array(z.array(SheetCellSchema)).describe('2D array of row data (each inner array is a row)')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, gid, range, render }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.rows.get called', {
+        id,
+        gid,
+        range,
+        render
+    });
+    try {
+        var _ref;
+        var _spreadsheetResponse_data_sheets, _sheet_properties;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // Get sheet details using the gid to get sheet title
+        const spreadsheetResponse = await sheets.spreadsheets.get({
+            spreadsheetId: id,
+            fields: 'sheets.properties.sheetId,sheets.properties.title'
+        });
+        const sheet = (_spreadsheetResponse_data_sheets = spreadsheetResponse.data.sheets) === null || _spreadsheetResponse_data_sheets === void 0 ? void 0 : _spreadsheetResponse_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 (!sheet) {
+            logger.info('sheets.rows.get sheet not found', {
+                id,
+                gid,
+                range
+            });
+            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+        }
+        const sheetTitle = (_ref = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.title) !== null && _ref !== void 0 ? _ref : '';
+        // Construct full range with sheet title
+        const fullRange = `${sheetTitle}!${range}`;
+        const response = await sheets.spreadsheets.values.get({
+            spreadsheetId: id,
+            range: fullRange,
+            valueRenderOption: render || 'FORMATTED_VALUE'
+        });
+        const res = response.data;
+        const rows = Array.isArray(res.values) ? res.values : [];
+        logger.info('sheets.rows.get success', {
+            id,
+            gid,
+            range,
+            rowCount: rows.length
+        });
+        const result = {
+            type: 'success',
+            range: res.range || fullRange,
+            rows
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('sheets.rows.get error', {
+            error: message
+        });
+        // Throw McpError for proper MCP error handling
+        throw new McpError(ErrorCode.InternalError, `Error getting rows: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'rows-get',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/rows-get.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/rows-get.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 { SheetCellSchema, SheetGidSchema, SpreadsheetIdSchema } from '../../schemas/index.js';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  range: z.string().min(1).describe('A1 notation range to fetch (e.g., \"B5\", \"A5:D5\", \"B:B\", \"5:5\")'),\n  render: z.enum(['FORMATTED_VALUE', 'UNFORMATTED_VALUE', 'FORMULA']).optional().describe('How to render cell values. FORMATTED_VALUE (default): calculated with formatting. UNFORMATTED_VALUE: calculated without formatting. FORMULA: show formula text instead of result.'),\n});\n\n// Success branch schema - uses rows: for consistency with standard vocabulary\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  range: z.string().describe('The A1 notation range that was retrieved'),\n  rows: z.array(z.array(SheetCellSchema)).describe('2D array of row data (each inner array is a row)'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Fetch row data from a specific range in A1 notation. Best used after values-search to get surrounding context. Use a1-notation prompt for syntax reference.',\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, range, render }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.rows.get called', { id, gid, range, render });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get sheet details using the gid to get sheet title\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sheet = spreadsheetResponse.data.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n\n    if (!sheet) {\n      logger.info('sheets.rows.get sheet not found', { id, gid, range });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties?.title ?? '';\n\n    // Construct full range with sheet title\n    const fullRange = `${sheetTitle}!${range}`;\n\n    const response = await sheets.spreadsheets.values.get({\n      spreadsheetId: id,\n      range: fullRange,\n      valueRenderOption: render || 'FORMATTED_VALUE',\n    });\n\n    const res = response.data;\n    const rows = Array.isArray(res.values) ? (res.values as (string | number | boolean | null)[][]) : [];\n\n    logger.info('sheets.rows.get success', { id, gid, range, rowCount: rows.length });\n\n    const result: Output = {\n      type: 'success' as const,\n      range: res.range || fullRange,\n      rows,\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.rows.get error', { error: message });\n\n    // Throw McpError for proper MCP error handling\n    throw new McpError(ErrorCode.InternalError, `Error getting rows: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'rows-get',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetCellSchema","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","id","gid","range","string","min","describe","render","enum","optional","successBranchSchema","type","literal","rows","array","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","spreadsheetResponse","sheet","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","sheetTitle","title","fullRange","response","values","valueRenderOption","res","Array","isArray","rowCount","length","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/sheet-copy-to.d.ts

@@ -0,0 +1,68 @@
+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<{
+    sourceId: z.ZodString;
+    sourceGid: z.ZodCoercedString<unknown>;
+    destinationId: 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;
+    sourceGid: z.ZodString;
+    sourceTitle: z.ZodString;
+    destinationId: z.ZodString;
+    destinationGid: z.ZodString;
+    destinationTitle: z.ZodString;
+    sheetUrl: z.ZodString;
+    renamed: z.ZodBoolean;
+}, 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({ sourceId, sourceGid, destinationId, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Copy a sheet to another spreadsheet. Copies all data, formatting, and charts.";
+        readonly inputSchema: z.ZodObject<{
+            sourceId: z.ZodString;
+            sourceGid: z.ZodCoercedString<unknown>;
+            destinationId: 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;
+                sourceGid: z.ZodString;
+                sourceTitle: z.ZodString;
+                destinationId: z.ZodString;
+                destinationGid: z.ZodString;
+                destinationTitle: z.ZodString;
+                sheetUrl: z.ZodString;
+                renamed: z.ZodBoolean;
+            }, 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-copy-to.js

@@ -0,0 +1,156 @@
+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, SpreadsheetIdSchema } from '../../schemas/index.js';
+// Note: Using contextual descriptions for source/destination IDs since they describe different spreadsheets/sheets
+const inputSchema = z.object({
+    sourceId: SpreadsheetIdSchema.describe('Source spreadsheet ID'),
+    sourceGid: SheetGidSchema.describe('Source sheet grid ID to copy'),
+    destinationId: SpreadsheetIdSchema.describe('Destination spreadsheet ID'),
+    newTitle: z.coerce.string().trim().min(1).optional().describe('New name for the copied sheet (optional, will use auto-generated name if not provided)')
+});
+// 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'),
+    sourceGid: z.string().describe('Source sheet ID'),
+    sourceTitle: z.string().describe('Source sheet title'),
+    destinationId: z.string().describe('Destination spreadsheet ID'),
+    destinationGid: z.string().describe('Copied sheet ID in destination'),
+    destinationTitle: z.string().describe('Title of the copied sheet in destination'),
+    sheetUrl: z.string().describe('URL of the copied sheet'),
+    renamed: z.boolean().describe('Whether the sheet was renamed after copying')
+});
+// Output schema with auth_required support
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Copy a sheet to another spreadsheet. Copies all data, formatting, and charts.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ sourceId, sourceGid, destinationId, newTitle }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.sheet.copyTo called', {
+        sourceId,
+        sourceGid,
+        destinationId,
+        newTitle
+    });
+    try {
+        var _sourceInfo_data_sheets;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // Get source sheet info
+        const sourceInfo = await sheets.spreadsheets.get({
+            spreadsheetId: sourceId,
+            fields: 'sheets.properties.sheetId,sheets.properties.title'
+        });
+        const sourceSheet = (_sourceInfo_data_sheets = sourceInfo.data.sheets) === null || _sourceInfo_data_sheets === void 0 ? void 0 : _sourceInfo_data_sheets.find((s)=>{
+            var _s_properties;
+            return String((_s_properties = s.properties) === null || _s_properties === void 0 ? void 0 : _s_properties.sheetId) === sourceGid;
+        });
+        if (!(sourceSheet === null || sourceSheet === void 0 ? void 0 : sourceSheet.properties)) {
+            throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid "${sourceGid}" not found in spreadsheet`);
+        }
+        const sourceTitle = sourceSheet.properties.title || '';
+        // Copy the sheet to the destination spreadsheet
+        const copyResponse = await sheets.spreadsheets.sheets.copyTo({
+            spreadsheetId: sourceId,
+            sheetId: Number(sourceGid),
+            requestBody: {
+                destinationSpreadsheetId: destinationId
+            }
+        });
+        const newSheetId = copyResponse.data.sheetId;
+        let destinationTitle = copyResponse.data.title || '';
+        if (!newSheetId) {
+            throw new Error('Failed to retrieve new sheet ID from API response');
+        }
+        // If newTitle is provided, rename the sheet in the destination
+        let renamed = false;
+        if (newTitle && newTitle !== destinationTitle) {
+            await sheets.spreadsheets.batchUpdate({
+                spreadsheetId: destinationId,
+                requestBody: {
+                    requests: [
+                        {
+                            updateSheetProperties: {
+                                properties: {
+                                    sheetId: newSheetId,
+                                    title: newTitle
+                                },
+                                fields: 'title'
+                            }
+                        }
+                    ]
+                }
+            });
+            destinationTitle = newTitle;
+            renamed = true;
+        }
+        logger.info('sheets.sheet.copyTo success', {
+            sourceId,
+            sourceGid,
+            destinationId,
+            destinationGid: String(newSheetId),
+            renamed
+        });
+        const result = {
+            type: 'success',
+            operationSummary: `Copied sheet "${sourceTitle}" to destination${renamed ? ` as "${destinationTitle}"` : ''}`,
+            itemsProcessed: 1,
+            itemsChanged: 1,
+            completedAt: new Date().toISOString(),
+            sourceId,
+            sourceGid,
+            sourceTitle,
+            destinationId,
+            destinationGid: String(newSheetId),
+            destinationTitle,
+            sheetUrl: `https://docs.google.com/spreadsheets/d/${destinationId}/edit#gid=${newSheetId}`,
+            renamed
+        };
+        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.copyTo error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'sheet-copy-to',
+        config,
+        handler
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/sheet-copy-to.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, SpreadsheetIdSchema } from '../../schemas/index.js';\n\n// Note: Using contextual descriptions for source/destination IDs since they describe different spreadsheets/sheets\n\nconst inputSchema = z.object({\n  sourceId: SpreadsheetIdSchema.describe('Source spreadsheet ID'),\n  sourceGid: SheetGidSchema.describe('Source sheet grid ID to copy'),\n  destinationId: SpreadsheetIdSchema.describe('Destination spreadsheet ID'),\n  newTitle: z.coerce.string().trim().min(1).optional().describe('New name for the copied sheet (optional, will use auto-generated name if not provided)'),\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  sourceGid: z.string().describe('Source sheet ID'),\n  sourceTitle: z.string().describe('Source sheet title'),\n  destinationId: z.string().describe('Destination spreadsheet ID'),\n  destinationGid: z.string().describe('Copied sheet ID in destination'),\n  destinationTitle: z.string().describe('Title of the copied sheet in destination'),\n  sheetUrl: z.string().describe('URL of the copied sheet'),\n  renamed: z.boolean().describe('Whether the sheet was renamed after copying'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Copy a sheet to another spreadsheet. Copies all data, formatting, and charts.',\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({ sourceId, sourceGid, destinationId, newTitle }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.sheet.copyTo called', { sourceId, sourceGid, destinationId, newTitle });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get source sheet info\n    const sourceInfo = await sheets.spreadsheets.get({\n      spreadsheetId: sourceId,\n      fields: 'sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const sourceSheet = sourceInfo.data.sheets?.find((s) => String(s.properties?.sheetId) === sourceGid);\n    if (!sourceSheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Source sheet with gid \"${sourceGid}\" not found in spreadsheet`);\n    }\n\n    const sourceTitle = sourceSheet.properties.title || '';\n\n    // Copy the sheet to the destination spreadsheet\n    const copyResponse = await sheets.spreadsheets.sheets.copyTo({\n      spreadsheetId: sourceId,\n      sheetId: Number(sourceGid),\n      requestBody: {\n        destinationSpreadsheetId: destinationId,\n      },\n    });\n\n    const newSheetId = copyResponse.data.sheetId;\n    let destinationTitle = copyResponse.data.title || '';\n\n    if (!newSheetId) {\n      throw new Error('Failed to retrieve new sheet ID from API response');\n    }\n\n    // If newTitle is provided, rename the sheet in the destination\n    let renamed = false;\n    if (newTitle && newTitle !== destinationTitle) {\n      await sheets.spreadsheets.batchUpdate({\n        spreadsheetId: destinationId,\n        requestBody: {\n          requests: [\n            {\n              updateSheetProperties: {\n                properties: { sheetId: newSheetId, title: newTitle },\n                fields: 'title',\n              },\n            },\n          ],\n        },\n      });\n      destinationTitle = newTitle;\n      renamed = true;\n    }\n\n    logger.info('sheets.sheet.copyTo success', {\n      sourceId,\n      sourceGid,\n      destinationId,\n      destinationGid: String(newSheetId),\n      renamed,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      operationSummary: `Copied sheet \"${sourceTitle}\" to destination${renamed ? ` as \"${destinationTitle}\"` : ''}`,\n      itemsProcessed: 1,\n      itemsChanged: 1,\n      completedAt: new Date().toISOString(),\n      sourceId,\n      sourceGid,\n      sourceTitle,\n      destinationId,\n      destinationGid: String(newSheetId),\n      destinationTitle,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${destinationId}/edit#gid=${newSheetId}`,\n      renamed,\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.copyTo error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error copying sheet to another spreadsheet: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'sheet-copy-to',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","SheetGidSchema","SpreadsheetIdSchema","inputSchema","object","sourceId","describe","sourceGid","destinationId","newTitle","coerce","string","trim","min","optional","successBranchSchema","type","literal","operationSummary","itemsProcessed","number","itemsChanged","completedAt","sourceTitle","destinationGid","destinationTitle","sheetUrl","renamed","boolean","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sourceInfo","sheets","version","auth","authContext","spreadsheets","get","spreadsheetId","fields","sourceSheet","data","find","s","String","properties","sheetId","InvalidParams","title","copyResponse","copyTo","Number","requestBody","destinationSpreadsheetId","newSheetId","Error","batchUpdate","requests","updateSheetProperties","Date","toISOString","content","text","JSON","stringify","structuredContent","error","message","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

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

@@ -0,0 +1,80 @@
+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>;
+    copies: z.ZodArray<z.ZodObject<{
+        newTitle: z.ZodCoercedString<unknown>;
+        insertIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, 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;
+    sourceGid: z.ZodString;
+    sourceTitle: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        gid: z.ZodString;
+        title: z.ZodString;
+        sheetUrl: z.ZodString;
+    }, z.core.$strip>>;
+    failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: 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, gid, copies }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly 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.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            copies: z.ZodArray<z.ZodObject<{
+                newTitle: z.ZodCoercedString<unknown>;
+                insertIndex: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, 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;
+                sourceGid: z.ZodString;
+                sourceTitle: z.ZodString;
+                items: z.ZodArray<z.ZodObject<{
+                    gid: z.ZodString;
+                    title: z.ZodString;
+                    sheetUrl: z.ZodString;
+                }, z.core.$strip>>;
+                failures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    title: 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 {};