google-tools-mcp 1.2.11 → 2.0.0

package/dist/tools/extras/searchFileContents.js

@@ -1,81 +1,81 @@
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getDriveClient } from '../../clients.js';
-import { isDocx, isPdf, downloadBuffer, extractText } from './readFile.js';
-
-export function register(server) {
-    server.addTool({
-        name: 'searchFileContents',
-        description:
-            'Search Google Drive for files whose content or name matches a query. ' +
-            'For .docx and .pdf files, extracts and returns matching text snippets. ' +
-            'Use this to find information inside Office documents and PDFs.',
-        parameters: z.object({
-            query: z.string().describe('Text to search for'),
-            maxResults: z
-                .number()
-                .optional()
-                .default(5)
-                .describe('Max number of files to search (default 5)'),
-            folderId: z
-                .string()
-                .optional()
-                .describe('Restrict search to a specific folder ID'),
-        }),
-        execute: async ({ query, maxResults = 5, folderId }, { log }) => {
-            const drive = await getDriveClient();
-            log.info(`Searching file contents for: "${query}"`);
-
-            try {
-                const escaped = query.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
-                let q = `fullText contains '${escaped}' and trashed = false`;
-                if (folderId) q += ` and '${folderId}' in parents`;
-
-                const response = await drive.files.list({
-                    q,
-                    pageSize: maxResults,
-                    fields: 'files(id,name,mimeType)',
-                    supportsAllDrives: true,
-                    includeItemsFromAllDrives: true,
-                });
-
-                const files = response.data.files || [];
-                if (files.length === 0) return 'No files found matching that query.';
-
-                const results = [];
-
-                for (const file of files) {
-                    const canRead = isDocx(file.mimeType, file.name) || isPdf(file.mimeType, file.name);
-
-                    if (canRead) {
-                        try {
-                            const buffer = await downloadBuffer(drive, file.id);
-                            const text = await extractText(buffer, file.mimeType, file.name);
-
-                            const lowerText = text.toLowerCase();
-                            const lowerQuery = query.toLowerCase();
-                            const idx = lowerText.indexOf(lowerQuery);
-                            const snippet =
-                                idx !== -1
-                                    ? '...' + text.slice(Math.max(0, idx - 150), idx + 300).trim() + '...'
-                                    : text.slice(0, 400).trim() + '...';
-
-                            results.push(`**${file.name}** (ID: \`${file.id}\`)\n\n${snippet}`);
-                        } catch (e) {
-                            results.push(`**${file.name}** (ID: \`${file.id}\`)\n\n[Could not read: ${e.message}]`);
-                        }
-                    } else {
-                        results.push(`**${file.name}** (ID: \`${file.id}\`, type: ${file.mimeType})`);
-                    }
-                }
-
-                return results.join('\n\n---\n\n');
-            } catch (error) {
-                log.error(`Error searching files: ${error.message}`);
-                if (error.code === 403)
-                    throw new UserError('Permission denied. Check Drive access.');
-                throw new UserError(`Failed to search files: ${error.message}`);
-            }
-        },
-    });
-}
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getDriveClient } from '../../clients.js';
+import { isDocx, isPdf, downloadBuffer, extractText } from './readFile.js';
+
+export function register(server) {
+    server.addTool({
+        name: 'searchFileContents',
+        description:
+            'Search Google Drive for files whose content or name matches a query. ' +
+            'For .docx and .pdf files, extracts and returns matching text snippets. ' +
+            'Use this to find information inside Office documents and PDFs.',
+        parameters: z.object({
+            query: z.string().describe('Text to search for'),
+            maxResults: z
+                .number()
+                .optional()
+                .default(5)
+                .describe('Max number of files to search (default 5)'),
+            folderId: z
+                .string()
+                .optional()
+                .describe('Restrict search to a specific folder ID'),
+        }),
+        execute: async ({ query, maxResults = 5, folderId }, { log }) => {
+            const drive = await getDriveClient();
+            log.info(`Searching file contents for: "${query}"`);
+
+            try {
+                const escaped = query.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+                let q = `fullText contains '${escaped}' and trashed = false`;
+                if (folderId) q += ` and '${folderId}' in parents`;
+
+                const response = await drive.files.list({
+                    q,
+                    pageSize: maxResults,
+                    fields: 'files(id,name,mimeType)',
+                    supportsAllDrives: true,
+                    includeItemsFromAllDrives: true,
+                });
+
+                const files = response.data.files || [];
+                if (files.length === 0) return 'No files found matching that query.';
+
+                const results = [];
+
+                for (const file of files) {
+                    const canRead = isDocx(file.mimeType, file.name) || isPdf(file.mimeType, file.name);
+
+                    if (canRead) {
+                        try {
+                            const buffer = await downloadBuffer(drive, file.id);
+                            const text = await extractText(buffer, file.mimeType, file.name);
+
+                            const lowerText = text.toLowerCase();
+                            const lowerQuery = query.toLowerCase();
+                            const idx = lowerText.indexOf(lowerQuery);
+                            const snippet =
+                                idx !== -1
+                                    ? '...' + text.slice(Math.max(0, idx - 150), idx + 300).trim() + '...'
+                                    : text.slice(0, 400).trim() + '...';
+
+                            results.push(`**${file.name}** (ID: \`${file.id}\`)\n\n${snippet}`);
+                        } catch (e) {
+                            results.push(`**${file.name}** (ID: \`${file.id}\`)\n\n[Could not read: ${e.message}]`);
+                        }
+                    } else {
+                        results.push(`**${file.name}** (ID: \`${file.id}\`, type: ${file.mimeType})`);
+                    }
+                }
+
+                return results.join('\n\n---\n\n');
+            } catch (error) {
+                log.error(`Error searching files: ${error.message}`);
+                if (error.code === 403)
+                    throw new UserError('Permission denied. Check Drive access.');
+                throw new UserError(`Failed to search files: ${error.message}`);
+            }
+        },
+    });
+}

