@mcp-z/mcp-sheets 1.0.0

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

@@ -0,0 +1,202 @@
+/** Import CSV data to Google Sheets with range-based update (no deduplication) */ import { schemas } from '@mcp-z/oauth-google';
+const { AuthRequiredBranchSchema } = schemas;
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { parse } from 'csv-parse';
+import { google } from 'googleapis';
+import { z } from 'zod';
+import { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+import { getCsvReadStream } from '../../spreadsheet/csv-streaming.js';
+/** Batch size for Sheets API calls (1000 rows × avg 10 cols = 10K cells, well under 40K limit) */ const BATCH_SIZE = 1000;
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    gid: SheetGidSchema,
+    sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),
+    startRange: A1NotationSchema.default('A1').describe('Top-left cell where CSV data starts (default: A1)'),
+    valueInputOption: z.enum([
+        'RAW',
+        'USER_ENTERED'
+    ]).default('USER_ENTERED').describe('How to interpret values (RAW = exact, USER_ENTERED = parse formulas/dates)'),
+    sourceHasHeaders: z.boolean().default(true).describe('First row is headers (metadata) - exclude from data range. Set to false to include first row as data.')
+});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    id: SpreadsheetIdOutput,
+    gid: SheetGidOutput,
+    spreadsheetTitle: z.string().describe('Spreadsheet title'),
+    spreadsheetUrl: z.string().describe('Spreadsheet URL'),
+    sheetTitle: z.string().describe('Sheet title'),
+    sheetUrl: z.string().describe('Sheet URL'),
+    updatedRange: z.string().describe('A1 notation range that was updated'),
+    updatedRows: z.number().describe('Number of rows updated'),
+    updatedColumns: z.number().describe('Number of columns updated'),
+    updatedCells: z.number().describe('Number of cells updated')
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, gid, sourceUri, startRange, valueInputOption = 'USER_ENTERED', sourceHasHeaders }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.values.csv-update called', {
+        id,
+        gid,
+        sourceUri,
+        startRange,
+        valueInputOption,
+        sourceHasHeaders
+    });
+    try {
+        var _sheet_properties_title, _sheet_properties_sheetId, _ref, _spreadsheetData_spreadsheetUrl;
+        var _spreadsheetData_sheets, _startRange_match, _batchUpdateResponse_data_responses_, _batchUpdateResponse_data_responses, _spreadsheetData_properties;
+        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;
+        // Find the 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)) {
+            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 : '';
+        // Streaming CSV processing state
+        let sourceHeaders = [];
+        const allRows = [];
+        let totalCols = 0;
+        // Get readable stream from CSV URI (no temp files!)
+        const readStream = await getCsvReadStream(sourceUri);
+        // Create CSV parser with native streaming
+        const parser = readStream.pipe(parse({
+            columns: !!sourceHasHeaders,
+            skip_empty_lines: true,
+            trim: true,
+            cast: true,
+            relax_column_count: true
+        }));
+        // Stream and collect all rows (with batching for very large files)
+        for await (const record of parser){
+            if (sourceHasHeaders) {
+                // Extract source headers from first record
+                if (sourceHeaders.length === 0) {
+                    sourceHeaders = Object.keys(record);
+                    totalCols = sourceHeaders.length;
+                    logger.info('sheets.values.csv-update source headers', {
+                        sourceHeaders,
+                        totalCols
+                    });
+                }
+                // Convert record to row array (exclude source headers from data range)
+                // CSV values are strings/numbers/booleans/nulls from the parser
+                const row = sourceHeaders.map((header)=>{
+                    var _record_header;
+                    return (_record_header = record[header]) !== null && _record_header !== void 0 ? _record_header : null;
+                });
+                allRows.push(row);
+            } else {
+                // sourceHasHeaders=false: record is an array, include all rows (including first row)
+                const row = record;
+                allRows.push(row);
+                if (totalCols === 0) {
+                    totalCols = row.length;
+                }
+            }
+        }
+        if (allRows.length === 0) {
+            throw new McpError(ErrorCode.InvalidParams, 'CSV file is empty');
+        }
+        // Prepare data for update (all rows)
+        const dataToWrite = allRows;
+        // For large datasets, use batchUpdate to write in chunks
+        // This respects the 40K cell limit per request
+        const batchRequests = [];
+        const currentRow = ((_startRange_match = startRange.match(/[A-Z]+(\d+)/)) === null || _startRange_match === void 0 ? void 0 : _startRange_match[1]) || '1';
+        let currentRowNum = Number.parseInt(currentRow, 10);
+        for(let i = 0; i < dataToWrite.length; i += BATCH_SIZE){
+            var _startRange_match1;
+            const batchData = dataToWrite.slice(i, i + BATCH_SIZE);
+            const batchRange = `${sheetTitle}!${(_startRange_match1 = startRange.match(/[A-Z]+/)) === null || _startRange_match1 === void 0 ? void 0 : _startRange_match1[0]}${currentRowNum}`;
+            batchRequests.push({
+                range: batchRange,
+                values: batchData
+            });
+            currentRowNum += batchData.length;
+        }
+        logger.info('sheets.values.csv-update batching', {
+            totalBatches: batchRequests.length,
+            batchSize: BATCH_SIZE
+        });
+        // Execute batch update
+        const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({
+            spreadsheetId: id,
+            requestBody: {
+                valueInputOption,
+                data: batchRequests
+            }
+        });
+        const totalUpdatedCells = batchUpdateResponse.data.totalUpdatedCells || 0;
+        const totalUpdatedRows = batchUpdateResponse.data.totalUpdatedRows || 0;
+        const totalUpdatedColumns = batchUpdateResponse.data.totalUpdatedColumns || 0;
+        const firstUpdatedRange = ((_batchUpdateResponse_data_responses = batchUpdateResponse.data.responses) === null || _batchUpdateResponse_data_responses === void 0 ? void 0 : (_batchUpdateResponse_data_responses_ = _batchUpdateResponse_data_responses[0]) === null || _batchUpdateResponse_data_responses_ === void 0 ? void 0 : _batchUpdateResponse_data_responses_.updatedRange) || `${sheetTitle}!${startRange}`;
+        logger.info('sheets.values.csv-update completed', {
+            id,
+            gid: sheet.properties.sheetId,
+            updatedRange: firstUpdatedRange,
+            updatedRows: totalUpdatedRows,
+            sourceUri
+        });
+        const result = {
+            type: 'success',
+            id,
+            gid: String((_sheet_properties_sheetId = sheet.properties.sheetId) !== null && _sheet_properties_sheetId !== void 0 ? _sheet_properties_sheetId : ''),
+            spreadsheetTitle: (_ref = (_spreadsheetData_properties = spreadsheetData.properties) === null || _spreadsheetData_properties === void 0 ? void 0 : _spreadsheetData_properties.title) !== null && _ref !== void 0 ? _ref : '',
+            spreadsheetUrl: (_spreadsheetData_spreadsheetUrl = spreadsheetData.spreadsheetUrl) !== null && _spreadsheetData_spreadsheetUrl !== void 0 ? _spreadsheetData_spreadsheetUrl : `https://docs.google.com/spreadsheets/d/${id}`,
+            sheetTitle,
+            sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheet.properties.sheetId}`,
+            updatedRange: firstUpdatedRange,
+            updatedRows: totalUpdatedRows,
+            updatedColumns: totalUpdatedColumns,
+            updatedCells: totalUpdatedCells
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                }
+            ],
+            structuredContent: {
+                result
+            }
+        };
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error('sheets.values.csv-update error', {
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error updating values from CSV: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'values-csv-update',
+        config,
+        handler
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/values-csv-update.ts"],"sourcesContent":["/** Import CSV data to Google Sheets with range-based update (no deduplication) */\n\nimport 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 { parse } from 'csv-parse';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidOutput, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\nimport { getCsvReadStream } from '../../spreadsheet/csv-streaming.js';\n\n/** Batch size for Sheets API calls (1000 rows × avg 10 cols = 10K cells, well under 40K limit) */\nconst BATCH_SIZE = 1000;\n\nconst inputSchema = z.object({\n  id: SpreadsheetIdSchema,\n  gid: SheetGidSchema,\n  sourceUri: z.string().trim().min(1).describe('CSV file URI (file://, http://, https://)'),\n  startRange: A1NotationSchema.default('A1').describe('Top-left cell where CSV data starts (default: A1)'),\n  valueInputOption: z.enum(['RAW', 'USER_ENTERED']).default('USER_ENTERED').describe('How to interpret values (RAW = exact, USER_ENTERED = parse formulas/dates)'),\n  sourceHasHeaders: z.boolean().default(true).describe('First row is headers (metadata) - exclude from data range. Set to false to include first row as data.'),\n});\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  gid: SheetGidOutput,\n  spreadsheetTitle: z.string().describe('Spreadsheet title'),\n  spreadsheetUrl: z.string().describe('Spreadsheet URL'),\n  sheetTitle: z.string().describe('Sheet title'),\n  sheetUrl: z.string().describe('Sheet URL'),\n  updatedRange: z.string().describe('A1 notation range that was updated'),\n  updatedRows: z.number().describe('Number of rows updated'),\n  updatedColumns: z.number().describe('Number of columns updated'),\n  updatedCells: z.number().describe('Number of cells updated'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Import CSV to sheet range. Overwrites existing data at startRange. Use rows-csv-append for database-style appends with deduplication.',\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, sourceUri, startRange, valueInputOption = 'USER_ENTERED', sourceHasHeaders }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values.csv-update called', { id, gid, sourceUri, startRange, valueInputOption, sourceHasHeaders });\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\n    // Find the sheet by gid\n    const sheet = spreadsheetData.sheets?.find((s) => String(s.properties?.sheetId) === gid);\n    if (!sheet?.properties) {\n      throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n    }\n\n    const sheetTitle = sheet.properties.title ?? '';\n\n    // Streaming CSV processing state\n    let sourceHeaders: string[] = [];\n    const allRows: (string | number | boolean | null)[][] = [];\n    let totalCols = 0;\n\n    // Get readable stream from CSV URI (no temp files!)\n    const readStream = await getCsvReadStream(sourceUri);\n\n    // Create CSV parser with native streaming\n    const parser = readStream.pipe(\n      parse({\n        columns: !!sourceHasHeaders, // Parse first row as column names if source has headers\n        skip_empty_lines: true,\n        trim: true,\n        cast: true, // Auto-convert numbers/booleans\n        relax_column_count: true,\n      })\n    );\n\n    // Stream and collect all rows (with batching for very large files)\n    for await (const record of parser) {\n      if (sourceHasHeaders) {\n        // Extract source headers from first record\n        if (sourceHeaders.length === 0) {\n          sourceHeaders = Object.keys(record as Record<string, unknown>);\n          totalCols = sourceHeaders.length;\n          logger.info('sheets.values.csv-update source headers', { sourceHeaders, totalCols });\n        }\n\n        // Convert record to row array (exclude source headers from data range)\n        // CSV values are strings/numbers/booleans/nulls from the parser\n        const row = sourceHeaders.map((header) => (record as Record<string, string | number | boolean | null>)[header] ?? null);\n        allRows.push(row);\n      } else {\n        // sourceHasHeaders=false: record is an array, include all rows (including first row)\n        const row = record as (string | number | boolean | null)[];\n        allRows.push(row);\n\n        if (totalCols === 0) {\n          totalCols = row.length;\n        }\n      }\n    }\n\n    if (allRows.length === 0) {\n      throw new McpError(ErrorCode.InvalidParams, 'CSV file is empty');\n    }\n\n    // Prepare data for update (all rows)\n    const dataToWrite: (string | number | boolean | null)[][] = allRows;\n\n    // For large datasets, use batchUpdate to write in chunks\n    // This respects the 40K cell limit per request\n    const batchRequests = [];\n    const currentRow = startRange.match(/[A-Z]+(\\d+)/)?.[1] || '1';\n    let currentRowNum = Number.parseInt(currentRow, 10);\n\n    for (let i = 0; i < dataToWrite.length; i += BATCH_SIZE) {\n      const batchData = dataToWrite.slice(i, i + BATCH_SIZE);\n      const batchRange = `${sheetTitle}!${startRange.match(/[A-Z]+/)?.[0]}${currentRowNum}`;\n\n      batchRequests.push({\n        range: batchRange,\n        values: batchData,\n      });\n\n      currentRowNum += batchData.length;\n    }\n\n    logger.info('sheets.values.csv-update batching', { totalBatches: batchRequests.length, batchSize: BATCH_SIZE });\n\n    // Execute batch update\n    const batchUpdateResponse = await sheets.spreadsheets.values.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        valueInputOption,\n        data: batchRequests,\n      },\n    });\n\n    const totalUpdatedCells = batchUpdateResponse.data.totalUpdatedCells || 0;\n    const totalUpdatedRows = batchUpdateResponse.data.totalUpdatedRows || 0;\n    const totalUpdatedColumns = batchUpdateResponse.data.totalUpdatedColumns || 0;\n    const firstUpdatedRange = batchUpdateResponse.data.responses?.[0]?.updatedRange || `${sheetTitle}!${startRange}`;\n\n    logger.info('sheets.values.csv-update completed', { id, gid: sheet.properties.sheetId, updatedRange: firstUpdatedRange, updatedRows: totalUpdatedRows, sourceUri });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      gid: String(sheet.properties.sheetId ?? ''),\n      spreadsheetTitle: spreadsheetData.properties?.title ?? '',\n      spreadsheetUrl: spreadsheetData.spreadsheetUrl ?? `https://docs.google.com/spreadsheets/d/${id}`,\n      sheetTitle,\n      sheetUrl: `https://docs.google.com/spreadsheets/d/${id}/edit#gid=${sheet.properties.sheetId}`,\n      updatedRange: firstUpdatedRange,\n      updatedRows: totalUpdatedRows,\n      updatedColumns: totalUpdatedColumns,\n      updatedCells: totalUpdatedCells,\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.values.csv-update error', { error: message });\n\n    throw new McpError(ErrorCode.InternalError, `Error updating values from CSV: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-csv-update',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","parse","google","z","A1NotationSchema","SheetGidOutput","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","getCsvReadStream","BATCH_SIZE","inputSchema","object","id","gid","sourceUri","string","trim","min","describe","startRange","default","valueInputOption","enum","sourceHasHeaders","boolean","successBranchSchema","type","literal","spreadsheetTitle","spreadsheetUrl","sheetTitle","sheetUrl","updatedRange","updatedRows","number","updatedColumns","updatedCells","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","sheet","spreadsheetData","batchUpdateResponse","sheets","version","auth","authContext","spreadsheetResponse","spreadsheets","get","spreadsheetId","fields","data","find","s","String","properties","sheetId","InvalidParams","title","sourceHeaders","allRows","totalCols","readStream","parser","pipe","columns","skip_empty_lines","cast","relax_column_count","record","length","Object","keys","row","map","header","push","dataToWrite","batchRequests","currentRow","match","currentRowNum","Number","parseInt","i","batchData","slice","batchRange","range","values","totalBatches","batchSize","batchUpdate","requestBody","totalUpdatedCells","totalUpdatedRows","totalUpdatedColumns","firstUpdatedRange","responses","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","undefined","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/values-replace.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<{
+    id: z.ZodString;
+    find: z.ZodString;
+    replacement: z.ZodString;
+    gid: z.ZodOptional<z.ZodCoercedString<unknown>>;
+    range: z.ZodOptional<z.ZodString>;
+    matchCase: z.ZodOptional<z.ZodBoolean>;
+    matchEntireCell: z.ZodOptional<z.ZodBoolean>;
+    searchByRegex: z.ZodOptional<z.ZodBoolean>;
+    includeFormulas: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    id: z.ZodString;
+    spreadsheetUrl: z.ZodString;
+    occurrencesChanged: z.ZodNumber;
+    valuesChanged: z.ZodNumber;
+    formulasChanged: z.ZodNumber;
+    rowsChanged: z.ZodNumber;
+    sheetsChanged: 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, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            find: z.ZodString;
+            replacement: z.ZodString;
+            gid: z.ZodOptional<z.ZodCoercedString<unknown>>;
+            range: z.ZodOptional<z.ZodString>;
+            matchCase: z.ZodOptional<z.ZodBoolean>;
+            matchEntireCell: z.ZodOptional<z.ZodBoolean>;
+            searchByRegex: z.ZodOptional<z.ZodBoolean>;
+            includeFormulas: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                id: z.ZodString;
+                spreadsheetUrl: z.ZodString;
+                occurrencesChanged: z.ZodNumber;
+                valuesChanged: z.ZodNumber;
+                formulasChanged: z.ZodNumber;
+                rowsChanged: z.ZodNumber;
+                sheetsChanged: 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 {};

package/dist/esm/mcp/tools/values-replace.js

@@ -0,0 +1,171 @@
+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, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';
+import { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';
+const inputSchema = z.object({
+    id: SpreadsheetIdSchema,
+    find: z.string().min(1).describe('Text or regex pattern to find'),
+    replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),
+    // Scope - defaults to all sheets if neither specified
+    gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),
+    range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),
+    // Match options
+    matchCase: z.boolean().optional().describe('Case-sensitive matching'),
+    matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),
+    searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),
+    includeFormulas: z.boolean().optional().describe('Search within formula text')
+}).refine((data)=>!(data.range && !data.gid), {
+    message: 'range requires gid'
+});
+const successBranchSchema = z.object({
+    type: z.literal('success'),
+    id: SpreadsheetIdOutput,
+    spreadsheetUrl: z.string().describe('URL of the spreadsheet'),
+    occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),
+    valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),
+    formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),
+    rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),
+    sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements')
+});
+const outputSchema = z.discriminatedUnion('type', [
+    successBranchSchema,
+    AuthRequiredBranchSchema
+]);
+const config = {
+    description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',
+    inputSchema,
+    outputSchema: z.object({
+        result: outputSchema
+    })
+};
+async function handler({ id, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }, extra) {
+    const logger = extra.logger;
+    logger.info('sheets.values-replace called', {
+        id,
+        find,
+        replacement,
+        gid,
+        range
+    });
+    try {
+        var _ref, _ref1, _ref2, _ref3, _ref4, _ref5, _ref6;
+        var _response_data_replies_, _response_data_replies;
+        const sheets = google.sheets({
+            version: 'v4',
+            auth: extra.authContext.auth
+        });
+        // Build FindReplaceRequest - only include defined options
+        const findReplaceRequest = {
+            find,
+            replacement,
+            ...matchCase !== undefined && {
+                matchCase
+            },
+            ...matchEntireCell !== undefined && {
+                matchEntireCell
+            },
+            ...searchByRegex !== undefined && {
+                searchByRegex
+            },
+            ...includeFormulas !== undefined && {
+                includeFormulas
+            }
+        };
+        // Set scope based on gid/range
+        if (!gid) {
+            // No gid = search all sheets
+            findReplaceRequest.allSheets = true;
+        } else {
+            var _spreadsheetResponse_data_sheets, _sheet_properties;
+            // Need to resolve sheet to get numeric sheetId
+            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) {
+                throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);
+            }
+            // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null
+            const sheetId = (_sheet_properties = sheet.properties) === null || _sheet_properties === void 0 ? void 0 : _sheet_properties.sheetId;
+            if (sheetId === undefined || sheetId === null) {
+                throw new McpError(ErrorCode.InternalError, 'Sheet properties not available');
+            }
+            if (!range) {
+                // gid but no range = search specific sheet
+                findReplaceRequest.sheetId = sheetId;
+            } else {
+                // gid + range = search specific range
+                const rangeRef = parseA1Notation(range);
+                findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);
+            }
+        }
+        // Execute batchUpdate
+        const response = await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: id,
+            requestBody: {
+                requests: [
+                    {
+                        findReplace: findReplaceRequest
+                    }
+                ]
+            }
+        });
+        const findReplaceResponse = (_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_.findReplace;
+        const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;
+        logger.info('sheets.values-replace completed', {
+            occurrencesChanged: (_ref = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.occurrencesChanged) !== null && _ref !== void 0 ? _ref : 0,
+            sheetsChanged: (_ref1 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.sheetsChanged) !== null && _ref1 !== void 0 ? _ref1 : 0
+        });
+        const result = {
+            type: 'success',
+            id,
+            spreadsheetUrl,
+            occurrencesChanged: (_ref2 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.occurrencesChanged) !== null && _ref2 !== void 0 ? _ref2 : 0,
+            valuesChanged: (_ref3 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.valuesChanged) !== null && _ref3 !== void 0 ? _ref3 : 0,
+            formulasChanged: (_ref4 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.formulasChanged) !== null && _ref4 !== void 0 ? _ref4 : 0,
+            rowsChanged: (_ref5 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.rowsChanged) !== null && _ref5 !== void 0 ? _ref5 : 0,
+            sheetsChanged: (_ref6 = findReplaceResponse === null || findReplaceResponse === void 0 ? void 0 : findReplaceResponse.sheetsChanged) !== null && _ref6 !== void 0 ? _ref6 : 0
+        };
+        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('Replace operation failed', {
+            id,
+            find,
+            replacement,
+            gid,
+            range,
+            error: message
+        });
+        throw new McpError(ErrorCode.InternalError, `Error replacing values: ${message}`, {
+            stack: error instanceof Error ? error.stack : undefined
+        });
+    }
+}
+export default function createTool() {
+    return {
+        name: 'values-replace',
+        config,
+        handler
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/mcp/tools/values-replace.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, type sheets_v4 } from 'googleapis';\nimport { z } from 'zod';\nimport { A1NotationSchema, SheetGidSchema, SpreadsheetIdOutput, SpreadsheetIdSchema } from '../../schemas/index.js';\nimport { parseA1Notation, rangeReferenceToGridRange } from '../../spreadsheet/range-operations.js';\n\nconst inputSchema = z\n  .object({\n    id: SpreadsheetIdSchema,\n    find: z.string().min(1).describe('Text or regex pattern to find'),\n    replacement: z.string().describe('Replacement text. Use $1, $2 for regex capture groups. Empty string deletes matches.'),\n\n    // Scope - defaults to all sheets if neither specified\n    gid: SheetGidSchema.optional().describe('Limit to specific sheet. If omitted, searches all sheets.'),\n    range: A1NotationSchema.optional().describe('Limit to specific A1 range within the sheet (requires gid)'),\n\n    // Match options\n    matchCase: z.boolean().optional().describe('Case-sensitive matching'),\n    matchEntireCell: z.boolean().optional().describe('Only match entire cell content'),\n    searchByRegex: z.boolean().optional().describe('Treat find as RE2 regex'),\n    includeFormulas: z.boolean().optional().describe('Search within formula text'),\n  })\n  .refine((data) => !(data.range && !data.gid), { message: 'range requires gid' });\n\nconst successBranchSchema = z.object({\n  type: z.literal('success'),\n  id: SpreadsheetIdOutput,\n  spreadsheetUrl: z.string().describe('URL of the spreadsheet'),\n  occurrencesChanged: z.number().int().nonnegative().describe('Total replacements made'),\n  valuesChanged: z.number().int().nonnegative().describe('Number of non-formula cells changed'),\n  formulasChanged: z.number().int().nonnegative().describe('Number of formula cells changed'),\n  rowsChanged: z.number().int().nonnegative().describe('Number of rows with replacements'),\n  sheetsChanged: z.number().int().nonnegative().describe('Number of sheets with replacements'),\n});\n\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n  description: 'Find and replace text across a spreadsheet. Searches all sheets by default, or limit with gid/range. Supports regex with capture groups ($1, $2).',\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, find, replacement, gid, range, matchCase, matchEntireCell, searchByRegex, includeFormulas }: Input, extra: EnrichedExtra): Promise<CallToolResult> {\n  const logger = extra.logger;\n  logger.info('sheets.values-replace called', { id, find, replacement, gid, range });\n\n  try {\n    const sheets = google.sheets({ version: 'v4', auth: extra.authContext.auth });\n\n    // Build FindReplaceRequest - only include defined options\n    const findReplaceRequest: sheets_v4.Schema$FindReplaceRequest = {\n      find,\n      replacement,\n      ...(matchCase !== undefined && { matchCase }),\n      ...(matchEntireCell !== undefined && { matchEntireCell }),\n      ...(searchByRegex !== undefined && { searchByRegex }),\n      ...(includeFormulas !== undefined && { includeFormulas }),\n    };\n\n    // Set scope based on gid/range\n    if (!gid) {\n      // No gid = search all sheets\n      findReplaceRequest.allSheets = true;\n    } else {\n      // Need to resolve sheet to get numeric sheetId\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      if (!sheet) {\n        throw new McpError(ErrorCode.InvalidParams, `Sheet not found: ${gid}`);\n      }\n\n      // Note: sheetId can be 0 which is falsy, so check explicitly for undefined/null\n      const sheetId = sheet.properties?.sheetId;\n      if (sheetId === undefined || sheetId === null) {\n        throw new McpError(ErrorCode.InternalError, 'Sheet properties not available');\n      }\n\n      if (!range) {\n        // gid but no range = search specific sheet\n        findReplaceRequest.sheetId = sheetId;\n      } else {\n        // gid + range = search specific range\n        const rangeRef = parseA1Notation(range);\n        findReplaceRequest.range = rangeReferenceToGridRange(rangeRef, sheetId);\n      }\n    }\n\n    // Execute batchUpdate\n    const response = await sheets.spreadsheets.batchUpdate({\n      spreadsheetId: id,\n      requestBody: {\n        requests: [{ findReplace: findReplaceRequest }],\n      },\n    });\n\n    const findReplaceResponse = response.data.replies?.[0]?.findReplace;\n    const spreadsheetUrl = `https://docs.google.com/spreadsheets/d/${id}/edit`;\n\n    logger.info('sheets.values-replace completed', {\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\n    });\n\n    const result: Output = {\n      type: 'success' as const,\n      id,\n      spreadsheetUrl,\n      occurrencesChanged: findReplaceResponse?.occurrencesChanged ?? 0,\n      valuesChanged: findReplaceResponse?.valuesChanged ?? 0,\n      formulasChanged: findReplaceResponse?.formulasChanged ?? 0,\n      rowsChanged: findReplaceResponse?.rowsChanged ?? 0,\n      sheetsChanged: findReplaceResponse?.sheetsChanged ?? 0,\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('Replace operation failed', {\n      id,\n      find,\n      replacement,\n      gid,\n      range,\n      error: message,\n    });\n\n    throw new McpError(ErrorCode.InternalError, `Error replacing values: ${message}`, {\n      stack: error instanceof Error ? error.stack : undefined,\n    });\n  }\n}\n\nexport default function createTool() {\n  return {\n    name: 'values-replace',\n    config,\n    handler,\n  } satisfies ToolModule;\n}\n"],"names":["schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","A1NotationSchema","SheetGidSchema","SpreadsheetIdOutput","SpreadsheetIdSchema","parseA1Notation","rangeReferenceToGridRange","inputSchema","object","id","find","string","min","describe","replacement","gid","optional","range","matchCase","boolean","matchEntireCell","searchByRegex","includeFormulas","refine","data","message","successBranchSchema","type","literal","spreadsheetUrl","occurrencesChanged","number","int","nonnegative","valuesChanged","formulasChanged","rowsChanged","sheetsChanged","outputSchema","discriminatedUnion","config","description","result","handler","extra","logger","info","response","sheets","version","auth","authContext","findReplaceRequest","undefined","allSheets","spreadsheetResponse","sheet","spreadsheets","get","spreadsheetId","fields","s","String","properties","sheetId","InvalidParams","InternalError","rangeRef","batchUpdate","requestBody","requests","findReplace","findReplaceResponse","replies","content","text","JSON","stringify","structuredContent","error","Error","stack","createTool","name"],"mappings":"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"}

package/dist/esm/mcp/tools/values-search.d.ts

@@ -0,0 +1,74 @@
+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>;
+    query: z.ZodOptional<z.ZodCoercedString<unknown>>;
+    select: z.ZodEnum<{
+        columns: "columns";
+        rows: "rows";
+        cells: "cells";
+    }>;
+    values: z.ZodOptional<z.ZodBoolean>;
+    a1s: z.ZodOptional<z.ZodBoolean>;
+    render: z.ZodOptional<z.ZodEnum<{
+        FORMATTED_VALUE: "FORMATTED_VALUE";
+        UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
+        FORMULA: "FORMULA";
+    }>>;
+    matchCase: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"success">;
+    count: z.ZodNumber;
+    a1s: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>, 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, query, select, values, a1s, render, matchCase }: Input, extra: EnrichedExtra): Promise<CallToolResult>;
+export default function createTool(): {
+    name: string;
+    config: {
+        readonly description: "Search spreadsheet and return matches at cell, row, or column granularity. Use a1-notation prompt for range syntax.";
+        readonly inputSchema: z.ZodObject<{
+            id: z.ZodString;
+            gid: z.ZodCoercedString<unknown>;
+            query: z.ZodOptional<z.ZodCoercedString<unknown>>;
+            select: z.ZodEnum<{
+                columns: "columns";
+                rows: "rows";
+                cells: "cells";
+            }>;
+            values: z.ZodOptional<z.ZodBoolean>;
+            a1s: z.ZodOptional<z.ZodBoolean>;
+            render: z.ZodOptional<z.ZodEnum<{
+                FORMATTED_VALUE: "FORMATTED_VALUE";
+                UNFORMATTED_VALUE: "UNFORMATTED_VALUE";
+                FORMULA: "FORMULA";
+            }>>;
+            matchCase: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+        readonly outputSchema: z.ZodObject<{
+            result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"success">;
+                count: z.ZodNumber;
+                a1s: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodLiteral<number>, z.ZodLiteral<number>, z.ZodBoolean, z.ZodNull]>>, 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 {};