@alanse/mcp-server-google-workspace 0.2.0

package/dist/tools/gdrive/gdrive_read_file.js

@@ -0,0 +1,77 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gdrive_read_file",
+    description: "Read contents of a file from Google Drive",
+    inputSchema: {
+        type: "object",
+        properties: {
+            fileId: {
+                type: "string",
+                description: "ID of the file to read",
+            },
+        },
+        required: ["fileId"],
+    },
+};
+const drive = google.drive("v3");
+export async function readFile(args) {
+    const result = await readGoogleDriveFile(args.fileId);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Contents of ${result.name}:\n\n${result.contents.text || result.contents.blob}`,
+            },
+        ],
+        isError: false,
+    };
+}
+async function readGoogleDriveFile(fileId) {
+    // First get file metadata to check mime type
+    const file = await drive.files.get({
+        fileId,
+        fields: "mimeType,name",
+    });
+    // For Google Docs/Sheets/etc we need to export
+    if (file.data.mimeType?.startsWith("application/vnd.google-apps")) {
+        let exportMimeType;
+        switch (file.data.mimeType) {
+            case "application/vnd.google-apps.document":
+                exportMimeType = "text/markdown";
+                break;
+            case "application/vnd.google-apps.spreadsheet":
+                exportMimeType = "text/csv";
+                break;
+            case "application/vnd.google-apps.presentation":
+                exportMimeType = "text/plain";
+                break;
+            case "application/vnd.google-apps.drawing":
+                exportMimeType = "image/png";
+                break;
+            default:
+                exportMimeType = "text/plain";
+        }
+        const res = await drive.files.export({ fileId, mimeType: exportMimeType }, { responseType: "text" });
+        return {
+            name: file.data.name || fileId,
+            contents: {
+                mimeType: exportMimeType,
+                text: res.data,
+            },
+        };
+    }
+    // For regular files download content
+    const res = await drive.files.get({ fileId, alt: "media" }, { responseType: "arraybuffer" });
+    const mimeType = file.data.mimeType || "application/octet-stream";
+    const isText = mimeType.startsWith("text/") || mimeType === "application/json";
+    const content = Buffer.from(res.data);
+    return {
+        name: file.data.name || fileId,
+        contents: {
+            mimeType,
+            ...(isText
+                ? { text: content.toString("utf-8") }
+                : { blob: content.toString("base64") }),
+        },
+    };
+}

package/dist/tools/gdrive/gdrive_search.js

@@ -0,0 +1,71 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gdrive_search",
+    description: "Search for files in Google Drive",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query",
+            },
+            pageToken: {
+                type: "string",
+                description: "Token for the next page of results",
+                optional: true,
+            },
+            pageSize: {
+                type: "number",
+                description: "Number of results per page (max 100)",
+                optional: true,
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function search(args) {
+    const drive = google.drive("v3");
+    const userQuery = args.query.trim();
+    let searchQuery = "";
+    // If query is empty, list all files
+    if (!userQuery) {
+        searchQuery = "trashed = false";
+    }
+    else {
+        // Escape special characters in the query
+        const escapedQuery = userQuery.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+        // Build search query with multiple conditions
+        const conditions = [];
+        // Search in title
+        conditions.push(`name contains '${escapedQuery}'`);
+        // If specific file type is mentioned in query, add mimeType condition
+        if (userQuery.toLowerCase().includes("sheet")) {
+            conditions.push("mimeType = 'application/vnd.google-sheets.spreadsheet'");
+        }
+        searchQuery = `(${conditions.join(" or ")}) and trashed = false`;
+    }
+    const res = await drive.files.list({
+        q: searchQuery,
+        pageSize: args.pageSize || 10,
+        pageToken: args.pageToken,
+        orderBy: "modifiedTime desc",
+        fields: "nextPageToken, files(id, name, mimeType, modifiedTime, size)",
+    });
+    const fileList = res.data.files
+        ?.map((file) => `${file.id} ${file.name} (${file.mimeType})`)
+        .join("\n");
+    let response = `Found ${res.data.files?.length ?? 0} files:\n${fileList}`;
+    // Add pagination info if there are more results
+    if (res.data.nextPageToken) {
+        response += `\n\nMore results available. Use pageToken: ${res.data.nextPageToken}`;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: response,
+            },
+        ],
+        isError: false,
+    };
+}

package/dist/tools/gdrive_read_file.js

@@ -0,0 +1,77 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gdrive_read_file",
+    description: "Read contents of a file from Google Drive",
+    inputSchema: {
+        type: "object",
+        properties: {
+            fileId: {
+                type: "string",
+                description: "ID of the file to read",
+            },
+        },
+        required: ["fileId"],
+    },
+};
+const drive = google.drive("v3");
+export async function readFile(args) {
+    const result = await readGoogleDriveFile(args.fileId);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Contents of ${result.name}:\n\n${result.contents.text || result.contents.blob}`,
+            },
+        ],
+        isError: false,
+    };
+}
+async function readGoogleDriveFile(fileId) {
+    // First get file metadata to check mime type
+    const file = await drive.files.get({
+        fileId,
+        fields: "mimeType,name",
+    });
+    // For Google Docs/Sheets/etc we need to export
+    if (file.data.mimeType?.startsWith("application/vnd.google-apps")) {
+        let exportMimeType;
+        switch (file.data.mimeType) {
+            case "application/vnd.google-apps.document":
+                exportMimeType = "text/markdown";
+                break;
+            case "application/vnd.google-apps.spreadsheet":
+                exportMimeType = "text/csv";
+                break;
+            case "application/vnd.google-apps.presentation":
+                exportMimeType = "text/plain";
+                break;
+            case "application/vnd.google-apps.drawing":
+                exportMimeType = "image/png";
+                break;
+            default:
+                exportMimeType = "text/plain";
+        }
+        const res = await drive.files.export({ fileId, mimeType: exportMimeType }, { responseType: "text" });
+        return {
+            name: file.data.name || fileId,
+            contents: {
+                mimeType: exportMimeType,
+                text: res.data,
+            },
+        };
+    }
+    // For regular files download content
+    const res = await drive.files.get({ fileId, alt: "media" }, { responseType: "arraybuffer" });
+    const mimeType = file.data.mimeType || "application/octet-stream";
+    const isText = mimeType.startsWith("text/") || mimeType === "application/json";
+    const content = Buffer.from(res.data);
+    return {
+        name: file.data.name || fileId,
+        contents: {
+            mimeType,
+            ...(isText
+                ? { text: content.toString("utf-8") }
+                : { blob: content.toString("base64") }),
+        },
+    };
+}

