google-tools-mcp 1.0.16 → 1.1.1

package/dist/tools/docs/deleteRange.js

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { getDocsClient } from '../../clients.js';
 import { DocumentIdParameter } from '../../types.js';
 import * as GDocsHelpers from '../../googleDocsApiHelpers.js';
+import { guardMutation, trackMutation } from '../../readTracker.js';
 export function register(server) {
     server.addTool({
         name: 'deleteRange',
@@ -27,6 +28,7 @@ export function register(server) {
             path: ['endIndex'],
         }),
         execute: async (args, { log }) => {
+            await guardMutation(args.documentId);
             const docs = await getDocsClient();
             log.info(`Deleting range ${args.startIndex}-${args.endIndex} in doc ${args.documentId}${args.tabId ? ` (tab: ${args.tabId})` : ''}`);
             if (args.endIndex <= args.startIndex) {
@@ -59,7 +61,9 @@ export function register(server) {
                     deleteContentRange: { range },
                 };
                 await GDocsHelpers.executeBatchUpdate(docs, args.documentId, [request]);
-                return `Successfully deleted content in range ${args.startIndex}-${args.endIndex}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
+                trackMutation(args.documentId);
+                const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return `${docUrl}\nSuccessfully deleted content in range ${args.startIndex}-${args.endIndex}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
             }
             catch (error) {
                 log.error(`Error deleting range in doc ${args.documentId}: ${error.message || error}`);

package/dist/tools/docs/findAndReplace.js

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { getDocsClient } from '../../clients.js';
 import { DocumentIdParameter } from '../../types.js';
 import * as GDocsHelpers from '../../googleDocsApiHelpers.js';
+import { guardMutation, trackMutation } from '../../readTracker.js';
 const FindAndReplaceParameters = DocumentIdParameter.extend({
     findText: z.string().min(1).describe('The text to search for in the document.'),
     replaceText: z
@@ -24,6 +25,7 @@ export function register(server) {
             'Returns the number of replacements made. Use an empty replaceText to delete all matches.',
         parameters: FindAndReplaceParameters,
         execute: async (args, { log }) => {
+            await guardMutation(args.documentId);
             const docs = await getDocsClient();
             log.info(`findAndReplace in doc ${args.documentId}: "${args.findText}" → "${args.replaceText}"` +
                 `${args.matchCase ? ' (case-sensitive)' : ''}` +
@@ -40,8 +42,10 @@ export function register(server) {
                     },
                 };
                 const response = await GDocsHelpers.executeBatchUpdate(docs, args.documentId, [request]);
+                trackMutation(args.documentId);
                 const changed = response.replies?.[0]?.replaceAllText?.occurrencesChanged ?? 0;
-                return `Replaced ${changed} occurrence(s) of "${args.findText}" with "${args.replaceText}".`;
+                const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return `${docUrl}\nReplaced ${changed} occurrence(s) of "${args.findText}" with "${args.replaceText}".`;
             }
             catch (error) {
                 log.error(`Error in findAndReplace for doc ${args.documentId}: ${error.message || error}`);

package/dist/tools/docs/formatting/applyParagraphStyle.js

@@ -18,8 +18,8 @@ export function register(server) {
                 // STEP 1: Determine the target paragraph's range based on the targeting method
                 if ('textToFind' in args.target) {
                     // Find the text first
-                    log.info(`Finding text "${args.target.textToFind}" (instance ${args.target.matchInstance || 1})${args.tabId ? ` in tab ${args.tabId}` : ''}`);
-                    const textRange = await GDocsHelpers.findTextRange(docs, args.documentId, args.target.textToFind, args.target.matchInstance || 1, args.tabId);
+                    log.info(`Finding text "${args.target.textToFind}" (instance ${args.target.matchInstance ?? 'auto'})${args.tabId ? ` in tab ${args.tabId}` : ''}`);
+                    const textRange = await GDocsHelpers.findTextRange(docs, args.documentId, args.target.textToFind, args.target.matchInstance, args.tabId);
                     if (!textRange) {
                         throw new UserError(`Could not find "${args.target.textToFind}" in the document${args.tabId ? ` (tab: ${args.tabId})` : ''}.`);
                     }
@@ -65,7 +65,8 @@ export function register(server) {
                 }
                 log.info(`Applying styles: ${requestInfo.fields.join(', ')}`);
                 await GDocsHelpers.executeBatchUpdate(docs, args.documentId, [requestInfo.request]);
-                return `Successfully applied paragraph styles (${requestInfo.fields.join(', ')}) to the paragraph${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
+                const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return `${docUrl}\nSuccessfully applied paragraph styles (${requestInfo.fields.join(', ')}) to the paragraph${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
             }
             catch (error) {
                 // Detailed error logging

package/dist/tools/docs/insertImage.js

@@ -76,7 +76,8 @@ export function register(server) {
                     );
                     log.info(`[AppsScript] Inserting image via marker at index ${args.index} (fileId: ${driveFileId})`);
                     await GDocsHelpers.insertImageViaAppsScript(docs, scriptClient, appsScriptDeploymentId, args.documentId, driveFileId, args.index, args.tabId);
-                    return `Successfully inserted local image at index ${args.index} via Apps Script${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
+                    const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                    return `${docUrl}\nSuccessfully inserted local image at index ${args.index} via Apps Script${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
                 }
                 // --- Standard path: public URL insertion via Docs API ---
                 let resolvedUrl;
@@ -109,7 +110,8 @@ export function register(server) {
                 if (args.width && args.height) {
                     sizeInfo = ` with size ${args.width}x${args.height}pt`;
                 }
-                return `Successfully inserted image at index ${args.index}${sizeInfo}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
+                const docUrl2 = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return `${docUrl2}\nSuccessfully inserted image at index ${args.index}${sizeInfo}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
             }
             catch (error) {
                 log.error(`Error inserting image in doc ${args.documentId}: ${error.message || error}`);

package/dist/tools/docs/insertPageBreak.js

@@ -45,7 +45,8 @@ export function register(server) {
                     insertPageBreak: { location },
                 };
                 await GDocsHelpers.executeBatchUpdate(docs, args.documentId, [request]);
-                return `Successfully inserted page break at index ${args.index}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
+                const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return `${docUrl}\nSuccessfully inserted page break at index ${args.index}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
             }
             catch (error) {
                 log.error(`Error inserting page break in doc ${args.documentId}: ${error.message || error}`);

package/dist/tools/docs/insertTable.js

@@ -40,7 +40,8 @@ export function register(server) {
                     }
                 }
                 await GDocsHelpers.createTable(docs, args.documentId, args.rows, args.columns, args.index, args.tabId);
-                return `Successfully inserted a ${args.rows}x${args.columns} table at index ${args.index}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
+                const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return `${docUrl}\nSuccessfully inserted a ${args.rows}x${args.columns} table at index ${args.index}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
             }
             catch (error) {
                 log.error(`Error inserting table in doc ${args.documentId}: ${error.message || error}`);

package/dist/tools/docs/insertTableWithData.js

@@ -119,7 +119,8 @@ export function register(server) {
                 }
                 const requests = buildInsertTableWithDataRequests(args.data, args.index, args.hasHeaderRow ?? false, args.tabId);
                 const metadata = await GDocsHelpers.executeBatchUpdateWithSplitting(docs, args.documentId, requests, log);
-                return (`Successfully inserted a ${numRows}x${numCols} table with data at index ${args.index}` +
+                const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return (`${docUrl}\nSuccessfully inserted a ${numRows}x${numCols} table with data at index ${args.index}` +
                     `${args.tabId ? ` in tab ${args.tabId}` : ''}. ` +
                     `${args.hasHeaderRow ? 'Header row bolded. ' : ''}` +
                     `(${metadata.totalRequests} requests in ${metadata.totalApiCalls} API calls, ${metadata.totalElapsedMs}ms)`);

package/dist/tools/docs/modifyText.js

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { getDocsClient } from '../../clients.js';
 import { DocumentIdParameter, TextFindParameter, TextStyleParameters, ParagraphStyleParameters } from '../../types.js';
 import * as GDocsHelpers from '../../googleDocsApiHelpers.js';
+import { guardMutation, trackMutation } from '../../readTracker.js';
 const RangeTarget = z
     .object({
     startIndex: z.number().int().min(1).describe('Start of range (inclusive, 1-based).'),
@@ -42,17 +43,17 @@ const ModifyTextParameters = DocumentIdParameter.extend({
 export function buildModifyTextRequests(opts) {
     const { startIndex, endIndex, text, style, paragraphStyle, tabId } = opts;
     const requests = [];
-    if (!text && !style && !paragraphStyle)
+    if (text === undefined && !style && !paragraphStyle)
         return requests;
-    // 1. Delete existing content (only when replacing, not insert-only)
+    // 1. Delete existing content (when replacing or deleting)
     if (endIndex !== undefined && text !== undefined) {
         const range = { startIndex, endIndex };
         if (tabId)
             range.tabId = tabId;
         requests.push({ deleteContentRange: { range } });
     }
-    // 2. Insert new text
-    if (text !== undefined) {
+    // 2. Insert new text (skip if empty string — that means "delete only")
+    if (text !== undefined && text !== '') {
         const location = { index: startIndex };
         if (tabId)
             location.tabId = tabId;
@@ -93,11 +94,17 @@ export function buildModifyTextRequests(opts) {
 export function register(server) {
     server.addTool({
         name: 'modifyText',
-        description: 'Combines text replacement/insertion and formatting in one atomic operation. ' +
-            'Can insert text at a position, replace a range or found text, apply text styling (bold, italic, etc.), ' +
-            "apply paragraph styling (alignment, headings, spacing, etc.), or any combination. Use readGoogleDoc with format='json' to determine indices.",
+        description: 'Best for small, targeted, single-location changes within a line or paragraph. ' +
+            'Can insert text at a position, replace a range or found text, delete text (replace with empty string ""), ' +
+            'apply text styling (bold, italic, etc.), apply paragraph styling (alignment, headings, spacing, etc.), or any combination. ' +
+            "Use readDocument with format='json' to determine indices. " +
+            'Supports \\n for line breaks and \\t for tabs in replacement text. ' +
+            'When using textToFind, if multiple matches exist the tool returns all instances with context so you can specify matchInstance. ' +
+            'For multi-line or section-level rewrites, use replaceDocumentWithMarkdown instead. ' +
+            'To add content to the end of a doc, use appendMarkdown or appendText.',
         parameters: ModifyTextParameters,
         execute: async (args, { log }) => {
+            await guardMutation(args.documentId);
             const docs = await getDocsClient();
             log.info(`modifyText on doc ${args.documentId}: target=${JSON.stringify(args.target)}` +
                 `${args.text !== undefined ? `, text="${args.text.substring(0, 50)}"` : ''}` +
@@ -130,7 +137,7 @@ export function register(server) {
                 else if ('textToFind' in args.target) {
                     const range = await GDocsHelpers.findTextRange(docs, args.documentId, args.target.textToFind, args.target.matchInstance, args.tabId);
                     if (!range) {
-                        throw new UserError(`Could not find instance ${args.target.matchInstance ?? 1} of text "${args.target.textToFind}"${args.tabId ? ` in tab ${args.tabId}` : ''}.`);
+                        throw new UserError(`Could not find text "${args.target.textToFind}"${args.target.matchInstance ? ` (instance ${args.target.matchInstance})` : ''}${args.tabId ? ` in tab ${args.tabId}` : ''}.`);
                     }
                     startIndex = range.startIndex;
                     endIndex = range.endIndex;
@@ -143,10 +150,15 @@ export function register(server) {
                 // Clamp to minimum 1 (index 0 is the document section break)
                 if (startIndex < 1)
                     startIndex = 1;
+                // Normalize escape sequences so literal \n / \t in the input
+                // are converted to real newline / tab characters (issue #9).
+                const normalizedText = args.text
+                    ?.replace(/\\n/g, '\n')
+                    .replace(/\\t/g, '\t');
                 const requests = buildModifyTextRequests({
                     startIndex,
                     endIndex,
-                    text: args.text,
+                    text: normalizedText,
                     style: args.style,
                     paragraphStyle: args.paragraphStyle,
                     tabId: args.tabId,
@@ -155,9 +167,12 @@ export function register(server) {
                     return 'No operations to perform.';
                 }
                 await GDocsHelpers.executeBatchUpdate(docs, args.documentId, requests);
+                trackMutation(args.documentId);
                 // Build descriptive result
                 const actions = [];
-                if (endIndex !== undefined && args.text !== undefined)
+                if (endIndex !== undefined && normalizedText === '')
+                    actions.push('deleted text');
+                else if (endIndex !== undefined && args.text !== undefined)
                     actions.push('replaced text');
                 else if (args.text !== undefined)
                     actions.push('inserted text');
@@ -165,7 +180,8 @@ export function register(server) {
                     actions.push('applied text formatting');
                 if (args.paragraphStyle)
                     actions.push('applied paragraph formatting');
-                return `Successfully ${actions.join(' and ')} at range ${startIndex}-${endIndex ?? startIndex + (args.text?.length ?? 0)}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
+                const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return `${docUrl}\nSuccessfully ${actions.join(' and ')} at range ${startIndex}-${endIndex ?? startIndex + (args.text?.length ?? 0)}${args.tabId ? ` in tab ${args.tabId}` : ''}.`;
             }
             catch (error) {
                 log.error(`Error in modifyText for doc ${args.documentId}: ${error.message || error}`);

package/dist/tools/docs/modifyText.test.js

@@ -0,0 +1,90 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { buildModifyTextRequests } from './modifyText.js';
+
+describe('buildModifyTextRequests', () => {
+  it('generates deleteContentRange + insertText for a replacement', () => {
+    const reqs = buildModifyTextRequests({
+      startIndex: 5,
+      endIndex: 10,
+      text: 'hello',
+    });
+    assert.equal(reqs.length, 2);
+    assert.deepEqual(reqs[0], {
+      deleteContentRange: { range: { startIndex: 5, endIndex: 10 } },
+    });
+    assert.deepEqual(reqs[1], {
+      insertText: { location: { index: 5 }, text: 'hello' },
+    });
+  });
+
+  it('generates only insertText for an insertion (no endIndex)', () => {
+    const reqs = buildModifyTextRequests({
+      startIndex: 3,
+      endIndex: undefined,
+      text: 'hi',
+    });
+    assert.equal(reqs.length, 1);
+    assert.deepEqual(reqs[0], {
+      insertText: { location: { index: 3 }, text: 'hi' },
+    });
+  });
+
+  it('returns empty array when no text/style/paragraphStyle given', () => {
+    const reqs = buildModifyTextRequests({
+      startIndex: 1,
+      endIndex: 5,
+    });
+    assert.equal(reqs.length, 0);
+  });
+
+  it('includes tabId in range and location when provided', () => {
+    const reqs = buildModifyTextRequests({
+      startIndex: 1,
+      endIndex: 4,
+      text: 'x',
+      tabId: 'tab1',
+    });
+    assert.deepEqual(reqs[0].deleteContentRange.range.tabId, 'tab1');
+    assert.deepEqual(reqs[1].insertText.location.tabId, 'tab1');
+  });
+});
+
+describe('escape sequence normalization (issue #9)', () => {
+  // Simulate the normalization that happens in the execute handler
+  function normalize(text) {
+    return text?.replace(/\\n/g, '\n').replace(/\\t/g, '\t');
+  }
+
+  it('converts literal \\n to real newline', () => {
+    const input = 'line one\\nline two\\nline three';
+    const result = normalize(input);
+    assert.equal(result, 'line one\nline two\nline three');
+  });
+
+  it('converts literal \\t to real tab', () => {
+    const input = 'col1\\tcol2\\tcol3';
+    const result = normalize(input);
+    assert.equal(result, 'col1\tcol2\tcol3');
+  });
+
+  it('handles mixed \\n and \\t', () => {
+    const input = 'row1\\tcol2\\nrow2\\tcol2';
+    const result = normalize(input);
+    assert.equal(result, 'row1\tcol2\nrow2\tcol2');
+  });
+
+  it('leaves text without escape sequences unchanged', () => {
+    const input = 'no escapes here';
+    assert.equal(normalize(input), 'no escapes here');
+  });
+
+  it('preserves real newlines that are already in the string', () => {
+    const input = 'already\nreal';
+    assert.equal(normalize(input), 'already\nreal');
+  });
+
+  it('returns undefined for undefined input', () => {
+    assert.equal(normalize(undefined), undefined);
+  });
+});

package/dist/tools/docs/readGoogleDoc.js

@@ -4,6 +4,7 @@ import { getDocsClient, getDriveClient } from '../../clients.js';
 import { DocumentIdParameter, NotImplementedError } from '../../types.js';
 import * as GDocsHelpers from '../../googleDocsApiHelpers.js';
 import { docsJsonToMarkdown } from '../../markdown-transformer/index.js';
+import { trackRead } from '../../readTracker.js';
 export function register(server) {
     server.addTool({
         name: 'readDocument',
@@ -38,6 +39,7 @@ export function register(server) {
                     fields: needsTabsContent ? '*' : fields, // Get full document if using tabs
                 });
                 log.info(`Fetched doc: ${args.documentId}${args.tabId ? ` (tab: ${args.tabId})` : ''}`);
+                trackRead(args.documentId);
                 // If tabId is specified, find the specific tab
                 let contentSource;
                 if (args.tabId) {

package/dist/tools/docs/renameTab.js

@@ -44,7 +44,8 @@ export function register(server) {
                         ],
                     },
                 });
-                return `Successfully renamed tab from "${oldTitle}" to "${args.newTitle}".`;
+                const docUrl = `https://docs.google.com/document/d/${args.documentId}/edit`;
+                return `${docUrl}\nSuccessfully renamed tab from "${oldTitle}" to "${args.newTitle}".`;
             }
             catch (error) {
                 log.error(`Error renaming tab ${args.tabId} in doc ${args.documentId}: ${error.message || error}`);

package/dist/tools/drive/deleteFile.js

@@ -1,6 +1,7 @@
 import { UserError } from 'fastmcp';
 import { z } from 'zod';
 import { getDriveClient } from '../../clients.js';
+import { guardMutation } from '../../readTracker.js';
 export function register(server) {
     server.addTool({
         name: 'deleteFile',
@@ -16,6 +17,7 @@ export function register(server) {
                 .describe('If true, permanently deletes the file instead of moving it to trash.'),
         }),
         execute: async (args, { log }) => {
+            await guardMutation(args.fileId, { skipExternalCheck: true });
             const drive = await getDriveClient();
             log.info(`Deleting file ${args.fileId} ${args.permanent ? '(permanent)' : '(to trash)'}`);
             try {

package/dist/tools/drive/index.js

@@ -14,6 +14,7 @@ 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';
+import { register as uploadFile } from './uploadFile.js';
 export function registerDriveTools(server) {
     listDriveFiles(server);
     searchGoogleDocs(server);
@@ -31,4 +32,5 @@ export function registerDriveTools(server) {
     listSharedWithMe(server);
     downloadFile(server);
     getFilePath(server);
+    uploadFile(server);
 }

package/dist/tools/drive/moveFile.js

@@ -31,7 +31,7 @@ export function register(server) {
                 let updateParams = {
                     fileId: args.fileId,
                     addParents: args.newParentId,
-                    fields: 'id,name,parents',
+                    fields: 'id,name,parents,webViewLink',
                     supportsAllDrives: true,
                 };
                 if (args.removeFromAllParents && currentParents.length > 0) {
@@ -39,7 +39,8 @@ export function register(server) {
                 }
                 const response = await drive.files.update(updateParams);
                 const action = args.removeFromAllParents ? 'moved' : 'copied';
-                return `Successfully ${action} "${fileName}" to new location.\nFile ID: ${response.data.id}`;
+                const fileUrl = response.data.webViewLink || `https://drive.google.com/file/d/${response.data.id}/view`;
+                return `${fileUrl}\nSuccessfully ${action} "${fileName}" to new location.\nFile ID: ${response.data.id}`;
             }
             catch (error) {
                 log.error(`Error moving file: ${error.message || error}`);

package/dist/tools/drive/uploadFile.js

@@ -0,0 +1,111 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { UserError } from 'fastmcp';
+import { z } from 'zod';
+import { getDriveClient } from '../../clients.js';
+
+// Common MIME type mappings for file extensions
+const MIME_TYPES = {
+    '.pdf': 'application/pdf',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    '.txt': 'text/plain',
+    '.csv': 'text/csv',
+    '.json': 'application/json',
+    '.xml': 'application/xml',
+    '.html': 'text/html',
+    '.htm': 'text/html',
+    '.md': 'text/markdown',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+    '.mp3': 'audio/mpeg',
+    '.mp4': 'video/mp4',
+    '.zip': 'application/zip',
+    '.gz': 'application/gzip',
+    '.tar': 'application/x-tar',
+};
+
+export function register(server) {
+    server.addTool({
+        name: 'uploadFile',
+        description:
+            'Uploads a local file from the filesystem to Google Drive. ' +
+            'Auto-detects MIME type from file extension. ' +
+            'Returns the uploaded file\'s Drive ID and URL.',
+        parameters: z.object({
+            localPath: z.string().describe('Absolute path to the local file to upload.'),
+            name: z
+                .string()
+                .optional()
+                .describe('Custom name for the file in Drive. If not provided, uses the local filename.'),
+            parentFolderId: z
+                .string()
+                .optional()
+                .describe('ID of the Drive folder to upload into. If not provided, uploads to the root of My Drive.'),
+            mimeType: z
+                .string()
+                .optional()
+                .describe('MIME type override. If not provided, auto-detected from file extension.'),
+        }),
+        execute: async (args, { log }) => {
+            const drive = await getDriveClient();
+
+            // Validate file exists
+            if (!fs.existsSync(args.localPath)) {
+                throw new UserError(`File not found: ${args.localPath}`);
+            }
+
+            const stats = fs.statSync(args.localPath);
+            if (!stats.isFile()) {
+                throw new UserError(`Path is not a file: ${args.localPath}`);
+            }
+
+            const fileName = args.name || path.basename(args.localPath);
+            const ext = path.extname(args.localPath).toLowerCase();
+            const mimeType = args.mimeType || MIME_TYPES[ext] || 'application/octet-stream';
+
+            log.info(`Uploading "${args.localPath}" as "${fileName}" (${mimeType}, ${stats.size} bytes)`);
+
+            try {
+                const fileMetadata = { name: fileName };
+                if (args.parentFolderId) {
+                    fileMetadata.parents = [args.parentFolderId];
+                }
+
+                const response = await drive.files.create({
+                    requestBody: fileMetadata,
+                    media: {
+                        mimeType,
+                        body: fs.createReadStream(args.localPath),
+                    },
+                    fields: 'id,name,webViewLink,mimeType,size',
+                    supportsAllDrives: true,
+                });
+
+                const file = response.data;
+                return JSON.stringify({
+                    id: file.id,
+                    name: file.name,
+                    url: file.webViewLink,
+                    mimeType: file.mimeType,
+                    size: file.size,
+                }, null, 2);
+            } catch (error) {
+                log.error(`Error uploading file: ${error.message || error}`);
+                if (error.code === 404)
+                    throw new UserError('Destination folder not found. Check the parentFolderId.');
+                if (error.code === 403)
+                    throw new UserError('Permission denied. Make sure you have write access to the destination folder.');
+                throw new UserError(`Failed to upload file: ${error.message || 'Unknown error'}`);
+            }
+        },
+    });
+}

package/dist/tools/extras/index.js

@@ -1,7 +1,9 @@
 import { register as readFile } from './readFile.js';
 import { register as searchFileContents } from './searchFileContents.js';
+import { register as readDriveFile } from './readDriveFile.js';
 
 export function registerExtrasTools(server) {
     readFile(server);
     searchFileContents(server);
+    readDriveFile(server);
 }