google-tools-mcp 1.2.11 → 2.0.0

package/dist/tools/drive/getFilePath.js

@@ -1,50 +1,50 @@
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getDriveClient } from '../../clients.js';
-
-export function register(server) {
-    server.addTool({
-        name: 'getFilePath',
-        description: 'Returns the full folder path of a Drive file from root to the file itself (e.g. "My Drive/Projects/Docs/report.pdf"). Walks up the parent chain to reconstruct the complete path.',
-        parameters: z.object({
-            fileId: z.string().describe('The ID of the file or folder to get the path for.'),
-        }),
-        execute: async (args, { log }) => {
-            const drive = await getDriveClient();
-            log.info(`Getting full path for file: ${args.fileId}`);
-            try {
-                const pathParts = [];
-                let currentId = args.fileId;
-
-                while (currentId) {
-                    const response = await drive.files.get({
-                        fileId: currentId,
-                        fields: 'id,name,parents',
-                        supportsAllDrives: true,
-                    });
-                    const file = response.data;
-                    if (!file) break;
-
-                    pathParts.unshift(file.name);
-
-                    if (file.parents && file.parents.length > 0) {
-                        currentId = file.parents[0];
-                    } else {
-                        break;
-                    }
-                }
-
-                const fullPath = pathParts.join('/');
-
-                return JSON.stringify({ fileId: args.fileId, path: fullPath }, null, 2);
-            } catch (error) {
-                log.error(`Error getting file path: ${error.message || error}`);
-                if (error.code === 404)
-                    throw new UserError(`File not found (ID: ${args.fileId}).`);
-                if (error.code === 403)
-                    throw new UserError('Permission denied. Make sure you have access to this file.');
-                throw new UserError(`Failed to get file path: ${error.message || 'Unknown error'}`);
-            }
-        },
-    });
-}
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getDriveClient } from '../../clients.js';
+
+export function register(server) {
+    server.addTool({
+        name: 'getFilePath',
+        description: 'Returns the full folder path of a Drive file from root to the file itself (e.g. "My Drive/Projects/Docs/report.pdf"). Walks up the parent chain to reconstruct the complete path.',
+        parameters: z.object({
+            fileId: z.string().describe('The ID of the file or folder to get the path for.'),
+        }),
+        execute: async (args, { log }) => {
+            const drive = await getDriveClient();
+            log.info(`Getting full path for file: ${args.fileId}`);
+            try {
+                const pathParts = [];
+                let currentId = args.fileId;
+
+                while (currentId) {
+                    const response = await drive.files.get({
+                        fileId: currentId,
+                        fields: 'id,name,parents',
+                        supportsAllDrives: true,
+                    });
+                    const file = response.data;
+                    if (!file) break;
+
+                    pathParts.unshift(file.name);
+
+                    if (file.parents && file.parents.length > 0) {
+                        currentId = file.parents[0];
+                    } else {
+                        break;
+                    }
+                }
+
+                const fullPath = pathParts.join('/');
+
+                return JSON.stringify({ fileId: args.fileId, path: fullPath }, null, 2);
+            } catch (error) {
+                log.error(`Error getting file path: ${error.message || error}`);
+                if (error.code === 404)
+                    throw new UserError(`File not found (ID: ${args.fileId}).`);
+                if (error.code === 403)
+                    throw new UserError('Permission denied. Make sure you have access to this file.');
+                throw new UserError(`Failed to get file path: ${error.message || 'Unknown error'}`);
+            }
+        },
+    });
+}

package/dist/tools/drive/listDriveFiles.js