package/dist/tools/forms/batchUpdateForm.js

@@ -1,81 +1,81 @@
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getFormsClient } from '../../clients.js';
-
-export function register(server) {
-    server.addTool({
-        name: 'batch_update_form',
-        description:
-            'Applies one or more updates to a Google Form. Supports creating, updating, deleting, and moving items, as well as updating form info and settings. ' +
-            'Each request in the array should be an object with exactly one key: createItem, updateItem, deleteItem, moveItem, updateFormInfo, or updateSettings. ' +
-            'See the Google Forms API batchUpdate documentation for the full request schema.',
-        parameters: z.object({
-            formId: z.string().describe('The ID of the Google Form to update'),
-            requests: z
-                .array(z.record(z.any()))
-                .min(1)
-                .describe(
-                    'Array of update requests. Each object should have one key: createItem, updateItem, deleteItem, moveItem, updateFormInfo, or updateSettings',
-                ),
-        }),
-        execute: async (args, { log }) => {
-            const forms = await getFormsClient();
-            log.info(`Batch updating form ${args.formId} with ${args.requests.length} request(s)`);
-
-            const validKeys = new Set([
-                'createItem',
-                'updateItem',
-                'deleteItem',
-                'moveItem',
-                'updateFormInfo',
-                'updateSettings',
-            ]);
-
-            for (const req of args.requests) {
-                const keys = Object.keys(req);
-                if (keys.length !== 1 || !validKeys.has(keys[0])) {
-                    throw new UserError(
-                        `Invalid request object. Each request must have exactly one key from: ${[...validKeys].join(', ')}. Got: ${keys.join(', ')}`,
-                    );
-                }
-            }
-
-            try {
-                const response = await forms.forms.batchUpdate({
-                    formId: args.formId,
-                    requestBody: { requests: args.requests },
-                });
-                const data = response.data;
-                const replies = data.replies || [];
-
-                const result = {
-                    url: `https://docs.google.com/forms/d/${args.formId}/edit`,
-                    requestsApplied: args.requests.length,
-                    repliesReceived: replies.length,
-                };
-
-                const createdItems = [];
-                for (const reply of replies) {
-                    if (reply.createItem) {
-                        const ci = reply.createItem;
-                        createdItems.push({
-                            itemId: ci.itemId,
-                            questionId: ci.questionId?.[0] || null,
-                        });
-                    }
-                }
-                if (createdItems.length > 0) {
-                    result.createdItems = createdItems;
-                }
-
-                return JSON.stringify(result, null, 2);
-            } catch (error) {
-                log.error(`Error batch updating form: ${error.message || error}`);
-                if (error.code === 401)
-                    throw new UserError('Authentication failed. Try logging out and re-authenticating.');
-                if (error.code === 404) throw new UserError(`Form not found: ${args.formId}`);
-                throw new UserError(`Failed to batch update form: ${error.message || 'Unknown error'}`);
-            }
-        },
-    });
-}
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getFormsClient } from '../../clients.js';
+
+export function register(server) {
+    server.addTool({
+        name: 'batch_update_form',
+        description:
+            'Applies one or more updates to a Google Form. Supports creating, updating, deleting, and moving items, as well as updating form info and settings. ' +
+            'Each request in the array should be an object with exactly one key: createItem, updateItem, deleteItem, moveItem, updateFormInfo, or updateSettings. ' +
+            'See the Google Forms API batchUpdate documentation for the full request schema.',
+        parameters: z.object({
+            formId: z.string().describe('The ID of the Google Form to update'),
+            requests: z
+                .array(z.record(z.any()))
+                .min(1)
+                .describe(
+                    'Array of update requests. Each object should have one key: createItem, updateItem, deleteItem, moveItem, updateFormInfo, or updateSettings',
+                ),
+        }),
+        execute: async (args, { log }) => {
+            const forms = await getFormsClient();
+            log.info(`Batch updating form ${args.formId} with ${args.requests.length} request(s)`);
+
+            const validKeys = new Set([
+                'createItem',
+                'updateItem',
+                'deleteItem',
+                'moveItem',
+                'updateFormInfo',
+                'updateSettings',
+            ]);
+
+            for (const req of args.requests) {
+                const keys = Object.keys(req);
+                if (keys.length !== 1 || !validKeys.has(keys[0])) {
+                    throw new UserError(
+                        `Invalid request object. Each request must have exactly one key from: ${[...validKeys].join(', ')}. Got: ${keys.join(', ')}`,
+                    );
+                }
+            }
+
+            try {
+                const response = await forms.forms.batchUpdate({
+                    formId: args.formId,
+                    requestBody: { requests: args.requests },
+                });
+                const data = response.data;
+                const replies = data.replies || [];
+
+                const result = {
+                    url: `https://docs.google.com/forms/d/${args.formId}/edit`,
+                    requestsApplied: args.requests.length,
+                    repliesReceived: replies.length,
+                };
+
+                const createdItems = [];
+                for (const reply of replies) {
+                    if (reply.createItem) {
+                        const ci = reply.createItem;
+                        createdItems.push({
+                            itemId: ci.itemId,
+                            questionId: ci.questionId?.[0] || null,
+                        });
+                    }
+                }
+                if (createdItems.length > 0) {
+                    result.createdItems = createdItems;
+                }
+
+                return JSON.stringify(result, null, 2);
+            } catch (error) {
+                log.error(`Error batch updating form: ${error.message || error}`);
+                if (error.code === 401)
+                    throw new UserError('Authentication failed. Try logging out and re-authenticating.');
+                if (error.code === 404) throw new UserError(`Form not found: ${args.formId}`);
+                throw new UserError(`Failed to batch update form: ${error.message || 'Unknown error'}`);
+            }
+        },
+    });
+}

