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

package/dist/tools/docs/elements/gdocs_merge_documents.js

@@ -0,0 +1,104 @@
+import { google } from "googleapis";
+import { ResponseFormatter } from "../../../lib/response-formatter.js";
+import { DocumentIdResolver } from "../../../lib/document-id-resolver.js";
+export const schema = {
+    name: "gdocs_merge_documents",
+    description: "Merge multiple Google Documents into one. Creates a new document or appends to an existing target document.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sourceDocumentIds: {
+                type: "array",
+                description: "Array of source document IDs or URLs to merge (in order)",
+                items: {
+                    type: "string",
+                },
+            },
+            targetDocumentId: {
+                type: "string",
+                description: "Target document ID or URL to merge into. If not provided, creates a new document.",
+            },
+            title: {
+                type: "string",
+                description: "Title for the new merged document (only used if targetDocumentId is not provided)",
+            },
+        },
+        required: ["sourceDocumentIds"],
+    },
+};
+export async function mergeDocuments(args) {
+    try {
+        if (args.sourceDocumentIds.length === 0) {
+            throw new Error("At least one source document is required");
+        }
+        const docs = google.docs("v1");
+        // Resolve source document IDs
+        const sourceIds = args.sourceDocumentIds.map((id) => {
+            const ref = DocumentIdResolver.resolve(id);
+            return ref.id;
+        });
+        // Determine target document
+        let targetDocumentId;
+        if (args.targetDocumentId) {
+            const targetRef = DocumentIdResolver.resolve(args.targetDocumentId);
+            targetDocumentId = targetRef.id;
+        }
+        else {
+            // Create a new document
+            const createResponse = await docs.documents.create({
+                requestBody: {
+                    title: args.title || "Merged Document",
+                },
+            });
+            targetDocumentId = createResponse.data.documentId;
+        }
+        // Read each source document and append to target
+        for (const sourceId of sourceIds) {
+            const sourceDoc = await docs.documents.get({ documentId: sourceId });
+            // Extract text content from source
+            let textContent = "";
+            if (sourceDoc.data.body?.content) {
+                for (const element of sourceDoc.data.body.content) {
+                    if (element.paragraph?.elements) {
+                        for (const textElement of element.paragraph.elements) {
+                            if (textElement.textRun?.content) {
+                                textContent += textElement.textRun.content;
+                            }
+                        }
+                    }
+                }
+            }
+            // Get target document end index
+            const targetDoc = await docs.documents.get({ documentId: targetDocumentId });
+            const endIndex = targetDoc.data.body?.content?.[targetDoc.data.body.content.length - 1]?.endIndex || 1;
+            // Append content to target
+            if (textContent) {
+                await docs.documents.batchUpdate({
+                    documentId: targetDocumentId,
+                    requestBody: {
+                        requests: [
+                            {
+                                insertText: {
+                                    text: "\n" + textContent,
+                                    location: {
+                                        index: endIndex - 1,
+                                    },
+                                },
+                            },
+                        ],
+                    },
+                });
+            }
+        }
+        const targetUrl = `https://docs.google.com/document/d/${targetDocumentId}/edit`;
+        return ResponseFormatter.success({
+            targetDocumentId,
+            targetDocumentUrl: targetUrl,
+            mergedDocuments: sourceIds.length,
+            sourceDocumentIds: sourceIds,
+        }, `Successfully merged ${sourceIds.length} document(s)`);
+    }
+    catch (error) {
+        return ResponseFormatter.error(error);
+    }
+}

package/dist/tools/docs/elements/gdocs_suggest_mode.js

@@ -0,0 +1,41 @@
+import { google } from "googleapis";
+import { ResponseFormatter } from "../../../lib/response-formatter.js";
+import { DocumentIdResolver } from "../../../lib/document-id-resolver.js";
+export const schema = {
+    name: "gdocs_suggest_mode",
+    description: "NOTE: This tool cannot programmatically control suggestion mode. The Google Docs API doesn't support enabling/disabling suggestion mode. To use suggestion mode, open the document in Google Docs UI and use the 'Editing/Suggesting/Viewing' dropdown in the top-right corner.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            documentId: {
+                type: "string",
+                description: "Document ID or full Google Docs URL",
+            },
+            enabled: {
+                type: "boolean",
+                description: "true to enable suggestion mode, false to disable",
+            },
+        },
+        required: ["documentId", "enabled"],
+    },
+};
+export async function suggestMode(args) {
+    try {
+        // Resolve document ID from URL if needed
+        const docRef = DocumentIdResolver.resolve(args.documentId);
+        const documentId = docRef.id;
+        const docs = google.docs("v1");
+        // Verify document exists
+        await docs.documents.get({ documentId });
+        // Return informative error about API limitation
+        return ResponseFormatter.error(new Error(`Suggestion mode cannot be controlled programmatically via the Google Docs API. ` +
+            `To ${args.enabled ? "enable" : "disable"} suggestion mode, please:\n\n` +
+            `1. Open the document at: https://docs.google.com/document/d/${documentId}/edit\n` +
+            `2. Click the 'Editing' dropdown in the top-right corner\n` +
+            `3. Select '${args.enabled ? "Suggesting" : "Editing"}'\n\n` +
+            `This is a limitation of the Google Docs API, not this tool.`));
+    }
+    catch (error) {
+        return ResponseFormatter.error(error);
+    }
+}

package/dist/tools/index.js

