@alanse/mcp-server-google-workspace 0.2.0

package/dist/tools/sheets/formatting/gsheets_freeze_columns.js

@@ -0,0 +1,67 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_freeze_columns",
+    description: "Freeze columns at the left of a sheet",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet",
+            },
+            count: {
+                type: "number",
+                description: "Number of columns to freeze (0 to unfreeze all)",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "count"],
+    },
+};
+export async function freezeColumns(args) {
+    try {
+        const sheets = google.sheets("v4");
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        updateSheetProperties: {
+                            properties: {
+                                sheetId: args.sheetId,
+                                gridProperties: {
+                                    frozenColumnCount: args.count,
+                                },
+                            },
+                            fields: "gridProperties.frozenColumnCount",
+                        },
+                    },
+                ],
+            },
+        });
+        const action = args.count === 0 ? "Unfroze all columns" : `Froze ${args.count} column(s)`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${action} on sheet ${args.sheetId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error freezing columns: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/sheets/formatting/gsheets_freeze_rows.js

@@ -0,0 +1,67 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_freeze_rows",
+    description: "Freeze rows at the top of a sheet",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet",
+            },
+            count: {
+                type: "number",
+                description: "Number of rows to freeze (0 to unfreeze all)",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "count"],
+    },
+};
+export async function freezeRows(args) {
+    try {
+        const sheets = google.sheets("v4");
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        updateSheetProperties: {
+                            properties: {
+                                sheetId: args.sheetId,
+                                gridProperties: {
+                                    frozenRowCount: args.count,
+                                },
+                            },
+                            fields: "gridProperties.frozenRowCount",
+                        },
+                    },
+                ],
+            },
+        });
+        const action = args.count === 0 ? "Unfroze all rows" : `Froze ${args.count} row(s)`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${action} on sheet ${args.sheetId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error freezing rows: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/sheets/formatting/gsheets_merge_cells.js

@@ -0,0 +1,85 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_merge_cells",
+    description: "Merge cells in a Google Spreadsheet",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet",
+            },
+            startRow: {
+                type: "number",
+                description: "Starting row index (0-based)",
+            },
+            endRow: {
+                type: "number",
+                description: "Ending row index (exclusive, 0-based)",
+            },
+            startColumn: {
+                type: "number",
+                description: "Starting column index (0-based)",
+            },
+            endColumn: {
+                type: "number",
+                description: "Ending column index (exclusive, 0-based)",
+            },
+            mergeType: {
+                type: "string",
+                enum: ["MERGE_ALL", "MERGE_COLUMNS", "MERGE_ROWS"],
+                description: "How to merge cells: MERGE_ALL (all cells), MERGE_COLUMNS (merge columns), MERGE_ROWS (merge rows)",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "startRow", "endRow", "startColumn", "endColumn"],
+    },
+};
+export async function mergeCells(args) {
+    try {
+        const sheets = google.sheets("v4");
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        mergeCells: {
+                            range: {
+                                sheetId: args.sheetId,
+                                startRowIndex: args.startRow,
+                                endRowIndex: args.endRow,
+                                startColumnIndex: args.startColumn,
+                                endColumnIndex: args.endColumn,
+                            },
+                            mergeType: args.mergeType || "MERGE_ALL",
+                        },
+                    },
+                ],
+            },
+        });
+        const rangeStr = `R${args.startRow}C${args.startColumn}:R${args.endRow - 1}C${args.endColumn - 1}`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully merged cells in range ${rangeStr} using ${args.mergeType || "MERGE_ALL"} mode`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error merging cells: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/sheets/formatting/gsheets_set_number_format.js

@@ -0,0 +1,116 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_set_number_format",
+    description: "Set number format for cells (currency, percentage, date, etc.)",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet",
+            },
+            startRow: {
+                type: "number",
+                description: "Starting row index (0-based)",
+            },
+            endRow: {
+                type: "number",
+                description: "Ending row index (exclusive, 0-based)",
+            },
+            startColumn: {
+                type: "number",
+                description: "Starting column index (0-based)",
+            },
+            endColumn: {
+                type: "number",
+                description: "Ending column index (exclusive, 0-based)",
+            },
+            numberFormat: {
+                type: "object",
+                properties: {
+                    type: {
+                        type: "string",
+                        enum: ["NUMBER", "CURRENCY", "PERCENT", "DATE", "TIME", "DATE_TIME", "SCIENTIFIC", "TEXT"],
+                        description: "The type of number format",
+                    },
+                    pattern: {
+                        type: "string",
+                        description: "Custom format pattern (optional, e.g., '$#,##0.00', '0.00%', 'yyyy-mm-dd')",
+                    },
+                },
+                required: ["type"],
+                description: "Number format settings",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "startRow", "endRow", "startColumn", "endColumn", "numberFormat"],
+    },
+};
+export async function setNumberFormat(args) {
+    try {
+        const sheets = google.sheets("v4");
+        // Default patterns for common types
+        const defaultPatterns = {
+            NUMBER: "#,##0.00",
+            CURRENCY: "$#,##0.00",
+            PERCENT: "0.00%",
+            DATE: "yyyy-mm-dd",
+            TIME: "h:mm:ss",
+            DATE_TIME: "yyyy-mm-dd h:mm:ss",
+            SCIENTIFIC: "0.00E+00",
+            TEXT: "@",
+        };
+        const pattern = args.numberFormat.pattern || defaultPatterns[args.numberFormat.type];
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        repeatCell: {
+                            range: {
+                                sheetId: args.sheetId,
+                                startRowIndex: args.startRow,
+                                endRowIndex: args.endRow,
+                                startColumnIndex: args.startColumn,
+                                endColumnIndex: args.endColumn,
+                            },
+                            cell: {
+                                userEnteredFormat: {
+                                    numberFormat: {
+                                        type: args.numberFormat.type,
+                                        pattern: pattern,
+                                    },
+                                },
+                            },
+                            fields: "userEnteredFormat.numberFormat",
+                        },
+                    },
+                ],
+            },
+        });
+        const rangeStr = `R${args.startRow}C${args.startColumn}:R${args.endRow - 1}C${args.endColumn - 1}`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully set number format to ${args.numberFormat.type} (pattern: ${pattern}) for range ${rangeStr}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error setting number format: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/sheets/formatting/gsheets_unmerge_cells.js

@@ -0,0 +1,79 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_unmerge_cells",
+    description: "Unmerge previously merged cells in a Google Spreadsheet",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet",
+            },
+            startRow: {
+                type: "number",
+                description: "Starting row index (0-based)",
+            },
+            endRow: {
+                type: "number",
+                description: "Ending row index (exclusive, 0-based)",
+            },
+            startColumn: {
+                type: "number",
+                description: "Starting column index (0-based)",
+            },
+            endColumn: {
+                type: "number",
+                description: "Ending column index (exclusive, 0-based)",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "startRow", "endRow", "startColumn", "endColumn"],
+    },
+};
+export async function unmergeCells(args) {
+    try {
+        const sheets = google.sheets("v4");
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        unmergeCells: {
+                            range: {
+                                sheetId: args.sheetId,
+                                startRowIndex: args.startRow,
+                                endRowIndex: args.endRow,
+                                startColumnIndex: args.startColumn,
+                                endColumnIndex: args.endColumn,
+                            },
+                        },
+                    },
+                ],
+            },
+        });
+        const rangeStr = `R${args.startRow}C${args.startColumn}:R${args.endRow - 1}C${args.endColumn - 1}`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully unmerged cells in range ${rangeStr}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error unmerging cells: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/sheets/formatting/gsheets_update_borders.js

@@ -0,0 +1,212 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_update_borders",
+    description: "Update cell borders in a Google Spreadsheet",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet",
+            },
+            startRow: {
+                type: "number",
+                description: "Starting row index (0-based)",
+            },
+            endRow: {
+                type: "number",
+                description: "Ending row index (exclusive, 0-based)",
+            },
+            startColumn: {
+                type: "number",
+                description: "Starting column index (0-based)",
+            },
+            endColumn: {
+                type: "number",
+                description: "Ending column index (exclusive, 0-based)",
+            },
+            top: {
+                type: "object",
+                properties: {
+                    style: {
+                        type: "string",
+                        enum: ["SOLID", "DOTTED", "DASHED", "DOUBLE", "SOLID_MEDIUM", "SOLID_THICK"],
+                    },
+                    width: { type: "number" },
+                    color: {
+                        type: "object",
+                        properties: {
+                            red: { type: "number" },
+                            green: { type: "number" },
+                            blue: { type: "number" },
+                        },
+                    },
+                },
+                description: "Top border style",
+            },
+            bottom: {
+                type: "object",
+                properties: {
+                    style: {
+                        type: "string",
+                        enum: ["SOLID", "DOTTED", "DASHED", "DOUBLE", "SOLID_MEDIUM", "SOLID_THICK"],
+                    },
+                    width: { type: "number" },
+                    color: {
+                        type: "object",
+                        properties: {
+                            red: { type: "number" },
+                            green: { type: "number" },
+                            blue: { type: "number" },
+                        },
+                    },
+                },
+                description: "Bottom border style",
+            },
+            left: {
+                type: "object",
+                properties: {
+                    style: {
+                        type: "string",
+                        enum: ["SOLID", "DOTTED", "DASHED", "DOUBLE", "SOLID_MEDIUM", "SOLID_THICK"],
+                    },
+                    width: { type: "number" },
+                    color: {
+                        type: "object",
+                        properties: {
+                            red: { type: "number" },
+                            green: { type: "number" },
+                            blue: { type: "number" },
+                        },
+                    },
+                },
+                description: "Left border style",
+            },
+            right: {
+                type: "object",
+                properties: {
+                    style: {
+                        type: "string",
+                        enum: ["SOLID", "DOTTED", "DASHED", "DOUBLE", "SOLID_MEDIUM", "SOLID_THICK"],
+                    },
+                    width: { type: "number" },
+                    color: {
+                        type: "object",
+                        properties: {
+                            red: { type: "number" },
+                            green: { type: "number" },
+                            blue: { type: "number" },
+                        },
+                    },
+                },
+                description: "Right border style",
+            },
+            innerHorizontal: {
+                type: "object",
+                properties: {
+                    style: {
+                        type: "string",
+                        enum: ["SOLID", "DOTTED", "DASHED", "DOUBLE", "SOLID_MEDIUM", "SOLID_THICK"],
+                    },
+                    width: { type: "number" },
+                    color: {
+                        type: "object",
+                        properties: {
+                            red: { type: "number" },
+                            green: { type: "number" },
+                            blue: { type: "number" },
+                        },
+                    },
+                },
+                description: "Inner horizontal border style",
+            },
+            innerVertical: {
+                type: "object",
+                properties: {
+                    style: {
+                        type: "string",
+                        enum: ["SOLID", "DOTTED", "DASHED", "DOUBLE", "SOLID_MEDIUM", "SOLID_THICK"],
+                    },
+                    width: { type: "number" },
+                    color: {
+                        type: "object",
+                        properties: {
+                            red: { type: "number" },
+                            green: { type: "number" },
+                            blue: { type: "number" },
+                        },
+                    },
+                },
+                description: "Inner vertical border style",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "startRow", "endRow", "startColumn", "endColumn"],
+    },
+};
+export async function updateBorders(args) {
+    try {
+        const sheets = google.sheets("v4");
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        updateBorders: {
+                            range: {
+                                sheetId: args.sheetId,
+                                startRowIndex: args.startRow,
+                                endRowIndex: args.endRow,
+                                startColumnIndex: args.startColumn,
+                                endColumnIndex: args.endColumn,
+                            },
+                            top: args.top,
+                            bottom: args.bottom,
+                            left: args.left,
+                            right: args.right,
+                            innerHorizontal: args.innerHorizontal,
+                            innerVertical: args.innerVertical,
+                        },
+                    },
+                ],
+            },
+        });
+        const rangeStr = `R${args.startRow}C${args.startColumn}:R${args.endRow - 1}C${args.endColumn - 1}`;
+        const bordersSet = [];
+        if (args.top)
+            bordersSet.push("top");
+        if (args.bottom)
+            bordersSet.push("bottom");
+        if (args.left)
+            bordersSet.push("left");
+        if (args.right)
+            bordersSet.push("right");
+        if (args.innerHorizontal)
+            bordersSet.push("innerHorizontal");
+        if (args.innerVertical)
+            bordersSet.push("innerVertical");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully updated borders for range ${rangeStr}. Borders set: ${bordersSet.join(", ")}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error updating borders: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}