@@ -1,112 +1,112 @@
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getDriveClient } from '../../clients.js';
-
-const MIME_TYPES = {
-    document: 'application/vnd.google-apps.document',
-    spreadsheet: 'application/vnd.google-apps.spreadsheet',
-    presentation: 'application/vnd.google-apps.presentation',
-    form: 'application/vnd.google-apps.form',
-    pdf: 'application/pdf',
-};
-
-export function register(server) {
-    server.addTool({
-        name: 'listDriveFiles',
-        description:
-            'Lists files in your Drive, optionally filtered by type (document, spreadsheet, presentation, form, pdf), name/content query, or modification date.',
-        parameters: z.object({
-            fileType: z
-                .enum(['document', 'spreadsheet', 'presentation', 'form', 'pdf', 'all'])
-                .optional()
-                .default('all')
-                .describe('Filter by file type. Defaults to all types.'),
-            maxResults: z
-                .number()
-                .int()
-                .min(1)
-                .max(100)
-                .optional()
-                .default(20)
-                .describe('Maximum number of files to return (1-100).'),
-            query: z
-                .string()
-                .optional()
-                .describe('Search query to filter files by name or content.'),
-            orderBy: z
-                .enum(['name', 'modifiedTime', 'createdTime'])
-                .optional()
-                .default('modifiedTime')
-                .describe('Sort order for results.'),
-            modifiedAfter: z
-                .string()
-                .optional()
-                .describe(
-                    'Only return files modified after this date (ISO 8601 format, e.g., "2024-01-01").'
-                ),
-        }),
-        execute: async (args, { log }) => {
-            const drive = await getDriveClient();
-            log.info(
-                `Listing Drive files. Type: ${args.fileType}, Query: ${args.query || 'none'}, Max: ${args.maxResults}, Order: ${args.orderBy}`
-            );
-            try {
-                let queryParts = ['trashed=false'];
-
-                // Filter by mime type
-                if (args.fileType !== 'all') {
-                    queryParts.push(`mimeType='${MIME_TYPES[args.fileType]}'`);
-                } else if (!args.query) {
-                    // Exclude folders from "all" results only when not doing fullText search
-                    // (Drive API doesn't allow fullText contains with negated mimeType filters)
-                    queryParts.push("mimeType!='application/vnd.google-apps.folder'");
-                }
-
-                if (args.query) {
-                    queryParts.push(
-                        `(name contains '${args.query}' or fullText contains '${args.query}')`
-                    );
-                }
-
-                if (args.modifiedAfter) {
-                    const cutoffDate = new Date(args.modifiedAfter).toISOString();
-                    queryParts.push(`modifiedTime > '${cutoffDate}'`);
-                }
-
-                // Drive API does not allow orderBy when using fullText contains
-                const useFullText = !!args.query;
-                const listParams = {
-                    q: queryParts.join(' and '),
-                    pageSize: args.maxResults,
-                    fields: 'files(id,name,mimeType,modifiedTime,createdTime,size,webViewLink,owners(displayName,emailAddress))',
-                    supportsAllDrives: true,
-                    includeItemsFromAllDrives: true,
-                };
-                if (!useFullText) {
-                    listParams.orderBy = args.orderBy === 'name' ? 'name' : args.orderBy;
-                }
-                const response = await drive.files.list(listParams);
-
-                const files = (response.data.files || []).map((file) => ({
-                    id: file.id,
-                    name: file.name,
-                    mimeType: file.mimeType,
-                    modifiedTime: file.modifiedTime,
-                    owner: file.owners?.[0]?.displayName || null,
-                    url: file.webViewLink,
-                }));
-
-                return JSON.stringify({ files }, null, 2);
-            } catch (error) {
-                log.error(`Error listing Drive files: ${error.message || error}`);
-                if (error.code === 403)
-                    throw new UserError(
-                        'Permission denied. Make sure you have granted Google Drive access to the application.'
-                    );
-                throw new UserError(
-                    `Failed to list files: ${error.message || 'Unknown error'}`
-                );
-            }
-        },
-    });
-}
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getDriveClient } from '../../clients.js';
+
+const MIME_TYPES = {
+    document: 'application/vnd.google-apps.document',
+    spreadsheet: 'application/vnd.google-apps.spreadsheet',
+    presentation: 'application/vnd.google-apps.presentation',
+    form: 'application/vnd.google-apps.form',
+    pdf: 'application/pdf',
+};
+
+export function register(server) {
+    server.addTool({
+        name: 'listDriveFiles',
+        description:
+            'Lists files in your Drive, optionally filtered by type (document, spreadsheet, presentation, form, pdf), name/content query, or modification date.',
+        parameters: z.object({
+            fileType: z
+                .enum(['document', 'spreadsheet', 'presentation', 'form', 'pdf', 'all'])
+                .optional()
+                .default('all')
+                .describe('Filter by file type. Defaults to all types.'),
+            maxResults: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .default(20)
+                .describe('Maximum number of files to return (1-100).'),
+            query: z
+                .string()
+                .optional()
+                .describe('Search query to filter files by name or content.'),
+            orderBy: z
+                .enum(['name', 'modifiedTime', 'createdTime'])
+                .optional()
+                .default('modifiedTime')
+                .describe('Sort order for results.'),
+            modifiedAfter: z
+                .string()
+                .optional()
+                .describe(
+                    'Only return files modified after this date (ISO 8601 format, e.g., "2024-01-01").'
+                ),
+        }),
+        execute: async (args, { log }) => {
+            const drive = await getDriveClient();
+            log.info(
+                `Listing Drive files. Type: ${args.fileType}, Query: ${args.query || 'none'}, Max: ${args.maxResults}, Order: ${args.orderBy}`
+            );
+            try {
+                let queryParts = ['trashed=false'];
+
+                // Filter by mime type
+                if (args.fileType !== 'all') {
+                    queryParts.push(`mimeType='${MIME_TYPES[args.fileType]}'`);
+                } else if (!args.query) {
+                    // Exclude folders from "all" results only when not doing fullText search
+                    // (Drive API doesn't allow fullText contains with negated mimeType filters)
+                    queryParts.push("mimeType!='application/vnd.google-apps.folder'");
+                }
+
+                if (args.query) {
+                    queryParts.push(
+                        `(name contains '${args.query}' or fullText contains '${args.query}')`
+                    );
+                }
+
+                if (args.modifiedAfter) {
+                    const cutoffDate = new Date(args.modifiedAfter).toISOString();
+                    queryParts.push(`modifiedTime > '${cutoffDate}'`);
+                }
+
+                // Drive API does not allow orderBy when using fullText contains
+                const useFullText = !!args.query;
+                const listParams = {
+                    q: queryParts.join(' and '),
+                    pageSize: args.maxResults,
+                    fields: 'files(id,name,mimeType,modifiedTime,createdTime,size,webViewLink,owners(displayName,emailAddress))',
+                    supportsAllDrives: true,
+                    includeItemsFromAllDrives: true,
+                };
+                if (!useFullText) {
+                    listParams.orderBy = args.orderBy === 'name' ? 'name' : args.orderBy;
+                }
+                const response = await drive.files.list(listParams);
+
+                const files = (response.data.files || []).map((file) => ({
+                    id: file.id,
+                    name: file.name,
+                    mimeType: file.mimeType,
+                    modifiedTime: file.modifiedTime,
+                    owner: file.owners?.[0]?.displayName || null,
+                    url: file.webViewLink,
+                }));
+
+                return JSON.stringify({ files }, null, 2);
+            } catch (error) {
+                log.error(`Error listing Drive files: ${error.message || error}`);
+                if (error.code === 403)
+                    throw new UserError(
+                        'Permission denied. Make sure you have granted Google Drive access to the application.'
+                    );
+                throw new UserError(
+                    `Failed to list files: ${error.message || 'Unknown error'}`
+                );
+            }
+        },
+    });
+}

