google-tools-mcp 1.0.9 → 1.0.11

package/README.md

@@ -1,6 +1,6 @@
 # google-tools-mcp
 
-A unified MCP server for Google Workspace — Drive, Docs, Sheets, Gmail, Calendar, and Forms — with **152 tools** across 9 categories.
+A unified MCP server for Google Workspace — Drive, Docs, Sheets, Gmail, Calendar, and Forms — with **153 tools** across 9 categories.
 
 All tools are loaded at startup so they're immediately available to your AI agent. No discovery step needed.
 
@@ -10,10 +10,10 @@ Most Google MCP servers split functionality across separate packages. This serve
 
 ## Features
 
-- **152 tools** across 9 categories, all available immediately
+- **153 tools** across 9 categories, all available immediately
 - **Single auth token** — one OAuth flow covers Drive, Docs, Sheets, Gmail, Calendar, and Forms
 - **Lazy-loading auth** — no browser popup until your first tool call
-- **No lazy tool loading** — all 150 tools are registered eagerly at startup since most MCP clients (including Claude Code) don't support `notifications/tools/list_changed`
+- **No lazy tool loading** — all 153 tools are registered eagerly at startup since most MCP clients (including Claude Code) don't support `notifications/tools/list_changed`
 - **Multi-profile support** — separate tokens per Google account
 - **No telemetry**
 
@@ -85,15 +85,28 @@ Add the credentials directly to your MCP configuration:
 
 #### Claude Code (recommended)
 
-If you used Option A or B above:
+**User-scope** (available in all projects):
+
+```bash
+claude mcp add -s user google -- npx -y google-tools-mcp
+```
+
+**Project-scope** (available only in the current project):
 
 ```bash
 claude mcp add google -- npx -y google-tools-mcp
 ```
 
-Or with env vars (Option C):
+With env vars (Option C):
 
 ```bash
+# User-scope
+claude mcp add -s user google \
+  -e GOOGLE_CLIENT_ID=your-client-id \
+  -e GOOGLE_CLIENT_SECRET=your-client-secret \
+  -- npx -y google-tools-mcp
+
+# Project-scope
 claude mcp add google \
   -e GOOGLE_CLIENT_ID=your-client-id \
   -e GOOGLE_CLIENT_SECRET=your-client-secret \
@@ -105,7 +118,7 @@ claude mcp add google \
 Via the `claude` CLI:
 
 ```bash
