@alanse/mcp-server-google-workspace 1.0.0 → 1.0.2

package/dist/tools/gmail/send/gmail_send_message.js

@@ -0,0 +1,109 @@
+import { google } from "googleapis";
+import { ResponseFormatter } from "../../../lib/response-formatter.js";
+import { prepareGmailMessage, generateGmailWebUrl, } from "../../../lib/gmail-helpers.js";
+export const schema = {
+    name: "gmail_send_message",
+    description: "Send an email message via Gmail. Supports plain text or HTML body, CC/BCC recipients, and threading (replies). The message will be sent immediately.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            to: {
+                type: "string",
+                description: "Recipient email address(es). Multiple addresses can be comma-separated.",
+            },
+            subject: {
+                type: "string",
+                description: "Email subject line",
+            },
+            body: {
+                type: "string",
+                description: "Email body content (plain text or HTML)",
+            },
+            bodyFormat: {
+                type: "string",
+                enum: ["plain", "html"],
+                description: "Body format type (default: plain)",
+                optional: true,
+            },
+            cc: {
+                type: "string",
+                description: "CC recipient(s). Multiple addresses can be comma-separated.",
+                optional: true,
+            },
+            bcc: {
+                type: "string",
+                description: "BCC recipient(s). Multiple addresses can be comma-separated.",
+                optional: true,
+            },
+            threadId: {
+                type: "string",
+                description: "Thread ID to reply to (makes this a reply in an existing conversation)",
+                optional: true,
+            },
+            inReplyTo: {
+                type: "string",
+                description: "Message-ID header of the message being replied to (for threading)",
+                optional: true,
+            },
+            references: {
+                type: "string",
+                description: "References header for email threading (space-separated Message-IDs)",
+                optional: true,
+            },
+        },
+        required: ["to", "subject", "body"],
+    },
+};
+export async function sendMessage(args) {
+    try {
+        const gmail = google.gmail("v1");
+        const { to, subject, body, bodyFormat = "plain", cc, bcc, threadId, inReplyTo, references, } = args;
+        // Prepare base64url encoded MIME message
+        const encodedMessage = prepareGmailMessage({
+            to,
+            subject,
+            body,
+            bodyFormat,
+            cc,
+            bcc,
+            inReplyTo,
+            references,
+        });
+        // Send the message
+        const response = await gmail.users.messages.send({
+            userId: "me",
+            requestBody: {
+                raw: encodedMessage,
+                threadId: threadId || undefined,
+            },
+        });
+        const sentMessage = response.data;
+        const messageId = sentMessage.id || "";
+        const sentThreadId = sentMessage.threadId || "";
+        let output = `✅ Message sent successfully!\n\n`;
+        output += `Message ID: ${messageId}\n`;
+        output += `Thread ID: ${sentThreadId}\n`;
+        output += `Web URL: ${generateGmailWebUrl(messageId)}\n\n`;
+        output += `📧 Details:\n`;
+        output += `  To: ${to}\n`;
+        if (cc)
+            output += `  CC: ${cc}\n`;
+        if (bcc)
+            output += `  BCC: ${bcc}\n`;
+        output += `  Subject: ${subject}\n`;
+        output += `  Format: ${bodyFormat}\n`;
+        if (threadId)
+            output += `  Reply to thread: ${threadId}\n`;
+        return ResponseFormatter.success({
+            messageId,
+            threadId: sentThreadId,
+            labelIds: sentMessage.labelIds || [],
+            to,
+            subject,
+            bodyFormat,
+        }, output);
+    }
+    catch (error) {
+        return ResponseFormatter.error(error);
+    }
+}

package/dist/tools/index.js

