@alanse/mcp-server-google-workspace 0.2.0

package/dist/tools/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,
+        };
+    }
+}

package/dist/tools/gsheets_add_combo.js

@@ -0,0 +1,169 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_add_combo",
+    description: "Add a combo chart to a spreadsheet (combines multiple chart types like column and line)",
+    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)",
+            },
+            dataStartColumn: {
+                type: "number",
+                description: "Starting column of data range (0-based)",
+            },
+            dataEndColumn: {
+                type: "number",
+                description: "Ending column of data range (exclusive, 0-based)",
+            },
+            seriesTypes: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: ["COLUMN", "BAR", "LINE", "AREA"],
+                },
+                description: "Array of chart types for each series (optional, defaults to COLUMN for all)",
+            },
+            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", "dataStartColumn", "dataEndColumn"],
+    },
+};
+export async function addCombo(args) {
+    try {
+        const sheets = google.sheets("v4");
+        const series = [];
+        const numSeries = args.dataEndColumn - args.dataStartColumn - 1;
+        for (let i = 0; i < numSeries; i++) {
+            const seriesSpec = {
+                series: {
+                    sourceRange: {
+                        sources: [
+                            {
+                                sheetId: args.dataSheetId,
+                                startRowIndex: args.dataStartRow,
+                                endRowIndex: args.dataEndRow,
+                                startColumnIndex: args.dataStartColumn + 1 + i,
+                                endColumnIndex: args.dataStartColumn + 2 + i,
+                            },
+                        ],
+                    },
+                },
+            };
+            if (args.seriesTypes && args.seriesTypes[i]) {
+                seriesSpec.type = args.seriesTypes[i];
+            }
+            series.push(seriesSpec);
+        }
+        const basicChart = {
+            chartType: "COMBO",
+            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,
+            headerCount: 1,
+        };
+        const chartSpec = {
+            title: args.title || "Combo Chart",
+            basicChart,
+        };
+        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 combo chart. Chart ID: ${chartId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error creating combo chart: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/gsheets_add_conditional_format.js

@@ -0,0 +1,175 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_add_conditional_format",
+    description: "Add conditional formatting rules to cells",
+    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)",
+            },
+            rule: {
+                type: "object",
+                properties: {
+                    type: {
+                        type: "string",
+                        enum: ["NUMBER_GREATER", "NUMBER_LESS", "NUMBER_BETWEEN", "TEXT_CONTAINS", "TEXT_NOT_CONTAINS", "CUSTOM_FORMULA"],
+                        description: "The condition type",
+                    },
+                    value: {
+                        type: "string",
+                        description: "Value for comparison (for single value conditions)",
+                    },
+                    minValue: {
+                        type: "string",
+                        description: "Minimum value (for BETWEEN conditions)",
+                    },
+                    maxValue: {
+                        type: "string",
+                        description: "Maximum value (for BETWEEN conditions)",
+                    },
+                    formula: {
+                        type: "string",
+                        description: "Custom formula (for CUSTOM_FORMULA)",
+                    },
+                    backgroundColor: {
+                        type: "object",
+                        properties: {
+                            red: { type: "number", minimum: 0, maximum: 1 },
+                            green: { type: "number", minimum: 0, maximum: 1 },
+                            blue: { type: "number", minimum: 0, maximum: 1 },
+                        },
+                        description: "Background color to apply when condition is true",
+                    },
+                    textColor: {
+                        type: "object",
+                        properties: {
+                            red: { type: "number", minimum: 0, maximum: 1 },
+                            green: { type: "number", minimum: 0, maximum: 1 },
+                            blue: { type: "number", minimum: 0, maximum: 1 },
+                        },
+                        description: "Text color to apply when condition is true",
+                    },
+                    bold: {
+                        type: "boolean",
+                        description: "Make text bold when condition is true",
+                    },
+                    italic: {
+                        type: "boolean",
+                        description: "Make text italic when condition is true",
+                    },
+                },
+                required: ["type"],
+                description: "Conditional formatting rule",
+            },
+        },
+        required: ["spreadsheetId", "sheetId", "startRow", "endRow", "startColumn", "endColumn", "rule"],
+    },
+};
+export async function addConditionalFormat(args) {
+    try {
+        const sheets = google.sheets("v4");
+        const booleanCondition = {
+            type: args.rule.type,
+        };
+        // Set condition values based on type
+        if (args.rule.type === "NUMBER_BETWEEN") {
+            booleanCondition.values = [
+                { userEnteredValue: args.rule.minValue },
+                { userEnteredValue: args.rule.maxValue },
+            ];
+        }
+        else if (args.rule.type === "CUSTOM_FORMULA") {
+            booleanCondition.values = [{ userEnteredValue: args.rule.formula }];
+        }
+        else if (args.rule.value) {
+            booleanCondition.values = [{ userEnteredValue: args.rule.value }];
+        }
+        // Build format to apply
+        const format = {};
+        if (args.rule.backgroundColor) {
+            format.backgroundColor = args.rule.backgroundColor;
+        }
+        if (args.rule.textColor || args.rule.bold || args.rule.italic) {
+            format.textFormat = {};
+            if (args.rule.textColor) {
+                format.textFormat.foregroundColor = args.rule.textColor;
+            }
+            if (args.rule.bold !== undefined) {
+                format.textFormat.bold = args.rule.bold;
+            }
+            if (args.rule.italic !== undefined) {
+                format.textFormat.italic = args.rule.italic;
+            }
+        }
+        await sheets.spreadsheets.batchUpdate({
+            spreadsheetId: args.spreadsheetId,
+            requestBody: {
+                requests: [
+                    {
+                        addConditionalFormatRule: {
+                            rule: {
+                                ranges: [
+                                    {
+                                        sheetId: args.sheetId,
+                                        startRowIndex: args.startRow,
+                                        endRowIndex: args.endRow,
+                                        startColumnIndex: args.startColumn,
+                                        endColumnIndex: args.endColumn,
+                                    },
+                                ],
+                                booleanRule: {
+                                    condition: booleanCondition,
+                                    format,
+                                },
+                            },
+                            index: 0,
+                        },
+                    },
+                ],
+            },
+        });
+        const rangeStr = `R${args.startRow}C${args.startColumn}:R${args.endRow - 1}C${args.endColumn - 1}`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully added conditional formatting rule (${args.rule.type}) for range ${rangeStr}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error adding conditional format: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/gsheets_add_histogram.js

@@ -0,0 +1,143 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_add_histogram",
+    description: "Add a histogram 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",
+            },
+            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)",
+            },
+            bucketSize: {
+                type: "number",
+                description: "The size of histogram buckets (optional)",
+            },
+            outlierPercentile: {
+                type: "number",
+                description: "Percentile to use for outlier detection (optional, 0-1)",
+            },
+            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", "dataStartColumn", "dataEndColumn"],
+    },
+};
+export async function addHistogram(args) {
+    try {
+        const sheets = google.sheets("v4");
+        const histogramChart = {
+            legendPosition: "BOTTOM_LEGEND",
+            series: [
+                {
+                    sourceRange: {
+                        sources: [
+                            {
+                                sheetId: args.dataSheetId,
+                                startRowIndex: args.dataStartRow,
+                                endRowIndex: args.dataEndRow,
+                                startColumnIndex: args.dataStartColumn,
+                                endColumnIndex: args.dataEndColumn,
+                            },
+                        ],
+                    },
+                },
+            ],
+        };
+        if (args.bucketSize !== undefined) {
+            histogramChart.bucketSize = args.bucketSize;
+        }
+        if (args.outlierPercentile !== undefined) {
+            histogramChart.outlierPercentile = args.outlierPercentile;
+        }
+        const chartSpec = {
+            title: args.title || "Histogram",
+            histogramChart,
+        };
+        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 histogram chart. Chart ID: ${chartId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error creating histogram: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}