-claude mcp add google \
+claude mcp add -s user google \
   -e GOOGLE_MCP_PROFILE=myprofile \
   -- npx -y google-tools-mcp
 ```
@@ -169,10 +182,10 @@ This stores tokens in `~/.config/google-tools-mcp/work/` instead of the default
 
 ## Tool Categories
 
-### `files` (17 tools)
+### `files` (18 tools)
 Google Drive file management and content reading.
 
-`listDriveFiles`, `searchDocuments`, `getFileInfo`, `createFolder`, `listFolderContents`, `getFolderInfo`, `moveFile`, `copyFile`, `renameFile`, `deleteFile`, `createDocument`, `createDocumentFromTemplate`, `listSharedDrives`, `listSharedWithMe`, `downloadFile`, `readFile`, `searchFileContents`
+`listDriveFiles`, `searchDocuments`, `getFileInfo`, `getFilePath`, `createFolder`, `listFolderContents`, `getFolderInfo`, `moveFile`, `copyFile`, `renameFile`, `deleteFile`, `createDocument`, `createDocumentFromTemplate`, `listSharedDrives`, `listSharedWithMe`, `downloadFile`, `readFile`, `searchFileContents`
 
 ### `documents` (22 tools)
 Google Docs read/write/format with markdown support.

package/dist/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 // google-tools-mcp — Combined Google Workspace MCP server
 //
 // All tool categories (Drive, Docs, Sheets, Gmail, Calendar) are loaded at

package/dist/tools/calendar/manageEvent.js

@@ -69,6 +69,11 @@ export function register(server) {
                 .array(z.string())
                 .optional()
                 .describe('RRULE recurrence rules (e.g. ["RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR"]). Only for create.'),
+            send_updates: z
+                .enum(['all', 'externalOnly', 'none'])
+                .optional()
+                .default('all')
+                .describe('Who to send email notifications to: "all" = all attendees (default), "externalOnly" = non-Google Calendar attendees only, "none" = no emails.'),
         }),
         execute: async (args, { log }) => {
             const calendar = await getCalendarClient();
@@ -80,6 +85,7 @@ export function register(server) {
                     await calendar.events.delete({
                         calendarId: args.calendar_id,
                         eventId: args.event_id,
+                        sendUpdates: args.send_updates,
                     });
                     return JSON.stringify({ success: true, message: `Event ${args.event_id} deleted.` });
                 }
@@ -96,6 +102,7 @@ export function register(server) {
                         calendarId: args.calendar_id,
                         requestBody: eventBody,
                         conferenceDataVersion: args.add_google_meet ? 1 : 0,
+                        sendUpdates: args.send_updates,
                     };
 
                     const response = await calendar.events.insert(params);
@@ -119,6 +126,7 @@ export function register(server) {
                         eventId: args.event_id,
                         requestBody: eventBody,
                         conferenceDataVersion: args.add_google_meet !== undefined ? 1 : 0,
+                        sendUpdates: args.send_updates,
                     };
 
                     const response = await calendar.events.update(params);

package/dist/tools/calendar/moveEvent.js

@@ -17,6 +17,11 @@ export function register(server) {
             destination_calendar_id: z
                 .string()
                 .describe('Calendar ID to move the event to.'),
+            send_updates: z
+                .enum(['all', 'externalOnly', 'none'])
+                .optional()
+                .default('all')
+                .describe('Who to send email notifications to: "all" = all attendees (default), "externalOnly" = non-Google Calendar attendees only, "none" = no emails.'),
         }),
         execute: async (args, { log }) => {
             const calendar = await getCalendarClient();
@@ -29,6 +34,7 @@ export function register(server) {
                     calendarId: args.source_calendar_id,
                     eventId: args.event_id,
                     destination: args.destination_calendar_id,
+                    sendUpdates: args.send_updates,
                 });
 
                 const event = response.data;

package/dist/tools/docs/readGoogleDoc.js

@@ -7,13 +7,13 @@ import { docsJsonToMarkdown } from '../../markdown-transformer/index.js';
 export function register(server) {
     server.addTool({
         name: 'readDocument',
-        description: "Reads the content of a Google Document. Returns plain text by default. Use format='markdown' to get formatted content suitable for editing and re-uploading with replaceDocumentWithMarkdown, or format='json' for the raw document structure.",
+        description: "Reads the content of a Google Document. Returns markdown by default (formatted content suitable for editing and re-uploading with replaceDocumentWithMarkdown). Use format='text' for plain text, or format='json' for the raw document structure.",
         parameters: DocumentIdParameter.extend({
             format: z
                 .enum(['text', 'json', 'markdown'])
                 .optional()
-                .default('text')
-                .describe("Output format: 'text' (plain text), 'json' (raw API structure, complex), 'markdown' (experimental conversion)."),
+                .default('markdown')
+                .describe("Output format: 'markdown' (formatted content), 'text' (plain text), 'json' (raw API structure, complex)."),
             maxLength: z
                 .number()
                 .optional()

package/dist/tools/drive/getFilePath.js

@@ -0,0 +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'}`);
+            }
+        },
+    });
+}

package/dist/tools/drive/index.js

@@ -13,6 +13,7 @@ import { register as createFromTemplate } from './createFromTemplate.js';
 import { register as listSharedDrives } from './listSharedDrives.js';
 import { register as listSharedWithMe } from './listSharedWithMe.js';
 import { register as downloadFile } from './downloadFile.js';
+import { register as getFilePath } from './getFilePath.js';
 export function registerDriveTools(server) {
     listDriveFiles(server);
     searchGoogleDocs(server);
@@ -29,4 +30,5 @@ export function registerDriveTools(server) {
     listSharedDrives(server);
     listSharedWithMe(server);
     downloadFile(server);
+    getFilePath(server);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "google-tools-mcp",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Combined Google Workspace MCP server (Drive, Docs, Sheets, Gmail) with lazy-loaded tool categories",
   "type": "module",
   "bin": {