@alanse/mcp-server-google-workspace 0.2.0

package/dist/tools/basic/gsheets_rename_sheet.js

@@ -0,0 +1,64 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_rename_sheet",
+    description: "Rename a sheet 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 to rename",
+            },
+            newTitle: {
+                type: "string",
+                description: "The new title for the sheet",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "newTitle"],
+    },
+};
+export async function renameSheet(args) {
+    try {
+        const sheets = google.sheets("v4");
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        updateSheetProperties: {
+                            properties: {
+                                sheetId: args.sheetId,
+                                title: args.newTitle,
+                            },
+                            fields: "title",
+                        },
+                    },
+                ],
+            },
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully renamed sheet ${args.sheetId} to "${args.newTitle}"`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error renaming sheet: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/charts/gsheets_add_bubble.js

@@ -0,0 +1,176 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_add_bubble",
+    description: "Add a bubble chart to a spreadsheet (displays 3D data with bubble size)",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet where the chart will be placed",
+            },
+            title: {
+                type: "string",
+                description: "Chart title (optional)",
+            },
+            dataSheetId: {
+                type: "number",
+                description: "The sheet ID containing the data",
+            },
+            dataStartRow: {
+                type: "number",
+                description: "Starting row of data range (0-based)",
+            },
+            dataEndRow: {
+                type: "number",
+                description: "Ending row of data range (exclusive, 0-based)",
+            },
+            labelsColumn: {
+                type: "number",
+                description: "Column index for labels (0-based, optional)",
+            },
+            xValuesColumn: {
+                type: "number",
+                description: "Column index for X-axis values (0-based)",
+            },
+            yValuesColumn: {
+                type: "number",
+                description: "Column index for Y-axis values (0-based)",
+            },
+            sizeColumn: {
+                type: "number",
+                description: "Column index for bubble size values (0-based)",
+            },
+            position: {
+                type: "object",
+                properties: {
+                    overlayRow: {
+                        type: "number",
+                        description: "Row position for chart overlay (0-based)",
+                    },
+                    overlayColumn: {
+                        type: "number",
+                        description: "Column position for chart overlay (0-based)",
+                    },
+                },
+                description: "Chart position (optional)",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "dataSheetId", "dataStartRow", "dataEndRow", "xValuesColumn", "yValuesColumn", "sizeColumn"],
+    },
+};
+export async function addBubble(args) {
+    try {
+        const sheets = google.sheets("v4");
+        const bubbleChart = {
+            legendPosition: "BOTTOM_LEGEND",
+            domain: {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.xValuesColumn,
+                            endColumnIndex: args.xValuesColumn + 1,
+                        },
+                    ],
+                },
+            },
+            series: {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.yValuesColumn,
+                            endColumnIndex: args.yValuesColumn + 1,
+                        },
+                    ],
+                },
+            },
+            bubbleSizes: {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.sizeColumn,
+                            endColumnIndex: args.sizeColumn + 1,
+                        },
+                    ],
+                },
+            },
+        };
+        if (args.labelsColumn !== undefined) {
+            bubbleChart.bubbleLabels = {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.labelsColumn,
+                            endColumnIndex: args.labelsColumn + 1,
+                        },
+                    ],
+                },
+            };
+        }
+        const chartSpec = {
+            title: args.title || "Bubble Chart",
+            bubbleChart,
+        };
+        const position = {
+            overlayPosition: {
+                anchorCell: {
+                    sheetId: args.sheetId,
+                    rowIndex: args.position?.overlayRow || 0,
+                    columnIndex: args.position?.overlayColumn || 0,
+                },
+            },
+        };
+        const response = await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        addChart: {
+                            chart: {
+                                spec: chartSpec,
+                                position,
+                            },
+                        },
+                    },
+                ],
+            },
+        });
+        const chartId = response.data.replies?.[0]?.addChart?.chart?.chartId;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully created bubble chart. Chart ID: ${chartId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error creating bubble chart: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/charts/gsheets_add_candlestick.js

@@ -0,0 +1,192 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_add_candlestick",
+    description: "Add a candlestick chart to a spreadsheet (for financial data with open/high/low/close values)",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet where the chart will be placed",
+            },
+            title: {
+                type: "string",
+                description: "Chart title (optional)",
+            },
+            dataSheetId: {
+                type: "number",
+                description: "The sheet ID containing the data",
+            },
+            dataStartRow: {
+                type: "number",
+                description: "Starting row of data range (0-based)",
+            },
+            dataEndRow: {
+                type: "number",
+                description: "Ending row of data range (exclusive, 0-based)",
+            },
+            domainColumn: {
+                type: "number",
+                description: "Column index for domain/labels (0-based)",
+            },
+            lowColumn: {
+                type: "number",
+                description: "Column index for low values (0-based)",
+            },
+            openColumn: {
+                type: "number",
+                description: "Column index for open values (0-based)",
+            },
+            closeColumn: {
+                type: "number",
+                description: "Column index for close values (0-based)",
+            },
+            highColumn: {
+                type: "number",
+                description: "Column index for high values (0-based)",
+            },
+            position: {
+                type: "object",
+                properties: {
+                    overlayRow: {
+                        type: "number",
+                        description: "Row position for chart overlay (0-based)",
+                    },
+                    overlayColumn: {
+                        type: "number",
+                        description: "Column position for chart overlay (0-based)",
+                    },
+                },
+                description: "Chart position (optional)",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "dataSheetId", "dataStartRow", "dataEndRow", "domainColumn", "lowColumn", "openColumn", "closeColumn", "highColumn"],
+    },
+};
+export async function addCandlestick(args) {
+    try {
+        const sheets = google.sheets("v4");
+        const candlestickChart = {
+            domain: {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.domainColumn,
+                            endColumnIndex: args.domainColumn + 1,
+                        },
+                    ],
+                },
+            },
+            data: [
+                {
+                    sourceRange: {
+                        sources: [
+                            {
+                                sheetId: args.dataSheetId,
+                                startRowIndex: args.dataStartRow,
+                                endRowIndex: args.dataEndRow,
+                                startColumnIndex: args.lowColumn,
+                                endColumnIndex: args.lowColumn + 1,
+                            },
+                        ],
+                    },
+                },
+                {
+                    sourceRange: {
+                        sources: [
+                            {
+                                sheetId: args.dataSheetId,
+                                startRowIndex: args.dataStartRow,
+                                endRowIndex: args.dataEndRow,
+                                startColumnIndex: args.openColumn,
+                                endColumnIndex: args.openColumn + 1,
+                            },
+                        ],
+                    },
+                },
+                {
+                    sourceRange: {
+                        sources: [
+                            {
+                                sheetId: args.dataSheetId,
+                                startRowIndex: args.dataStartRow,
+                                endRowIndex: args.dataEndRow,
+                                startColumnIndex: args.closeColumn,
+                                endColumnIndex: args.closeColumn + 1,
+                            },
+                        ],
+                    },
+                },
+                {
+                    sourceRange: {
+                        sources: [
+                            {
+                                sheetId: args.dataSheetId,
+                                startRowIndex: args.dataStartRow,
+                                endRowIndex: args.dataEndRow,
+                                startColumnIndex: args.highColumn,
+                                endColumnIndex: args.highColumn + 1,
+                            },
+                        ],
+                    },
+                },
+            ],
+        };
+        const chartSpec = {
+            title: args.title || "Candlestick Chart",
+            candlestickChart,
+        };
+        const position = {
+            overlayPosition: {
+                anchorCell: {
+                    sheetId: args.sheetId,
+                    rowIndex: args.position?.overlayRow || 0,
+                    columnIndex: args.position?.overlayColumn || 0,
+                },
+            },
+        };
+        const response = await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        addChart: {
+                            chart: {
+                                spec: chartSpec,
+                                position,
+                            },
+                        },
+                    },
+                ],
+            },
+        });
+        const chartId = response.data.replies?.[0]?.addChart?.chart?.chartId;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully created candlestick chart. Chart ID: ${chartId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error creating candlestick chart: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/charts/gsheets_add_chart.js

@@ -0,0 +1,162 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_add_chart",
+    description: "Add a chart to a spreadsheet",
+    inputSchema: {
+        type: "object",
+        properties: {
+            spreadsheetId: {
+                type: "string",
+                description: "The ID of the spreadsheet",
+            },
+            sheetId: {
+                type: "number",
+                description: "The ID of the sheet where the chart will be placed",
+            },
+            chartType: {
+                type: "string",
+                enum: ["COLUMN", "BAR", "LINE", "AREA", "PIE", "SCATTER"],
+                description: "The type of chart to create",
+            },
+            title: {
+                type: "string",
+                description: "Chart title (optional)",
+            },
+            dataSheetId: {
+                type: "number",
+                description: "The sheet ID containing the data",
+            },
+            dataStartRow: {
+                type: "number",
+                description: "Starting row of data range (0-based)",
+            },
+            dataEndRow: {
+                type: "number",
+                description: "Ending row of data range (exclusive, 0-based)",
+            },
+            dataStartColumn: {
+                type: "number",
+                description: "Starting column of data range (0-based)",
+            },
+            dataEndColumn: {
+                type: "number",
+                description: "Ending column of data range (exclusive, 0-based)",
+            },
+            position: {
+                type: "object",
+                properties: {
+                    overlayRow: {
+                        type: "number",
+                        description: "Row position for chart overlay (0-based)",
+                    },
+                    overlayColumn: {
+                        type: "number",
+                        description: "Column position for chart overlay (0-based)",
+                    },
+                },
+                description: "Chart position (optional, defaults to top-left)",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "chartType", "dataSheetId", "dataStartRow", "dataEndRow", "dataStartColumn", "dataEndColumn"],
+    },
+};
+export async function addChart(args) {
+    try {
+        const sheets = google.sheets("v4");
+        const chartSpec = {
+            title: args.title || "Chart",
+            basicChart: {
+                chartType: args.chartType,
+                legendPosition: "BOTTOM_LEGEND",
+                axis: [
+                    {
+                        position: "BOTTOM_AXIS",
+                    },
+                    {
+                        position: "LEFT_AXIS",
+                    },
+                ],
+                domains: [
+                    {
+                        domain: {
+                            sourceRange: {
+                                sources: [
+                                    {
+                                        sheetId: args.dataSheetId,
+                                        startRowIndex: args.dataStartRow,
+                                        endRowIndex: args.dataEndRow,
+                                        startColumnIndex: args.dataStartColumn,
+                                        endColumnIndex: args.dataStartColumn + 1,
+                                    },
+                                ],
+                            },
+                        },
+                    },
+                ],
+                series: [
+                    {
+                        series: {
+                            sourceRange: {
+                                sources: [
+                                    {
+                                        sheetId: args.dataSheetId,
+                                        startRowIndex: args.dataStartRow,
+                                        endRowIndex: args.dataEndRow,
+                                        startColumnIndex: args.dataStartColumn + 1,
+                                        endColumnIndex: args.dataEndColumn,
+                                    },
+                                ],
+                            },
+                        },
+                    },
+                ],
+                headerCount: 1,
+            },
+        };
+        const position = {
+            overlayPosition: {
+                anchorCell: {
+                    sheetId: args.sheetId,
+                    rowIndex: args.position?.overlayRow || 0,
+                    columnIndex: args.position?.overlayColumn || 0,
+                },
+            },
+        };
+        const response = await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        addChart: {
+                            chart: {
+                                spec: chartSpec,
+                                position,
+                            },
+                        },
+                    },
+                ],
+            },
+        });
+        const chartId = response.data.replies?.[0]?.addChart?.chart?.chartId;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully created ${args.chartType} chart. Chart ID: ${chartId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error creating chart: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}