Merge pull request #72 from a-pedraza/feat/sheet-management

feat: add deleteSheet and renameSheet tools

Author: a-bonus

src/tools/sheets/deleteSheet.ts

@@ -0,0 +1,54 @@
+import type { FastMCP } from 'fastmcp';
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getSheetsClient } from '../../clients.js';
+
+export function register(server: FastMCP) {
+  server.addTool({
+    name: 'deleteSheet',
+    description:
+      'Deletes a sheet (tab) from a spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID.',
+    parameters: z.object({
+      spreadsheetId: z
+        .string()
+        .describe(
+          'The spreadsheet ID — the long string between /d/ and /edit in a Google Sheets URL.'
+        ),
+      sheetId: z
+        .number()
+        .int()
+        .describe(
+          'The numeric sheet ID to delete. Use getSpreadsheetInfo to find sheet IDs.'
+        ),
+    }),
+    execute: async (args, { log }) => {
+      const sheets = await getSheetsClient();
+      log.info(
+        `Deleting sheet ID ${args.sheetId} from spreadsheet ${args.spreadsheetId}`
+      );
+
+      try {
+        await sheets.spreadsheets.batchUpdate({
+          spreadsheetId: args.spreadsheetId,
+          requestBody: {
+            requests: [
+              {
+                deleteSheet: {
+                  sheetId: args.sheetId,
+                },
+              },
+            ],
+          },
+        });
+
+        return `Successfully deleted sheet (ID: ${args.sheetId}) from spreadsheet.`;
+      } catch (error: any) {
+        log.error(
+          `Error deleting sheet in spreadsheet ${args.spreadsheetId}: ${error.message || error}`
+        );
+        if (error instanceof UserError) throw error;
+        throw new UserError(`Failed to delete sheet: ${error.message || 'Unknown error'}`);
+      }
+    },
+  });
+}

src/tools/sheets/index.ts

@@ -8,6 +8,8 @@ import { register as getSpreadsheetInfo } from './getSpreadsheetInfo.js';
 import { register as addSpreadsheetSheet } from './addSpreadsheetSheet.js';
 import { register as createSpreadsheet } from './createSpreadsheet.js';
 import { register as listGoogleSheets } from './listGoogleSheets.js';
+import { register as deleteSheet } from './deleteSheet.js';
+import { register as renameSheet } from './renameSheet.js';
 import { register as duplicateSheet } from './duplicateSheet.js';
 
 // Formatting & validation
@@ -27,6 +29,8 @@ export function registerSheetsTools(server: FastMCP) {
   addSpreadsheetSheet(server);
   createSpreadsheet(server);
   listGoogleSheets(server);
+  deleteSheet(server);
+  renameSheet(server);
   duplicateSheet(server);
 
   // Formatting & validation

src/tools/sheets/renameSheet.ts

@@ -0,0 +1,62 @@
+import type { FastMCP } from 'fastmcp';
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getSheetsClient } from '../../clients.js';
+
+export function register(server: FastMCP) {
+  server.addTool({
+    name: 'renameSheet',
+    description:
+      'Renames a sheet (tab) in a spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID.',
+    parameters: z.object({
+      spreadsheetId: z
+        .string()
+        .describe(
+          'The spreadsheet ID — the long string between /d/ and /edit in a Google Sheets URL.'
+        ),
+      sheetId: z
+        .number()
+        .int()
+        .describe(
+          'The numeric sheet ID to rename. Use getSpreadsheetInfo to find sheet IDs.'
+        ),
+      newName: z
+        .string()
+        .min(1)
+        .describe('The new name for the sheet.'),
+    }),
+    execute: async (args, { log }) => {
+      const sheets = await getSheetsClient();
+      log.info(
+        `Renaming sheet ID ${args.sheetId} to "${args.newName}" in spreadsheet ${args.spreadsheetId}`
+      );
+
+      try {
+        await sheets.spreadsheets.batchUpdate({
+          spreadsheetId: args.spreadsheetId,
+          requestBody: {
+            requests: [
+              {
+                updateSheetProperties: {
+                  properties: {
+                    sheetId: args.sheetId,
+                    title: args.newName,
+                  },
+                  fields: 'title',
+                },
+              },
+            ],
+          },
+        });
+
+        return `Successfully renamed sheet (ID: ${args.sheetId}) to "${args.newName}".`;
+      } catch (error: any) {
+        log.error(
+          `Error renaming sheet in spreadsheet ${args.spreadsheetId}: ${error.message || error}`
+        );
+        if (error instanceof UserError) throw error;
+        throw new UserError(`Failed to rename sheet: ${error.message || 'Unknown error'}`);
+      }
+    },
+  });
+}