package/dist/tools/drive/listSharedDrives.js

@@ -1,52 +1,52 @@
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getDriveClient } from '../../clients.js';
-export function register(server) {
-    server.addTool({
-        name: 'listSharedDrives',
-        description: 'Lists all Shared Drives (Team Drives) the user has access to. Use the returned drive ID with listFolderContents to browse its contents.',
-        parameters: z.object({
-            maxResults: z
-                .number()
-                .int()
-                .min(1)
-                .max(100)
-                .optional()
-                .default(50)
-                .describe('Maximum number of shared drives to return.'),
-            pageToken: z
-                .string()
-                .optional()
-                .describe('Token for fetching the next page of results.'),
-        }),
-        execute: async (args, { log }) => {
-            const drive = await getDriveClient();
-            log.info('Listing shared drives');
-            try {
-                const response = await drive.drives.list({
-                    pageSize: args.maxResults,
-                    pageToken: args.pageToken || undefined,
-                    fields: 'nextPageToken,drives(id,name,createdTime,hidden)',
-                });
-                const drives = (response.data.drives || []).map((d) => ({
-                    id: d.id,
-                    name: d.name,
-                    createdTime: d.createdTime,
-                    hidden: d.hidden || false,
-                }));
-                const result = {
-                    drives,
-                    nextPageToken: response.data.nextPageToken || null,
-                    totalCount: drives.length,
-                };
-                return JSON.stringify(result, null, 2);
-            }
-            catch (error) {
-                log.error(`Error listing shared drives: ${error.message || error}`);
-                if (error.code === 403)
-                    throw new UserError('Permission denied. Make sure the Drive API scope includes shared drives.');
-                throw new UserError(`Failed to list shared drives: ${error.message || 'Unknown error'}`);
-            }
-        },
-    });
-}
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getDriveClient } from '../../clients.js';
+export function register(server) {
+    server.addTool({
+        name: 'listSharedDrives',
+        description: 'Lists all Shared Drives (Team Drives) the user has access to. Use the returned drive ID with listFolderContents to browse its contents.',
+        parameters: z.object({
+            maxResults: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .default(50)
+                .describe('Maximum number of shared drives to return.'),
+            pageToken: z
+                .string()
+                .optional()
+                .describe('Token for fetching the next page of results.'),
+        }),
+        execute: async (args, { log }) => {
+            const drive = await getDriveClient();
+            log.info('Listing shared drives');
+            try {
+                const response = await drive.drives.list({
+                    pageSize: args.maxResults,
+                    pageToken: args.pageToken || undefined,
+                    fields: 'nextPageToken,drives(id,name,createdTime,hidden)',
+                });
+                const drives = (response.data.drives || []).map((d) => ({
+                    id: d.id,
+                    name: d.name,
+                    createdTime: d.createdTime,
+                    hidden: d.hidden || false,
+                }));
+                const result = {
+                    drives,
+                    nextPageToken: response.data.nextPageToken || null,
+                    totalCount: drives.length,
+                };
+                return JSON.stringify(result, null, 2);
+            }
+            catch (error) {
+                log.error(`Error listing shared drives: ${error.message || error}`);
+                if (error.code === 403)
+                    throw new UserError('Permission denied. Make sure the Drive API scope includes shared drives.');
+                throw new UserError(`Failed to list shared drives: ${error.message || 'Unknown error'}`);
+            }
+        },
+    });
+}