package/dist/tools/gdrive_search.js

@@ -0,0 +1,71 @@
+import { google } from "googleapis";
+export const schema = {
+    name: "gdrive_search",
+    description: "Search for files in Google Drive",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query",
+            },
+            pageToken: {
+                type: "string",
+                description: "Token for the next page of results",
+                optional: true,
+            },
+            pageSize: {
+                type: "number",
+                description: "Number of results per page (max 100)",
+                optional: true,
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function search(args) {
+    const drive = google.drive("v3");
+    const userQuery = args.query.trim();
+    let searchQuery = "";
+    // If query is empty, list all files
+    if (!userQuery) {
+        searchQuery = "trashed = false";
+    }
+    else {
+        // Escape special characters in the query
+        const escapedQuery = userQuery.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+        // Build search query with multiple conditions
+        const conditions = [];
+        // Search in title
+        conditions.push(`name contains '${escapedQuery}'`);
+        // If specific file type is mentioned in query, add mimeType condition
+        if (userQuery.toLowerCase().includes("sheet")) {
+            conditions.push("mimeType = 'application/vnd.google-sheets.spreadsheet'");
+        }
+        searchQuery = `(${conditions.join(" or ")}) and trashed = false`;
+    }
+    const res = await drive.files.list({
+        q: searchQuery,
+        pageSize: args.pageSize || 10,
+        pageToken: args.pageToken,
+        orderBy: "modifiedTime desc",
+        fields: "nextPageToken, files(id, name, mimeType, modifiedTime, size)",
+    });
+    const fileList = res.data.files
+        ?.map((file) => `${file.id} ${file.name} (${file.mimeType})`)
+        .join("\n");
+    let response = `Found ${res.data.files?.length ?? 0} files:\n${fileList}`;
+    // Add pagination info if there are more results
+    if (res.data.nextPageToken) {
+        response += `\n\nMore results available. Use pageToken: ${res.data.nextPageToken}`;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: response,
+            },
+        ],
+        isError: false,
+    };
+}

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