@@ -62,6 +62,32 @@ import { schema as gsheetsUpdateDimensionGroupSchema, updateDimensionGroup } fro
 import { schema as gsheetsCreateDeveloperMetadataSchema, createDeveloperMetadata } from './sheets/advanced/gsheets_create_developer_metadata.js';
 import { schema as gsheetsUpdateDeveloperMetadataSchema, updateDeveloperMetadata } from './sheets/advanced/gsheets_update_developer_metadata.js';
 import { schema as gsheetsDeleteDeveloperMetadataSchema, deleteDeveloperMetadata } from './sheets/advanced/gsheets_delete_developer_metadata.js';
+// Google Docs - Basic operations
+import { schema as gdocsCreateSchema, createDocument } from './docs/basic/gdocs_create.js';
+import { schema as gdocsReadSchema, readDocument } from './docs/basic/gdocs_read.js';
+import { schema as gdocsGetMetadataSchema, getMetadata } from './docs/basic/gdocs_get_metadata.js';
+import { schema as gdocsListDocumentsSchema, listDocuments } from './docs/basic/gdocs_list_documents.js';
+// Google Docs - Content/Formatting operations
+import { schema as gdocsInsertTextSchema, insertText } from './docs/content/gdocs_insert_text.js';
+import { schema as gdocsUpdateTextSchema, updateText } from './docs/content/gdocs_update_text.js';
+import { schema as gdocsDeleteTextSchema, deleteText } from './docs/content/gdocs_delete_text.js';
+import { schema as gdocsReplaceTextSchema, replaceText } from './docs/content/gdocs_replace_text.js';
+import { schema as gdocsAppendTextSchema, appendText } from './docs/content/gdocs_append_text.js';
+import { schema as gdocsFormatTextSchema, formatText } from './docs/content/gdocs_format_text.js';
+import { schema as gdocsCreateHeadingSchema, createHeading } from './docs/content/gdocs_create_heading.js';
+import { schema as gdocsCreateListSchema, createList } from './docs/content/gdocs_create_list.js';
+import { schema as gdocsSetAlignmentSchema, setAlignment } from './docs/content/gdocs_set_alignment.js';
+import { schema as gdocsApplyStyleSchema, applyStyle } from './docs/content/gdocs_apply_style.js';
+// Google Docs - Elements/Advanced operations
+import { schema as gdocsInsertImageSchema, insertImage } from './docs/elements/gdocs_insert_image.js';
+import { schema as gdocsCreateTableSchema, createTable } from './docs/elements/gdocs_create_table.js';
+import { schema as gdocsInsertPageBreakSchema, insertPageBreak } from './docs/elements/gdocs_insert_page_break.js';
+import { schema as gdocsInsertLinkSchema, insertLink } from './docs/elements/gdocs_insert_link.js';
+import { schema as gdocsInsertTocSchema, insertToc } from './docs/elements/gdocs_insert_toc.js';
+import { schema as gdocsBatchUpdateSchema, batchUpdate as gdocsBatchUpdate } from './docs/elements/gdocs_batch_update.js';
+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';
 export const tools = [
     {
         ...driveSearchSchema,
@@ -290,5 +316,98 @@ export const tools = [
     {
         ...gsheetsDeleteDeveloperMetadataSchema,
         handler: deleteDeveloperMetadata,
+    },
+    // Google Docs tools
+    {
+        ...gdocsCreateSchema,
+        handler: createDocument,
+    },
+    {
+        ...gdocsReadSchema,
+        handler: readDocument,
+    },
+    {
+        ...gdocsGetMetadataSchema,
+        handler: getMetadata,
+    },
+    {
+        ...gdocsListDocumentsSchema,
+        handler: listDocuments,
+    },
+    {
+        ...gdocsInsertTextSchema,
+        handler: insertText,
+    },
+    {
+        ...gdocsUpdateTextSchema,
+        handler: updateText,
+    },
+    {
+        ...gdocsDeleteTextSchema,
+        handler: deleteText,
+    },
+    {
+        ...gdocsReplaceTextSchema,
+        handler: replaceText,
+    },
+    {
+        ...gdocsAppendTextSchema,
+        handler: appendText,
+    },
+    {
+        ...gdocsFormatTextSchema,
+        handler: formatText,
+    },
+    {
+        ...gdocsCreateHeadingSchema,
+        handler: createHeading,
+    },
+    {
+        ...gdocsCreateListSchema,
+        handler: createList,
+    },
+    {
+        ...gdocsSetAlignmentSchema,
+        handler: setAlignment,
+    },
+    {
+        ...gdocsApplyStyleSchema,
+        handler: applyStyle,
+    },
+    {
+        ...gdocsInsertImageSchema,
+        handler: insertImage,
+    },
+    {
+        ...gdocsCreateTableSchema,
+        handler: createTable,
+    },
+    {
+        ...gdocsInsertPageBreakSchema,
+        handler: insertPageBreak,
+    },
+    {
+        ...gdocsInsertLinkSchema,
+        handler: insertLink,
+    },
+    {
+        ...gdocsInsertTocSchema,
+        handler: insertToc,
+    },
+    {
+        ...gdocsBatchUpdateSchema,
+        handler: gdocsBatchUpdate,
+    },
+    {
+        ...gdocsMergeDocumentsSchema,
+        handler: mergeDocuments,
+    },
+    {
+        ...gdocsExportSchema,
+        handler: exportDocument,
+    },
+    {
+        ...gdocsSuggestModeSchema,
+        handler: suggestMode,
     }
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alanse/mcp-server-google-workspace",
-  "version": "0.2.1",
+  "version": "1.0.0",
   "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",