package/dist/tools/drive/listSharedWithMe.js

@@ -1,97 +1,97 @@
-import { UserError } from 'fastmcp';
-import { z } from 'zod';
-import { getDriveClient } from '../../clients.js';
-export function register(server) {
-    server.addTool({
-        name: 'listSharedWithMe',
-        description: 'Lists files and folders that have been shared with the user ("Shared with me"). Returns items shared by others that are not in the user\'s own Drive. Use folder IDs with listFolderContents to navigate into shared folders.',
-        parameters: z.object({
-            mimeType: z
-                .string()
-                .optional()
-                .describe('Filter by MIME type. Use "application/vnd.google-apps.folder" for folders only, "application/vnd.google-apps.document" for Docs, "application/vnd.google-apps.spreadsheet" for Sheets, etc.'),
-            query: z
-                .string()
-                .optional()
-                .describe('Search query to filter shared items by name (uses "contains" matching).'),
-            maxResults: z
-                .number()
-                .int()
-                .min(1)
-                .max(100)
-                .optional()
-                .default(50)
-                .describe('Maximum number of items to return.'),
-            pageToken: z
-                .string()
-                .optional()
-                .describe('Token for fetching the next page of results.'),
-            orderBy: z
-                .enum(['name', 'modifiedTime', 'sharedWithMeTime'])
-                .optional()
-                .default('sharedWithMeTime')
-                .describe('How to sort results. Defaults to most recently shared first.'),
-        }),
-        execute: async (args, { log }) => {
-            const drive = await getDriveClient();
-            log.info('Listing shared with me');
-            try {
-                let queryParts = ['sharedWithMe=true', 'trashed=false'];
-                if (args.mimeType) {
-                    queryParts.push(`mimeType='${args.mimeType}'`);
-                }
-                if (args.query) {
-                    queryParts.push(`name contains '${args.query.replace(/'/g, "\\'")}'`);
-                }
-                const orderBy = args.orderBy === 'sharedWithMeTime'
-                    ? 'sharedWithMeTime desc'
-                    : args.orderBy === 'modifiedTime'
-                        ? 'modifiedTime desc'
-                        : 'name';
-                const response = await drive.files.list({
-                    q: queryParts.join(' and '),
-                    pageSize: args.maxResults,
-                    pageToken: args.pageToken || undefined,
-                    orderBy,
-                    fields: 'nextPageToken,files(id,name,mimeType,modifiedTime,sharedWithMeTime,sharingUser(displayName,emailAddress),webViewLink,owners(displayName))',
-                    supportsAllDrives: true,
-                    includeItemsFromAllDrives: true,
-                });
-                const items = response.data.files || [];
-                const folders = items
-                    .filter((f) => f.mimeType === 'application/vnd.google-apps.folder')
-                    .map((f) => ({
-                    id: f.id,
-                    name: f.name,
-                    sharedWithMeTime: f.sharedWithMeTime,
-                    sharedBy: f.sharingUser?.displayName || f.owners?.[0]?.displayName || null,
-                    sharedByEmail: f.sharingUser?.emailAddress || null,
-                }));
-                const files = items
-                    .filter((f) => f.mimeType !== 'application/vnd.google-apps.folder')
-                    .map((f) => ({
-                    id: f.id,
-                    name: f.name,
-                    mimeType: f.mimeType,
-                    modifiedTime: f.modifiedTime,
-                    sharedWithMeTime: f.sharedWithMeTime,
-                    sharedBy: f.sharingUser?.displayName || f.owners?.[0]?.displayName || null,
-                    sharedByEmail: f.sharingUser?.emailAddress || null,
-                }));
-                const result = {
-                    folders,
-                    files,
-                    nextPageToken: response.data.nextPageToken || null,
-                    totalCount: items.length,
-                };
-                return JSON.stringify(result, null, 2);
-            }
-            catch (error) {
-                log.error(`Error listing shared items: ${error.message || error}`);
-                if (error.code === 403)
-                    throw new UserError('Permission denied. Make sure you have the correct Drive API scopes.');
-                throw new UserError(`Failed to list shared items: ${error.message || 'Unknown error'}`);
-            }
-        },
-    });
-}
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getDriveClient } from '../../clients.js';
+export function register(server) {
+    server.addTool({
+        name: 'listSharedWithMe',
+        description: 'Lists files and folders that have been shared with the user ("Shared with me"). Returns items shared by others that are not in the user\'s own Drive. Use folder IDs with listFolderContents to navigate into shared folders.',
+        parameters: z.object({
+            mimeType: z
+                .string()
+                .optional()
+                .describe('Filter by MIME type. Use "application/vnd.google-apps.folder" for folders only, "application/vnd.google-apps.document" for Docs, "application/vnd.google-apps.spreadsheet" for Sheets, etc.'),
+            query: z
+                .string()
+                .optional()
+                .describe('Search query to filter shared items by name (uses "contains" matching).'),
+            maxResults: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .default(50)
+                .describe('Maximum number of items to return.'),
+            pageToken: z
+                .string()
+                .optional()
+                .describe('Token for fetching the next page of results.'),
+            orderBy: z
+                .enum(['name', 'modifiedTime', 'sharedWithMeTime'])
+                .optional()
+                .default('sharedWithMeTime')
+                .describe('How to sort results. Defaults to most recently shared first.'),
+        }),
+        execute: async (args, { log }) => {
+            const drive = await getDriveClient();
+            log.info('Listing shared with me');
+            try {
+                let queryParts = ['sharedWithMe=true', 'trashed=false'];
+                if (args.mimeType) {
+                    queryParts.push(`mimeType='${args.mimeType}'`);
+                }
+                if (args.query) {
+                    queryParts.push(`name contains '${args.query.replace(/'/g, "\\'")}'`);
+                }
+                const orderBy = args.orderBy === 'sharedWithMeTime'
+                    ? 'sharedWithMeTime desc'
+                    : args.orderBy === 'modifiedTime'
+                        ? 'modifiedTime desc'
+                        : 'name';
+                const response = await drive.files.list({
+                    q: queryParts.join(' and '),
+                    pageSize: args.maxResults,
+                    pageToken: args.pageToken || undefined,
+                    orderBy,
+                    fields: 'nextPageToken,files(id,name,mimeType,modifiedTime,sharedWithMeTime,sharingUser(displayName,emailAddress),webViewLink,owners(displayName))',
+                    supportsAllDrives: true,
+                    includeItemsFromAllDrives: true,
+                });
+                const items = response.data.files || [];
+                const folders = items
+                    .filter((f) => f.mimeType === 'application/vnd.google-apps.folder')
+                    .map((f) => ({
+                    id: f.id,
+                    name: f.name,
+                    sharedWithMeTime: f.sharedWithMeTime,
+                    sharedBy: f.sharingUser?.displayName || f.owners?.[0]?.displayName || null,
+                    sharedByEmail: f.sharingUser?.emailAddress || null,
+                }));
+                const files = items
+                    .filter((f) => f.mimeType !== 'application/vnd.google-apps.folder')
+                    .map((f) => ({
+                    id: f.id,
+                    name: f.name,
+                    mimeType: f.mimeType,
+                    modifiedTime: f.modifiedTime,
+                    sharedWithMeTime: f.sharedWithMeTime,
+                    sharedBy: f.sharingUser?.displayName || f.owners?.[0]?.displayName || null,
+                    sharedByEmail: f.sharingUser?.emailAddress || null,
+                }));
+                const result = {
+                    folders,
+                    files,
+                    nextPageToken: response.data.nextPageToken || null,
+                    totalCount: items.length,
+                };
+                return JSON.stringify(result, null, 2);
+            }
+            catch (error) {
+                log.error(`Error listing shared items: ${error.message || error}`);
+                if (error.code === 403)
+                    throw new UserError('Permission denied. Make sure you have the correct Drive API scopes.');
+                throw new UserError(`Failed to list shared items: ${error.message || 'Unknown error'}`);
+            }
+        },
+    });
+}