@alanse/mcp-server-google-workspace 0.2.0

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

package/dist/tools/charts/gsheets_add_org_chart.js

@@ -0,0 +1,160 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_add_org_chart",
+    description: "Add an organizational chart to a spreadsheet (displays hierarchical relationships)",
+    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 node labels (0-based)",
+            },
+            parentLabelsColumn: {
+                type: "number",
+                description: "Column index for parent labels (0-based, optional for root nodes)",
+            },
+            tooltipsColumn: {
+                type: "number",
+                description: "Column index for tooltips (0-based, optional)",
+            },
+            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", "labelsColumn"],
+    },
+};
+export async function addOrgChart(args) {
+    try {
+        const sheets = google.sheets("v4");
+        const orgChart = {
+            labels: {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.labelsColumn,
+                            endColumnIndex: args.labelsColumn + 1,
+                        },
+                    ],
+                },
+            },
+        };
+        if (args.parentLabelsColumn !== undefined) {
+            orgChart.parentLabels = {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.parentLabelsColumn,
+                            endColumnIndex: args.parentLabelsColumn + 1,
+                        },
+                    ],
+                },
+            };
+        }
+        if (args.tooltipsColumn !== undefined) {
+            orgChart.tooltips = {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.tooltipsColumn,
+                            endColumnIndex: args.tooltipsColumn + 1,
+                        },
+                    ],
+                },
+            };
+        }
+        const chartSpec = {
+            title: args.title || "Organizational Chart",
+            orgChart,
+        };
+        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 organizational chart. Chart ID: ${chartId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error creating organizational chart: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}

package/dist/tools/charts/gsheets_add_treemap.js

@@ -0,0 +1,177 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gsheets_add_treemap",
+    description: "Add a treemap chart to a spreadsheet (displays hierarchical data as nested rectangles)",
+    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)",
+            },
+            parentLabelsColumn: {
+                type: "number",
+                description: "Column index for parent labels (0-based, optional)",
+            },
+            sizeColumn: {
+                type: "number",
+                description: "Column index for size values (0-based)",
+            },
+            colorColumn: {
+                type: "number",
+                description: "Column index for color values (0-based, optional)",
+            },
+            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", "labelsColumn", "sizeColumn"],
+    },
+};
+export async function addTreemap(args) {
+    try {
+        const sheets = google.sheets("v4");
+        const treemapChart = {
+            labels: {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.labelsColumn,
+                            endColumnIndex: args.labelsColumn + 1,
+                        },
+                    ],
+                },
+            },
+            sizeData: {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.sizeColumn,
+                            endColumnIndex: args.sizeColumn + 1,
+                        },
+                    ],
+                },
+            },
+        };
+        if (args.parentLabelsColumn !== undefined) {
+            treemapChart.parentLabels = {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.parentLabelsColumn,
+                            endColumnIndex: args.parentLabelsColumn + 1,
+                        },
+                    ],
+                },
+            };
+        }
+        if (args.colorColumn !== undefined) {
+            treemapChart.colorData = {
+                sourceRange: {
+                    sources: [
+                        {
+                            sheetId: args.dataSheetId,
+                            startRowIndex: args.dataStartRow,
+                            endRowIndex: args.dataEndRow,
+                            startColumnIndex: args.colorColumn,
+                            endColumnIndex: args.colorColumn + 1,
+                        },
+                    ],
+                },
+            };
+        }
+        const chartSpec = {
+            title: args.title || "Treemap Chart",
+            treemapChart,
+        };
+        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 treemap chart. Chart ID: ${chartId}`,
+                },
+            ],
+            isError: false,
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error creating treemap chart: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}