@mcp-z/mcp-sheets 1.0.0

package/dist/esm/mcp/tools/values-batch-update.js

@@ -0,0 +1,224 @@
+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 { A1NotationSchema, SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+// Input schema for values batch update requests
+const ValuesBatchUpdateRequestSchema = z.object({
+    range: A1NotationSchema.describe('A1 notation range defining the bounded target area. Data dimensions must match range dimensions. Example: D1:D100 requires exactly 100 rows of data. Use open-ended ranges like D1:D to write any number of rows.'),
+    values: z.array(z.array(SheetCellSchema)).min(1).describe('2D array of values. Row count must match range height, column count must match range width. Use null to skip a cell (preserve existing value), empty string "" to clear it.'),
+    majorDimension: z.enum([
+        'ROWS',
+        'COLUMNS'
+    ]).describe('Whether values represent rows or columns')
+});
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    gid: SheetGidSchema,
+    requests: z.array(ValuesBatchUpdateRequestSchema).min(1).describe('Array of value update requests'),
+    valueInputOption: z.enum([
+        'RAW',
+        'USER_ENTERED'
+    ]).describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input)'),
+    includeData: z.boolean().describe('Whether to include updated cell values in the response')
+});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    id: SpreadsheetIdOutput,
+    gid: SheetGidOutput,
+    spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),
+    spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),
+    sheetTitle: z.string().describe('Title of the updated sheet'),
+    sheetUrl: z.string().describe('URL of the updated sheet'),
+    totalUpdatedRows: z.number().int().nonnegative().describe('Total number of rows updated across all requests'),
+    totalUpdatedColumns: z.number().int().nonnegative().describe('Total number of columns updated across all requests'),
+    totalUpdatedCells: z.number().int().nonnegative().describe('Total number of cells updated across all requests'),
+    updatedRanges: z.array(z.string()).describe('A1 notation ranges that were updated'),
+    updatedData: z.array(z.object({
+        range: z.string().describe('A1 notation range that was updated'),
+        majorDimension: z.enum([
+            'ROWS',
+            'COLUMNS'
+        ]).describe('Dimension of the updated data'),
+        values: z.array(z.array(SheetCellSchema)).optional().describe('Updated values (if includeData was true)')
+    })).optional().describe('Detailed information about updated data (if includeData was true)')
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Batch update multiple cell ranges. RAW=exact values, USER_ENTERED=parsed like user input. Use a1-notation prompt for range syntax.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, gid, requests, valueInputOption = 'USER_ENTERED', includeData = false }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.values.batchUpdate called', {
+        id,
+        gid,
+        requestCount: requests.length,
+        valueInputOption,
+        includeData
+    });
+    try {
+        var _ref, _spreadsheetData_spreadsheetUrl, _sheet_properties_title, _sheet_properties_sheetId;
+        var _spreadsheetData_properties, _spreadsheetData_sheets;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // Get spreadsheet and sheet info in single API call
+        const spreadsheetResponse = await sheets.spreadsheets.get({
+            spreadsheetId: id,
+            fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title'
+        });
+        const spreadsheetData = spreadsheetResponse.data;
+        const spreadsheetTitle = (_ref = (_spreadsheetData_properties = spreadsheetData.properties) === null || _spreadsheetData_properties === void 0 ? void 0 : _spreadsheetData_properties.title) !== null && _ref !== void 0 ? _ref : '';
+        const spreadsheetUrl = (_spreadsheetData_spreadsheetUrl = spreadsheetData.spreadsheetUrl) !== null && _spreadsheetData_spreadsheetUrl !== void 0 ? _spreadsheetData_spreadsheetUrl : '';
+        // Find sheet by gid
+        const sheet = (_spreadsheetData_sheets = spreadsheetData.sheets) === null || _spreadsheetData_sheets === void 0 ? void 0 : _spreadsheetData_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 === null || sheet === void 0 ? void 0 : sheet.properties)) {
+            logger.info('Sheet not found for batch update', {
+                id,
+                gid,
+                requestCount: requests.length
+            });
+            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+        }
+        const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
+        const sheetGid = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
+        const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;
+        // Build batch update request with prefixed ranges
+        const batchUpdateData = requests.map((req)=>({
+                range: `${sheetTitle}!${req.range}`,
+                values: req.values,
+                majorDimension: req.majorDimension || 'ROWS'
+            }));
+        logger.info('sheets.values.batchUpdate executing batch request', {
+            spreadsheetId: id,
+            sheetTitle,
+            batchUpdateDataCount: batchUpdateData.length
+        });
+        // Execute the batch update
+        const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({
+            spreadsheetId: id,
+            requestBody: {
+                valueInputOption,
+                data: batchUpdateData,
+                includeValuesInResponse: includeData,
+                responseDateTimeRenderOption: 'FORMATTED_STRING',
+                responseValueRenderOption: 'FORMATTED_VALUE'
+            }
+        });
+        const updateResult = batchUpdateResponse.data;
+        // Validate batch operation results and detect partial failures
+        const responses = updateResult.responses || [];
+        const expectedCount = requests.length;
+        const actualCount = responses.length;
+        if (actualCount !== expectedCount) {
+            logger.error('Partial batch failure detected', {
+                expectedOperations: expectedCount,
+                completedOperations: actualCount,
+                spreadsheetId: id,
+                sheetTitle
+            });
+            throw new McpError(ErrorCode.InternalError, `Batch operation partially failed: ${actualCount}/${expectedCount} operations completed`);
+        }
+        // Check for any failed operations (empty or null responses)
+        const failedOperations = responses.filter((response, index)=>{
+            if (!response || !response.updatedRange) {
+                var _requests_index;
+                logger.error('Failed operation detected', {
+                    operationIndex: index,
+                    requestedRange: (_requests_index = requests[index]) === null || _requests_index === void 0 ? void 0 : _requests_index.range,
+                    spreadsheetId: id,
+                    sheetTitle
+                });
+                return true;
+            }
+            return false;
+        });
+        if (failedOperations.length > 0) {
+            throw new McpError(ErrorCode.InternalError, `${failedOperations.length} operations failed to update ranges`);
+        }
+        // Extract updated ranges and calculate totals
+        const updatedRanges = responses.map((response)=>response.updatedRange || '').filter((range)=>range);
+        const totalUpdatedRows = updateResult.totalUpdatedRows || 0;
+        const totalUpdatedColumns = updateResult.totalUpdatedColumns || 0;
+        const totalUpdatedCells = updateResult.totalUpdatedCells || 0;
+        // Build updated data response if requested
+        let updatedData;
+        if (includeData && updateResult.responses) {
+            updatedData = updateResult.responses.filter((response)=>response.updatedData).map((response)=>{
+                var _response_updatedData, _response_updatedData1;
+                const item = {
+                    range: response.updatedRange || '',
+                    majorDimension: ((_response_updatedData = response.updatedData) === null || _response_updatedData === void 0 ? void 0 : _response_updatedData.majorDimension) || 'ROWS'
+                };
+                const values = (_response_updatedData1 = response.updatedData) === null || _response_updatedData1 === void 0 ? void 0 : _response_updatedData1.values;
+                if (values !== undefined) {
+                    // Map undefined values to null for JSON Schema compatibility
+                    item.values = values.map((row)=>row.map((cell)=>cell === undefined ? null : cell));
+                }
+                return item;
+            });
+        }
+        logger.info('sheets.values.batchUpdate completed successfully', {
+            totalUpdatedRows,
+            totalUpdatedColumns,
+            totalUpdatedCells,
+            updatedRangesCount: updatedRanges.length
+        });
+        const result = {
+            type: 'success',
+            id,
+            gid: String(sheetGid),
+            spreadsheetTitle: spreadsheetTitle || '',
+            spreadsheetUrl: spreadsheetUrl || '',
+            sheetTitle,
+            sheetUrl,
+            totalUpdatedRows,
+            totalUpdatedColumns,
+            totalUpdatedCells,
+            updatedRanges,
+            updatedData
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('Batch update operation failed', {
+            id,
+            gid,
+            requestCount: requests.length,
+            valueInputOption,
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error batch updating values: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'values-batch-update',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/values-batch-update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/values-batch-update.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 { A1NotationSchema, SheetCellSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\n// Types for updated data response\ninterface UpdatedDataItem {\n  range: string;\n  majorDimension: 'ROWS' | 'COLUMNS';\n  values?: (string | number | boolean | null)[][];\n}\n\n// Input schema for values batch update requests\nconst ValuesBatchUpdateRequestSchema = z.object({\n  range: A1NotationSchema.describe('A1 notation range defining the bounded target area. Data dimensions must match range dimensions. Example: D1:D100 requires exactly 100 rows of data. Use open-ended ranges like D1:D to write any number of rows.'),\n  values: z.array(z.array(SheetCellSchema)).min(1).describe('2D array of values. Row count must match range height, column count must match range width. Use null to skip a cell (preserve existing value), empty string \"\" to clear it.'),\n  majorDimension: z.enum(['ROWS', 'COLUMNS']).describe('Whether values represent rows or columns'),\n});\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  requests: z.array(ValuesBatchUpdateRequestSchema).min(1).describe('Array of value update requests'),\n  valueInputOption: z.enum(['RAW', 'USER_ENTERED']).describe('How input data should be interpreted (RAW = exact values, USER_ENTERED = parsed like user input)'),\n  includeData: z.boolean().describe('Whether to include updated cell values in the response'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the updated spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the updated spreadsheet'),\n  sheetTitle: z.string().describe('Title of the updated sheet'),\n  sheetUrl: z.string().describe('URL of the updated sheet'),\n  totalUpdatedRows: z.number().int().nonnegative().describe('Total number of rows updated across all requests'),\n  totalUpdatedColumns: z.number().int().nonnegative().describe('Total number of columns updated across all requests'),\n  totalUpdatedCells: z.number().int().nonnegative().describe('Total number of cells updated across all requests'),\n  updatedRanges: z.array(z.string()).describe('A1 notation ranges that were updated'),\n  updatedData: z\n    .array(\n      z.object({\n        range: z.string().describe('A1 notation range that was updated'),\n        majorDimension: z.enum(['ROWS', 'COLUMNS']).describe('Dimension of the updated data'),\n        values: z.array(z.array(SheetCellSchema)).optional().describe('Updated values (if includeData was true)'),\n      })\n    )\n    .optional()\n    .describe('Detailed information about updated data (if includeData was true)'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Batch update multiple cell ranges. RAW=exact values, USER_ENTERED=parsed like user input. Use a1-notation prompt for range syntax.',\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, requests, valueInputOption = 'USER_ENTERED', includeData = false }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.batchUpdate called', {\n    id,\n    gid,\n    requestCount: requests.length,\n    valueInputOption,\n    includeData,\n  });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for batch update', { id, gid, requestCount: requests.length });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    // Build batch update request with prefixed ranges\n    const batchUpdateData = requests.map((req) => ({\n      range: `${sheetTitle}!${req.range}`,\n      values: req.values,\n      majorDimension: req.majorDimension || 'ROWS',\n    }));\n\n    logger.info('sheets.values.batchUpdate executing batch request', {\n      spreadsheetId: id,\n      sheetTitle,\n      batchUpdateDataCount: batchUpdateData.length,\n    });\n\n    // Execute the batch update\n    const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        valueInputOption,\n        data: batchUpdateData,\n        includeValuesInResponse: includeData,\n        responseDateTimeRenderOption: 'FORMATTED_STRING',\n        responseValueRenderOption: 'FORMATTED_VALUE',\n      },\n    });\n\n    const updateResult = batchUpdateResponse.data;\n\n    // Validate batch operation results and detect partial failures\n    const responses = updateResult.responses || [];\n    const expectedCount = requests.length;\n    const actualCount = responses.length;\n\n    if (actualCount !== expectedCount) {\n      logger.error('Partial batch failure detected', {\n        expectedOperations: expectedCount,\n        completedOperations: actualCount,\n        spreadsheetId: id,\n        sheetTitle,\n      });\n\n      throw new McpError(ErrorCode.InternalError, `Batch operation partially failed: ${actualCount}/${expectedCount} operations completed`);\n    }\n\n    // Check for any failed operations (empty or null responses)\n    const failedOperations = responses.filter((response, index) => {\n      if (!response || !response.updatedRange) {\n        logger.error('Failed operation detected', {\n          operationIndex: index,\n          requestedRange: requests[index]?.range,\n          spreadsheetId: id,\n          sheetTitle,\n        });\n        return true;\n      }\n      return false;\n    });\n\n    if (failedOperations.length > 0) {\n      throw new McpError(ErrorCode.InternalError, `${failedOperations.length} operations failed to update ranges`);\n    }\n\n    // Extract updated ranges and calculate totals\n    const updatedRanges = responses.map((response) => response.updatedRange || '').filter((range) => range);\n    const totalUpdatedRows = updateResult.totalUpdatedRows || 0;\n    const totalUpdatedColumns = updateResult.totalUpdatedColumns || 0;\n    const totalUpdatedCells = updateResult.totalUpdatedCells || 0;\n\n    // Build updated data response if requested\n    let updatedData: UpdatedDataItem[] | undefined;\n    if (includeData && updateResult.responses) {\n      updatedData = updateResult.responses\n        .filter((response) => response.updatedData)\n        .map((response) => {\n          const item: UpdatedDataItem = {\n            range: response.updatedRange || '',\n            majorDimension: (response.updatedData?.majorDimension as 'ROWS' | 'COLUMNS' | undefined) || 'ROWS',\n          };\n          const values = response.updatedData?.values as (string | number | boolean | null | undefined)[][] | undefined;\n          if (values !== undefined) {\n            // Map undefined values to null for JSON Schema compatibility\n            item.values = values.map((row) => row.map((cell) => (cell === undefined ? null : cell)));\n          }\n          return item;\n        });\n    }\n\n    logger.info('sheets.values.batchUpdate completed successfully', {\n      totalUpdatedRows,\n      totalUpdatedColumns,\n      totalUpdatedCells,\n      updatedRangesCount: updatedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      totalUpdatedRows,\n      totalUpdatedColumns,\n      totalUpdatedCells,\n      updatedRanges,\n      updatedData,\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('Batch update operation failed', {\n      id,\n      gid,\n      requestCount: requests.length,\n      valueInputOption,\n      error: message,\n    });\n\n    throw new McpError(ErrorCode.InternalError, `Error batch updating values: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-batch-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetCellSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","ValuesBatchUpdateRequestSchema","object","range","describe","values","array","min","majorDimension","enum","inputSchema","id","gid","requests","valueInputOption","includeData","boolean","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","totalUpdatedRows","number","int","nonnegative","totalUpdatedColumns","totalUpdatedCells","updatedRanges","updatedData","optional","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","requestCount","length","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","InvalidParams","sheetGid","batchUpdateData","map","req","batchUpdateDataCount","batchUpdateResponse","batchUpdate","requestBody","includeValuesInResponse","responseDateTimeRenderOption","responseValueRenderOption","updateResult","responses","expectedCount","actualCount","error","expectedOperations","completedOperations","InternalError","failedOperations","filter","response","index","updatedRange","operationIndex","requestedRange","item","undefined","row","cell","updatedRangesCount","content","text","JSON","stringify","structuredContent","message","Error","stack","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/values-clear.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>;
+    ranges: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    spreadsheetTitle: z.ZodString;
+    spreadsheetUrl: z.ZodString;
+    sheetTitle: z.ZodString;
+    sheetUrl: z.ZodString;
+    clearedRanges: z.ZodArray<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, ranges }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Clear cell values from one or more ranges. Clears values only - preserves formatting, validation, and other cell properties. Use a1-notation prompt for range syntax.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            ranges: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                spreadsheetTitle: z.ZodString;
+                spreadsheetUrl: z.ZodString;
+                sheetTitle: z.ZodString;
+                sheetUrl: z.ZodString;
+                clearedRanges: z.ZodArray<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/values-clear.js

@@ -0,0 +1,131 @@
+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 { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    gid: SheetGidSchema,
+    ranges: z.array(A1NotationSchema).min(1).describe('A1 notation ranges to clear (e.g., ["A1:B5", "D3:D10"]). Clears values only, preserves formatting.')
+});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    id: SpreadsheetIdOutput,
+    gid: SheetGidOutput,
+    spreadsheetTitle: z.string().describe('Title of the spreadsheet'),
+    spreadsheetUrl: z.string().describe('URL of the spreadsheet'),
+    sheetTitle: z.string().describe('Title of the sheet'),
+    sheetUrl: z.string().describe('URL of the sheet'),
+    clearedRanges: z.array(z.string()).describe('A1 notation ranges that were cleared')
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Clear cell values from one or more ranges. Clears values only - preserves formatting, validation, and other cell properties. Use a1-notation prompt for range syntax.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, gid, ranges }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.values.clear called', {
+        id,
+        gid,
+        rangeCount: ranges.length
+    });
+    try {
+        var _ref, _spreadsheetData_spreadsheetUrl, _sheet_properties_title, _sheet_properties_sheetId;
+        var _spreadsheetData_properties, _spreadsheetData_sheets;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // Get spreadsheet and sheet info in single API call
+        const spreadsheetResponse = await sheets.spreadsheets.get({
+            spreadsheetId: id,
+            fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title'
+        });
+        const spreadsheetData = spreadsheetResponse.data;
+        const spreadsheetTitle = (_ref = (_spreadsheetData_properties = spreadsheetData.properties) === null || _spreadsheetData_properties === void 0 ? void 0 : _spreadsheetData_properties.title) !== null && _ref !== void 0 ? _ref : '';
+        const spreadsheetUrl = (_spreadsheetData_spreadsheetUrl = spreadsheetData.spreadsheetUrl) !== null && _spreadsheetData_spreadsheetUrl !== void 0 ? _spreadsheetData_spreadsheetUrl : '';
+        // Find sheet by gid
+        const sheet = (_spreadsheetData_sheets = spreadsheetData.sheets) === null || _spreadsheetData_sheets === void 0 ? void 0 : _spreadsheetData_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 === null || sheet === void 0 ? void 0 : sheet.properties)) {
+            logger.info('Sheet not found for clear', {
+                id,
+                gid,
+                rangeCount: ranges.length
+            });
+            throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+        }
+        const sheetTitle = (_sheet_properties_title = sheet.properties.title) !== null && _sheet_properties_title !== void 0 ? _sheet_properties_title : gid;
+        const sheetGid = (_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : 0;
+        const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;
+        // Prefix ranges with sheet title
+        const prefixedRanges = ranges.map((range)=>`${sheetTitle}!${range}`);
+        logger.info('sheets.values.clear executing', {
+            spreadsheetId: id,
+            sheetTitle,
+            prefixedRanges
+        });
+        // Use batchClear for efficiency (works for single or multiple ranges)
+        const clearResponse = await sheets.spreadsheets.values.batchClear({
+            spreadsheetId: id,
+            requestBody: {
+                ranges: prefixedRanges
+            }
+        });
+        const clearedRanges = clearResponse.data.clearedRanges || [];
+        logger.info('sheets.values.clear completed successfully', {
+            spreadsheetId: id,
+            sheetTitle,
+            clearedRangesCount: clearedRanges.length
+        });
+        const result = {
+            type: 'success',
+            id,
+            gid: String(sheetGid),
+            spreadsheetTitle: spreadsheetTitle || '',
+            spreadsheetUrl: spreadsheetUrl || '',
+            sheetTitle,
+            sheetUrl,
+            clearedRanges
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('Clear operation failed', {
+            id,
+            gid,
+            rangeCount: ranges.length,
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error clearing values: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'values-clear',
+        config,
+        handler
+    };
+}

package/dist/esm/mcp/tools/values-clear.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/values-clear.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 { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  ranges: z.array(A1NotationSchema).min(1).describe('A1 notation ranges to clear (e.g., [\"A1:B5\", \"D3:D10\"]). Clears values only, preserves formatting.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Title of the spreadsheet'),\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  sheetTitle: z.string().describe('Title of the sheet'),\n  sheetUrl: z.string().describe('URL of the sheet'),\n  clearedRanges: z.array(z.string()).describe('A1 notation ranges that were cleared'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Clear cell values from one or more ranges. Clears values only - preserves formatting, validation, and other cell properties. Use a1-notation prompt for range syntax.',\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, ranges }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.clear called', { id, gid, rangeCount: ranges.length });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Get spreadsheet and sheet info in single API call\n    const spreadsheetResponse = await sheets.spreadsheets.get({\n      spreadsheetId: id,\n      fields: 'properties.title,spreadsheetUrl,sheets.properties.sheetId,sheets.properties.title',\n    });\n\n    const spreadsheetData = spreadsheetResponse.data;\n    const spreadsheetTitle = spreadsheetData.properties?.title ?? '';\n    const spreadsheetUrl = spreadsheetData.spreadsheetUrl ?? '';\n\n    // Find sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      logger.info('Sheet not found for clear', { id, gid, rangeCount: ranges.length });\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? gid;\n    const sheetGid = sheet.properties.sheetId ?? 0;\n    const sheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheetGid}`;\n\n    // Prefix ranges with sheet title\n    const prefixedRanges = ranges.map((range) => `${sheetTitle}!${range}`);\n\n    logger.info('sheets.values.clear executing', { spreadsheetId: id, sheetTitle, prefixedRanges });\n\n    // Use batchClear for efficiency (works for single or multiple ranges)\n    const clearResponse = await sheets.spreadsheets.values.batchClear({\n      spreadsheetId: id,\n      requestBody: {\n        ranges: prefixedRanges,\n      },\n    });\n\n    const clearedRanges = clearResponse.data.clearedRanges || [];\n\n    logger.info('sheets.values.clear completed successfully', {\n      spreadsheetId: id,\n      sheetTitle,\n      clearedRangesCount: clearedRanges.length,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheetGid),\n      spreadsheetTitle: spreadsheetTitle || '',\n      spreadsheetUrl: spreadsheetUrl || '',\n      sheetTitle,\n      sheetUrl,\n      clearedRanges,\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('Clear operation failed', { id, gid, rangeCount: ranges.length, error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error clearing values: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-clear',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","inputSchema","object","id","gid","ranges","array","min","describe","successBranchSchema","type","literal","spreadsheetTitle","string","spreadsheetUrl","sheetTitle","sheetUrl","clearedRanges","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","rangeCount","length","spreadsheetData","sheet","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","properties","title","find","s","String","sheetId","InvalidParams","sheetGid","prefixedRanges","map","range","clearResponse","values","batchClear","requestBody","clearedRangesCount","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/values-csv-update.d.ts

@@ -0,0 +1,75 @@
+/** Import CSV data to Google Sheets with range-based update (no deduplication) */
+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>;
+    sourceUri: z.ZodString;
+    startRange: z.ZodDefault<z.ZodString>;
+    valueInputOption: z.ZodDefault<z.ZodEnum<{
+        RAW: "RAW";
+        USER_ENTERED: "USER_ENTERED";
+    }>>;
+    sourceHasHeaders: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    gid: z.ZodString;
+    spreadsheetTitle: z.ZodString;
+    spreadsheetUrl: z.ZodString;
+    sheetTitle: z.ZodString;
+    sheetUrl: z.ZodString;
+    updatedRange: z.ZodString;
+    updatedRows: z.ZodNumber;
+    updatedColumns: z.ZodNumber;
+    updatedCells: z.ZodNumber;
+}, 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, sourceUri, startRange, valueInputOption, sourceHasHeaders }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            sourceUri: z.ZodString;
+            startRange: z.ZodDefault<z.ZodString>;
+            valueInputOption: z.ZodDefault<z.ZodEnum<{
+                RAW: "RAW";
+                USER_ENTERED: "USER_ENTERED";
+            }>>;
+            sourceHasHeaders: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                gid: z.ZodString;
+                spreadsheetTitle: z.ZodString;
+                spreadsheetUrl: z.ZodString;
+                sheetTitle: z.ZodString;
+                sheetUrl: z.ZodString;
+                updatedRange: z.ZodString;
+                updatedRows: z.ZodNumber;
+                updatedColumns: z.ZodNumber;
+                updatedCells: z.ZodNumber;
+            }, 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 {};