@@ -1,6 +1,29 @@
-// Drive operations
-import { schema as driveSearchSchema, search } from './drive/drive_search.js';
-import { schema as driveReadFileSchema, readFile } from './drive/drive_read_file.js';
+// Drive - Basic operations
+import { schema as driveSearchSchema, search } from './drive/basic/drive_search.js';
+import { schema as driveReadFileSchema, readFile } from './drive/basic/drive_read_file.js';
+import { schema as driveListFilesSchema, listFiles } from './drive/basic/drive_list_files.js';
+import { schema as driveGetMetadataSchema, getMetadata as driveGetMetadata } from './drive/basic/drive_get_metadata.js';
+// Drive - File operations
+import { schema as driveUploadFileSchema, uploadFile } from './drive/file/drive_upload_file.js';
+import { schema as driveCreateFileSchema, createFile } from './drive/file/drive_create_file.js';
+import { schema as driveDeleteFileSchema, deleteFile } from './drive/file/drive_delete_file.js';
+import { schema as driveCopyFileSchema, copyFile } from './drive/file/drive_copy_file.js';
+import { schema as driveMoveFileSchema, moveFile } from './drive/file/drive_move_file.js';
+import { schema as driveRenameFileSchema, renameFile } from './drive/file/drive_rename_file.js';
+import { schema as driveUpdateFileSchema, updateFile } from './drive/file/drive_update_file.js';
+// Drive - Folder operations
+import { schema as driveCreateFolderSchema, createFolder } from './drive/folder/drive_create_folder.js';
+import { schema as driveListFolderContentsSchema, listFolderContents } from './drive/folder/drive_list_folder_contents.js';
+import { schema as driveMoveToFolderSchema, moveToFolder } from './drive/folder/drive_move_to_folder.js';
+// Drive - Permissions operations
+import { schema as driveShareFileSchema, shareFile } from './drive/permissions/drive_share_file.js';
+import { schema as driveListPermissionsSchema, listPermissions } from './drive/permissions/drive_list_permissions.js';
+import { schema as driveUpdatePermissionSchema, updatePermission } from './drive/permissions/drive_update_permission.js';
+import { schema as driveRemovePermissionSchema, removePermission } from './drive/permissions/drive_remove_permission.js';
+// Drive - Advanced operations
+import { schema as driveExportFileSchema, exportFile } from './drive/advanced/drive_export_file.js';
+import { schema as driveListRevisionsSchema, listRevisions } from './drive/advanced/drive_list_revisions.js';
+import { schema as driveEmptyTrashSchema, emptyTrash } from './drive/advanced/drive_empty_trash.js';
 // Basic operations
 import { schema as gsheetsReadSchema, readSheet } from './sheets/basic/gsheets_read.js';
 import { schema as gsheetsListSheetsSchema, listSheets } from './sheets/basic/gsheets_list_sheets.js';
@@ -88,7 +111,49 @@ import { schema as gdocsBatchUpdateSchema, batchUpdate as gdocsBatchUpdate } fro
 import { schema as gdocsMergeDocumentsSchema, mergeDocuments } from './docs/elements/gdocs_merge_documents.js';
 import { schema as gdocsExportSchema, exportDocument } from './docs/elements/gdocs_export.js';
 import { schema as gdocsSuggestModeSchema, suggestMode } from './docs/elements/gdocs_suggest_mode.js';