package/dist/tools/forms/createForm.js

@@ -1,54 +1,54 @@
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getFormsClient } from '../../clients.js';
-
-export function register(server) {
-    server.addTool({
-        name: 'create_form',
-        description:
-            'Creates a new Google Form with a title and optional description. Returns the form ID, edit URL, and responder URL.',
-        parameters: z.object({
-            title: z.string().describe('The title of the form (shown to respondents)'),
-            description: z.string().optional().describe('A description displayed at the top of the form'),
-            documentTitle: z
-                .string()
-                .optional()
-                .describe('The document title (shown in Drive). Defaults to the form title if not provided'),
-        }),
-        execute: async (args, { log }) => {
-            const forms = await getFormsClient();
-            log.info(`Creating form: ${args.title}`);
-
-            const body = {
-                info: {
-                    title: args.title,
-                    documentTitle: args.documentTitle || args.title,
-                },
-            };
-            if (args.description) {
-                body.info.description = args.description;
-            }
-
-            try {
-                const response = await forms.forms.create({ requestBody: body });
-                const form = response.data;
-
-                return JSON.stringify(
-                    {
-                        formId: form.formId,
-                        title: form.info?.title,
-                        editUrl: `https://docs.google.com/forms/d/${form.formId}/edit`,
-                        responderUrl: form.responderUri || `https://docs.google.com/forms/d/${form.formId}/viewform`,
-                    },
-                    null,
-                    2,
-                );
-            } catch (error) {
-                log.error(`Error creating form: ${error.message || error}`);
-                if (error.code === 401)
-                    throw new UserError('Authentication failed. Try logging out and re-authenticating.');
-                throw new UserError(`Failed to create form: ${error.message || 'Unknown error'}`);
-            }
-        },
-    });
-}
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getFormsClient } from '../../clients.js';
+
+export function register(server) {
+    server.addTool({
+        name: 'create_form',
+        description:
+            'Creates a new Google Form with a title and optional description. Returns the form ID, edit URL, and responder URL.',
+        parameters: z.object({
+            title: z.string().describe('The title of the form (shown to respondents)'),
+            description: z.string().optional().describe('A description displayed at the top of the form'),
+            documentTitle: z
+                .string()
+                .optional()
+                .describe('The document title (shown in Drive). Defaults to the form title if not provided'),
+        }),
+        execute: async (args, { log }) => {
+            const forms = await getFormsClient();
+            log.info(`Creating form: ${args.title}`);
+
+            const body = {
+                info: {
+                    title: args.title,
+                    documentTitle: args.documentTitle || args.title,
+                },
+            };
+            if (args.description) {
+                body.info.description = args.description;
+            }
+
+            try {
+                const response = await forms.forms.create({ requestBody: body });
+                const form = response.data;
+
+                return JSON.stringify(
+                    {
+                        formId: form.formId,
+                        title: form.info?.title,
+                        editUrl: `https://docs.google.com/forms/d/${form.formId}/edit`,
+                        responderUrl: form.responderUri || `https://docs.google.com/forms/d/${form.formId}/viewform`,
+                    },
+                    null,
+                    2,
+                );
+            } catch (error) {
+                log.error(`Error creating form: ${error.message || error}`);
+                if (error.code === 401)
+                    throw new UserError('Authentication failed. Try logging out and re-authenticating.');
+                throw new UserError(`Failed to create form: ${error.message || 'Unknown error'}`);
+            }
+        },
+    });
+}