+// Gmail - Basic operations
+import { schema as gmailListLabelsSchema, listLabels } from './gmail/basic/gmail_list_labels.js';
+import { schema as gmailSearchMessagesSchema, searchMessages } from './gmail/basic/gmail_search_messages.js';
+import { schema as gmailGetMessageSchema, getMessage } from './gmail/basic/gmail_get_message.js';
+import { schema as gmailGetThreadSchema, getThread } from './gmail/basic/gmail_get_thread.js';
+// Gmail - Labels operations
+import { schema as gmailModifyLabelsSchema, modifyLabels } from './gmail/labels/gmail_modify_labels.js';
+import { schema as gmailManageLabelSchema, manageLabel } from './gmail/labels/gmail_manage_label.js';
+// Gmail - Send operations
+import { schema as gmailSendMessageSchema, sendMessage } from './gmail/send/gmail_send_message.js';
+import { schema as gmailDraftMessageSchema, draftMessage } from './gmail/send/gmail_draft_message.js';
+// Gmail - Batch operations
+import { schema as gmailGetMessagesBatchSchema, getMessagesBatch } from './gmail/batch/gmail_get_messages_batch.js';
+import { schema as gmailGetThreadsBatchSchema, getThreadsBatch } from './gmail/batch/gmail_get_threads_batch.js';
+import { schema as gmailBatchModifyLabelsSchema, batchModifyLabels } from './gmail/batch/gmail_batch_modify_labels.js';
+// Calendar - Basic operations
+import { schema as calendarListEventsSchema, listEvents } from './calendar/basic/calendar_list_events.js';
+import { schema as calendarGetEventSchema, getEvent } from './calendar/basic/calendar_get_event.js';
+import { schema as calendarCreateEventSchema, createEvent } from './calendar/basic/calendar_create_event.js';
+import { schema as calendarUpdateEventSchema, updateEvent } from './calendar/basic/calendar_update_event.js';
+import { schema as calendarDeleteEventSchema, deleteEvent } from './calendar/basic/calendar_delete_event.js';
+// Calendar - Free/busy operations
+import { schema as calendarFreeBusyQuerySchema, queryFreeBusy } from './calendar/freebusy/calendar_freebusy_query.js';
+// Calendar - CalendarList operations
+import { schema as calendarListListSchema, listCalendarList } from './calendar/calendarlist/calendar_calendarlist_list.js';
+import { schema as calendarListGetSchema, getCalendarListEntry } from './calendar/calendarlist/calendar_calendarlist_get.js';
+// Calendar - Events advanced operations
+import { schema as calendarEventsQuickAddSchema, quickAddEvent } from './calendar/events_advanced/calendar_events_quickadd.js';
+import { schema as calendarEventsInstancesSchema, listEventInstances } from './calendar/events_advanced/calendar_events_instances.js';
+import { schema as calendarEventsMoveSchema, moveEvent } from './calendar/events_advanced/calendar_events_move.js';
+// Calendar - Colors operations
+import { schema as calendarColorsGetSchema, getColors } from './calendar/colors/calendar_colors_get.js';
+// Calendar - Calendars operations
+import { schema as calendarCalendarsInsertSchema, insertCalendar } from './calendar/calendars/calendar_calendars_insert.js';
+import { schema as calendarCalendarsGetSchema, getCalendar } from './calendar/calendars/calendar_calendars_get.js';
+import { schema as calendarCalendarsUpdateSchema, updateCalendar } from './calendar/calendars/calendar_calendars_update.js';
+// Calendar - ACL operations
+import { schema as calendarAclListSchema, listAcl } from './calendar/acl/calendar_acl_list.js';
+import { schema as calendarAclInsertSchema, insertAcl } from './calendar/acl/calendar_acl_insert.js';
+// Calendar - Settings operations
+import { schema as calendarSettingsListSchema, listSettings } from './calendar/settings/calendar_settings_list.js';
 export const tools = [
+    // Drive - Basic operations
     {
         ...driveSearchSchema,
         handler: search,
@@ -97,6 +162,87 @@ export const tools = [
         ...driveReadFileSchema,
         handler: readFile,
     },
+    {
+        ...driveListFilesSchema,
+        handler: listFiles,
+    },
+    {
+        ...driveGetMetadataSchema,
+        handler: driveGetMetadata,
+    },
+    // Drive - File operations
+    {
+        ...driveUploadFileSchema,
+        handler: uploadFile,
+    },
+    {
+        ...driveCreateFileSchema,
+        handler: createFile,
+    },
+    {
+        ...driveDeleteFileSchema,
+        handler: deleteFile,
+    },
+    {
+        ...driveCopyFileSchema,
+        handler: copyFile,
+    },
+    {
+        ...driveMoveFileSchema,
+        handler: moveFile,
+    },
+    {
+        ...driveRenameFileSchema,
+        handler: renameFile,
+    },
+    {
+        ...driveUpdateFileSchema,
+        handler: updateFile,
+    },
+    // Drive - Folder operations
+    {
+        ...driveCreateFolderSchema,
+        handler: createFolder,
+    },
+    {
+        ...driveListFolderContentsSchema,
+        handler: listFolderContents,
+    },
+    {
+        ...driveMoveToFolderSchema,
+        handler: moveToFolder,
+    },
+    // Drive - Permissions operations
+    {
+        ...driveShareFileSchema,
+        handler: shareFile,
+    },
+    {
+        ...driveListPermissionsSchema,
+        handler: listPermissions,
+    },
+    {
+        ...driveUpdatePermissionSchema,
+        handler: updatePermission,
+    },
+    {
+        ...driveRemovePermissionSchema,
+        handler: removePermission,
+    },
+    // Drive - Advanced operations
+    {
+        ...driveExportFileSchema,
+        handler: exportFile,
+    },
+    {
+        ...driveListRevisionsSchema,
+        handler: listRevisions,
+    },
+    {
+        ...driveEmptyTrashSchema,
+        handler: emptyTrash,
+    },
+    // Google Sheets - Basic operations
     {
         ...gsheetsUpdateCellSchema,
         handler: updateCell,
@@ -409,5 +555,123 @@ export const tools = [
     {
         ...gdocsSuggestModeSchema,
         handler: suggestMode,
+    },
+    // Gmail tools
+    {
+        ...gmailListLabelsSchema,
+        handler: listLabels,
+    },
+    {
+        ...gmailSearchMessagesSchema,
+        handler: searchMessages,
+    },
+    {
+        ...gmailGetMessageSchema,
+        handler: getMessage,
+    },
+    {
+        ...gmailGetThreadSchema,
+        handler: getThread,
+    },
+    {
+        ...gmailModifyLabelsSchema,
+        handler: modifyLabels,
+    },
+    {
+        ...gmailManageLabelSchema,
+        handler: manageLabel,
+    },
+    {
+        ...gmailSendMessageSchema,
+        handler: sendMessage,
+    },
+    {
+        ...gmailDraftMessageSchema,
+        handler: draftMessage,
+    },
+    {
+        ...gmailGetMessagesBatchSchema,
+        handler: getMessagesBatch,
+    },
+    {
+        ...gmailGetThreadsBatchSchema,
+        handler: getThreadsBatch,
+    },
+    {
+        ...gmailBatchModifyLabelsSchema,
+        handler: batchModifyLabels,
+    },
+    // Calendar tools
+    {
+        ...calendarListEventsSchema,
+        handler: listEvents,
+    },
+    {
+        ...calendarGetEventSchema,
+        handler: getEvent,
+    },
+    {
+        ...calendarCreateEventSchema,
+        handler: createEvent,
+    },
+    {
+        ...calendarUpdateEventSchema,
+        handler: updateEvent,
+    },
+    {
+        ...calendarDeleteEventSchema,
+        handler: deleteEvent,
+    },
+    {
+        ...calendarFreeBusyQuerySchema,
+        handler: queryFreeBusy,
+    },
+    {
+        ...calendarListListSchema,
+        handler: listCalendarList,
+    },
+    {
+        ...calendarListGetSchema,
+        handler: getCalendarListEntry,
+    },
+    {
+        ...calendarEventsQuickAddSchema,
+        handler: quickAddEvent,
+    },
+    {
+        ...calendarEventsInstancesSchema,
+        handler: listEventInstances,
+    },
+    {
+        ...calendarEventsMoveSchema,
+        handler: moveEvent,
+    },
+    {
+        ...calendarColorsGetSchema,
+        handler: getColors,
+    },
+    {
+        ...calendarCalendarsInsertSchema,
+        handler: insertCalendar,
+    },
+    {
+        ...calendarCalendarsGetSchema,
+        handler: getCalendar,
+    },
+    {
+        ...calendarCalendarsUpdateSchema,
+        handler: updateCalendar,
+    },
+    {
+        ...calendarAclListSchema,
+        handler: listAcl,
+    },
+    {
+        ...calendarAclInsertSchema,
+        handler: insertAcl,
+    },
+    {
+        ...calendarSettingsListSchema,
+        handler: listSettings,
     }
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alanse/mcp-server-google-workspace",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "The most comprehensive MCP server for Google Workspace - Complete integration for Sheets (57 tools), Drive, and future Docs, Calendar, Forms support",
   "license": "Elastic-2.0",
   "author": "Alanse inc",
@@ -39,16 +39,21 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
   },
   "dependencies": {
     "@google-cloud/local-auth": "^3.0.1",
     "@modelcontextprotocol/sdk": "0.5.0",
     "dotenv": "^16.5.0",
-    "googleapis": "^144.0.0"
+    "googleapis": "^144.0.0",
+    "nodemailer": "^6.9.16",
+    "html-to-text": "^9.0.5"
   },
   "devDependencies": {
     "@types/node": "^22.9.3",
+    "@types/nodemailer": "^6.4.17",
+    "@types/html-to-text": "^9.0.4",
     "@vitest/ui": "^4.0.16",
     "shx": "^0.3.4",
     "typescript": "^5.6.2",

package/dist/tools/basic/gsheets_add_sheet.js

@@ -1,65 +0,0 @@
-import { google } from "googleapis";
-export const schema = {
-    name: "gsheets_add_sheet",
-    description: "Add a new sheet (tab) to a Google Spreadsheet",
-    inputSchema: {
-        type: "object",
-        properties: {
-            spreadsheetId: {
-                type: "string",
-                description: "The ID of the spreadsheet",
-            },
-            title: {
-                type: "string",
-                description: "The name of the new sheet",
-            },
-            index: {
-                type: "number",
-                description: "Optional position index (0-based) where the sheet should be inserted",
-            },
-        },
-        required: ["spreadsheetId", "title"],
-    },
-};
-export async function addSheet(args) {
-    try {
-        const sheets = google.sheets("v4");
-        const request = {
-            addSheet: {
-                properties: {
-                    title: args.title,
-                },
-            },
-        };
-        if (args.index !== undefined) {
-            request.addSheet.properties.index = args.index;
-        }
-        const response = await sheets.spreadsheets.batchUpdate({
-            spreadsheetId: args.spreadsheetId,
-            requestBody: {
-                requests: [request],
-            },
-        });
-        const addedSheet = response.data.replies?.[0]?.addSheet?.properties;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Successfully added sheet "${addedSheet?.title}" (ID: ${addedSheet?.sheetId}, Index: ${addedSheet?.index})`,
-                },
-            ],
-            isError: false,
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error adding sheet: ${error.message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}

package/dist/tools/basic/gsheets_copy_sheet.js

@@ -1,56 +0,0 @@
-import { google } from "googleapis";
-export const schema = {
-    name: "gsheets_copy_sheet",
-    description: "Copy a sheet to another spreadsheet or within the same spreadsheet",
-    inputSchema: {
-        type: "object",
-        properties: {
-            sourceSpreadsheetId: {
-                type: "string",
-                description: "The ID of the source spreadsheet",
-            },
-            sourceSheetId: {
-                type: "number",
-                description: "The ID of the sheet to copy",
-            },
-            destinationSpreadsheetId: {
-                type: "string",
-                description: "The ID of the destination spreadsheet",
-            },
-        },
-        required: ["sourceSpreadsheetId", "sourceSheetId", "destinationSpreadsheetId"],
-    },
-};
-export async function copySheet(args) {
-    const sheets = google.sheets("v4");
-    try {
-        const response = await sheets.spreadsheets.sheets.copyTo({
-            spreadsheetId: args.sourceSpreadsheetId,
-            sheetId: args.sourceSheetId,
-            requestBody: {
-                destinationSpreadsheetId: args.destinationSpreadsheetId,
-            },
-        });
-        const copiedSheet = response.data;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Successfully copied sheet to destination. New sheet ID: ${copiedSheet.sheetId}, Title: "${copiedSheet.title}"`,
-                },
-            ],
-            isError: false,
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error copying sheet: ${error.message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}

package/dist/tools/basic/gsheets_copy_to.js

@@ -1,113 +0,0 @@
-import { google } from "googleapis";
-export const schema = {
-    name: "gsheets_copy_to",
-    description: "Copy data from one range to another range using cut/paste",
-    inputSchema: {
-        type: "object",
-        properties: {
-            spreadsheetId: {
-                type: "string",
-                description: "The ID of the spreadsheet",
-            },
-            sourceSheetId: {
-                type: "number",
-                description: "The ID of the source sheet",
-            },
-            sourceStartRow: {
-                type: "number",
-                description: "Source starting row index (0-based)",
-            },
-            sourceStartColumn: {
-                type: "number",
-                description: "Source starting column index (0-based)",
-            },
-            sourceEndRow: {
-                type: "number",
-                description: "Source ending row index (exclusive, 0-based)",
-            },
-            sourceEndColumn: {
-                type: "number",
-                description: "Source ending column index (exclusive, 0-based)",
-            },
-            destinationSheetId: {
-                type: "number",
-                description: "The ID of the destination sheet",
-            },
-            destinationStartRow: {
-                type: "number",
-                description: "Destination starting row index (0-based)",
-            },
-            destinationStartColumn: {
-                type: "number",
-                description: "Destination starting column index (0-based)",
-            },
-            pasteType: {
-                type: "string",
-                enum: ["NORMAL", "VALUES", "FORMAT", "FORMULA"],
-                description: "What to paste (default: NORMAL - all data)",
-            },
-        },
-        required: [
-            "spreadsheetId",
-            "sourceSheetId",
-            "sourceStartRow",
-            "sourceStartColumn",
-            "sourceEndRow",
-            "sourceEndColumn",
-            "destinationSheetId",
-            "destinationStartRow",
-            "destinationStartColumn",
-        ],
-    },
-};
-export async function copyTo(args) {
-    const sheets = google.sheets("v4");
-    try {
-        await sheets.spreadsheets.batchUpdate({
-            spreadsheetId: args.spreadsheetId,
-            requestBody: {
-                requests: [
-                    {
-                        copyPaste: {
-                            source: {
-                                sheetId: args.sourceSheetId,
-                                startRowIndex: args.sourceStartRow,
-                                endRowIndex: args.sourceEndRow,
-                                startColumnIndex: args.sourceStartColumn,
-                                endColumnIndex: args.sourceEndColumn,
-                            },
-                            destination: {
-                                sheetId: args.destinationSheetId,
-                                startRowIndex: args.destinationStartRow,
-                                startColumnIndex: args.destinationStartColumn,
-                            },
-                            pasteType: args.pasteType || "NORMAL",
-                        },
-                    },
-                ],
-            },
-        });
-        const sourceRange = `R${args.sourceStartRow}C${args.sourceStartColumn}:R${args.sourceEndRow - 1}C${args.sourceEndColumn - 1}`;
-        const destRange = `R${args.destinationStartRow}C${args.destinationStartColumn}`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Successfully copied data from sheet ${args.sourceSheetId} (${sourceRange}) to sheet ${args.destinationSheetId} (${destRange})`,
-                },
-            ],
-            isError: false,
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error copying data: ${error.message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}