google-tools-mcp 1.0.11 → 1.0.13

package/dist/auth.js

@@ -269,8 +269,25 @@ export async function authorize() {
     logger.info('Attempting OAuth 2.0 authentication...');
     const client = await loadSavedCredentialsIfExist();
     if (client) {
-        logger.info('Using saved credentials.');
-        return client;
+        // Proactively refresh to verify the token is still valid
+        try {
+            const { credentials } = await client.refreshAccessToken();
+            client.setCredentials(credentials);
+            if (credentials.refresh_token) {
+                await saveCredentials(client);
+            }
+            logger.info('Using saved credentials (token refreshed successfully).');
+            return client;
+        } catch (err) {
+            const isInvalidGrant = err.message?.includes('invalid_grant') ||
+                err.response?.data?.error === 'invalid_grant';
+            if (isInvalidGrant) {
+                logger.warn('Saved refresh token is invalid/revoked. Starting re-authentication...');
+                try { await fs.unlink(getTokenPath()); } catch {}
+                return authenticate();
+            }
+            throw err;
+        }
     }
     logger.info('No saved token found. Starting interactive authentication flow...');
     return authenticate();

package/dist/clients.js

@@ -31,6 +31,33 @@ async function ensureAuth() {
     }
 }
 
+/**
+ * Re-authenticate and rebuild all API clients after an invalid_grant error.
+ */
+async function reauthorize() {
+    logger.info('Re-authorizing after invalid_grant...');
+    authClient = null;
+    googleDocs = null;
+    googleDrive = null;
+    googleSheets = null;
+    googleScript = null;
+    gmailClient = null;
+    calendarClient = null;
+    formsClient = null;
+    authClient = await authorize();
+    logger.info('Re-authorization successful.');
+}
+
+/**
+ * Check if an error is an invalid_grant error (expired/revoked refresh token).
+ */
+function isInvalidGrantError(error) {
+    if (!error) return false;
+    const msg = error.message || '';
+    const code = error.response?.data?.error || error.code || '';
+    return msg.includes('invalid_grant') || code === 'invalid_grant';
+}
+
 // --- GDrive clients ---
 export async function initializeGoogleClient() {
     if (googleDocs && googleDrive && googleSheets)
@@ -79,6 +106,24 @@ export function resetClients() {
     formsClient = null;
 }
 
+/**
+ * Execute a function with automatic re-auth on invalid_grant errors.
+ * Wraps any API call so that if the refresh token has been revoked mid-session,
+ * we re-authenticate transparently and retry once.
+ */
+export async function withAuthRetry(fn) {
+    try {
+        return await fn();
+    } catch (error) {
+        if (isInvalidGrantError(error)) {
+            logger.warn('Got invalid_grant during API call. Re-authenticating...');
+            await reauthorize();
+            return await fn();
+        }
+        throw error;
+    }
+}
+
 // --- Individual client getters ---
 export async function getDocsClient() {
     const { googleDocs: docs } = await initializeGoogleClient();

package/dist/helpers.js

@@ -109,6 +109,8 @@ export const wrapTextBody = (text) => text.split('\n').map(line => {
     return chunks.join('=\n');
 }).join('\n');
 
+export const isHtmlBody = (text) => /<\/?[a-z][\s\S]*?>/i.test(text);
+
 export const constructRawMessage = async (gmail, params) => {
     let thread = null;
     if (params.threadId) {
@@ -126,11 +128,12 @@ export const constructRawMessage = async (gmail, params) => {
     } else {
         message.push('Subject: (No Subject)');
     }
-    message.push('Content-Type: text/plain; charset="UTF-8"');
+    const htmlMode = params.body && isHtmlBody(params.body);
+    message.push(`Content-Type: ${htmlMode ? 'text/html' : 'text/plain'}; charset="UTF-8"`);
     message.push('Content-Transfer-Encoding: quoted-printable');
     message.push('MIME-Version: 1.0');
     message.push('');
-    if (params.body) message.push(wrapTextBody(params.body));
+    if (params.body) message.push(htmlMode ? params.body : wrapTextBody(params.body));
     if (thread) {
         const quotedContent = getQuotedContent(thread);
         if (quotedContent) {
@@ -168,9 +171,10 @@ export const constructRawMessageWithAttachments = async (gmail, params) => {
         const quotedContent = getQuotedContent(thread);
         if (quotedContent) bodyText += '\n\n' + quotedContent;
     }
+    const htmlMode = isHtmlBody(bodyText);
     parts.push([
         `--${boundary}`,
-        'Content-Type: text/plain; charset="UTF-8"',
+        `Content-Type: ${htmlMode ? 'text/html' : 'text/plain'}; charset="UTF-8"`,
         'Content-Transfer-Encoding: base64',
         '',
         Buffer.from(bodyText).toString('base64'),

package/dist/tools/drafts.js

@@ -15,7 +15,7 @@ export function register(server) {
             cc: z.array(z.string()).optional().describe("List of CC recipient email addresses"),
             bcc: z.array(z.string()).optional().describe("List of BCC recipient email addresses"),
             subject: z.string().optional().describe("The subject of the email"),
-            body: z.string().optional().describe("The body of the email"),
+            body: z.string().optional().describe("The body of the email. Supports plain text or HTML (auto-detected). Use HTML tags like <p>, <br>, <b> for formatted emails."),
             attachments: z.array(z.object({
                 filename: z.string().describe("Attachment file name"),
                 mimeType: z.string().describe("MIME type of the attachment"),
@@ -56,7 +56,7 @@ export function register(server) {
             cc: z.array(z.string()).optional().describe("List of CC recipient email addresses"),
             bcc: z.array(z.string()).optional().describe("List of BCC recipient email addresses"),
             subject: z.string().optional().describe("The subject of the email"),
-            body: z.string().optional().describe("The body of the email"),
+            body: z.string().optional().describe("The body of the email. Supports plain text or HTML (auto-detected). Use HTML tags like <p>, <br>, <b> for formatted emails."),
             attachments: z.array(z.object({
                 filename: z.string().describe("Attachment file name"),
                 mimeType: z.string().describe("MIME type of the attachment"),

package/dist/tools/gmail/drafts.js

@@ -15,7 +15,7 @@ export function register(server) {
             cc: z.array(z.string()).optional().describe("List of CC recipient email addresses"),
             bcc: z.array(z.string()).optional().describe("List of BCC recipient email addresses"),
             subject: z.string().optional().describe("The subject of the email"),
-            body: z.string().optional().describe("The body of the email"),
+            body: z.string().optional().describe("The body of the email. Supports plain text or HTML (auto-detected). Use HTML tags like <p>, <br>, <b> for formatted emails."),
             attachments: z.array(z.object({
                 filename: z.string().describe("Attachment file name"),
                 mimeType: z.string().describe("MIME type of the attachment"),
@@ -56,7 +56,7 @@ export function register(server) {
             cc: z.array(z.string()).optional().describe("List of CC recipient email addresses"),
             bcc: z.array(z.string()).optional().describe("List of BCC recipient email addresses"),
             subject: z.string().optional().describe("The subject of the email"),
-            body: z.string().optional().describe("The body of the email"),
+            body: z.string().optional().describe("The body of the email. Supports plain text or HTML (auto-detected). Use HTML tags like <p>, <br>, <b> for formatted emails."),
             attachments: z.array(z.object({
                 filename: z.string().describe("Attachment file name"),
                 mimeType: z.string().describe("MIME type of the attachment"),

package/dist/tools/gmail/messages.js

@@ -14,7 +14,7 @@ export function register(server) {
             cc: z.array(z.string()).optional().describe("List of CC recipient email addresses"),
             bcc: z.array(z.string()).optional().describe("List of BCC recipient email addresses"),
             subject: z.string().optional().describe("The subject of the email"),
-            body: z.string().optional().describe("The body of the email"),
+            body: z.string().optional().describe("The body of the email. Supports plain text or HTML (auto-detected). Use HTML tags like <p>, <br>, <b> for formatted emails."),
             attachments: z.array(z.object({
                 filename: z.string().describe("Attachment file name"),
                 mimeType: z.string().describe("MIME type of the attachment"),
@@ -49,7 +49,7 @@ export function register(server) {
         description: 'Reply to a message. Automatically handles To/Cc recipients, subject prefix, threading headers, and quoted content. Use replyAll to include all original recipients.',
         parameters: z.object({
             messageId: z.string().describe("The ID of the message to reply to"),
-            body: z.string().describe("The reply body text"),
+            body: z.string().describe("The reply body text. Supports plain text or HTML (auto-detected). Use HTML tags like <p>, <br>, <b> for formatted replies."),
             replyAll: z.boolean().optional().describe("If true, reply to all original recipients (To + Cc minus yourself). Default: false"),
             to: z.array(z.string()).optional().describe("Override recipient list (if omitted, replies to sender or Reply-To)"),
             cc: z.array(z.string()).optional().describe("Override CC list (if omitted and replyAll, uses original To + Cc minus yourself)"),
@@ -168,7 +168,7 @@ export function register(server) {
             to: z.array(z.string()).describe("Recipient email addresses to forward to"),
             cc: z.array(z.string()).optional().describe("CC recipient email addresses"),
             bcc: z.array(z.string()).optional().describe("BCC recipient email addresses"),
-            body: z.string().optional().describe("Optional commentary to prepend above the forwarded content"),
+            body: z.string().optional().describe("Optional commentary to prepend above the forwarded content. Supports plain text or HTML (auto-detected)."),
             includeAttachments: z.boolean().optional().describe("Whether to include original attachments. Default: true"),
             includeBodyHtml: z.boolean().optional().describe("Whether to include the parsed HTML in the return"),
         }),

package/dist/tools/index.js

@@ -6,9 +6,26 @@ import * as fs from 'fs/promises';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import { getTokenPath } from '../auth.js';
-import { resetClients } from '../clients.js';
+import { resetClients, withAuthRetry } from '../clients.js';
 import { logger } from '../logger.js';
 
+// ---------------------------------------------------------------------------
+// Wrap server.addTool so every tool's execute() auto-retries on invalid_grant.
+// ---------------------------------------------------------------------------
+function wrapServerWithAuthRetry(server) {
+    const originalAddTool = server.addTool.bind(server);
+    server.addTool = function (toolDef) {
+        const originalExecute = toolDef.execute;
+        if (originalExecute) {
+            toolDef.execute = function (...args) {
+                return withAuthRetry(() => originalExecute.apply(this, args));
+            };
+        }
+        return originalAddTool(toolDef);
+    };
+    return server;
+}
+
 // --- Category registry ---
 const CATEGORIES = {
     files: {
@@ -77,9 +94,12 @@ const CATEGORIES = {
 // Public: register all tools eagerly, plus the logout utility.
 // ---------------------------------------------------------------------------
 export async function registerAllTools(server) {
+    // Wrap server so every tool auto-retries on invalid_grant (expired refresh token)
+    const wrappedServer = wrapServerWithAuthRetry(server);
+
     // Load every category
     for (const [name, { loader }] of Object.entries(CATEGORIES)) {
-        await loader(server);
+        await loader(wrappedServer);
     }
     logger.info(`Loaded all ${Object.keys(CATEGORIES).length} categories at startup.`);
 

package/dist/tools/messages.js

@@ -14,7 +14,7 @@ export function register(server) {
             cc: z.array(z.string()).optional().describe("List of CC recipient email addresses"),
             bcc: z.array(z.string()).optional().describe("List of BCC recipient email addresses"),
             subject: z.string().optional().describe("The subject of the email"),
-            body: z.string().optional().describe("The body of the email"),
+            body: z.string().optional().describe("The body of the email. Supports plain text or HTML (auto-detected). Use HTML tags like <p>, <br>, <b> for formatted emails."),
             attachments: z.array(z.object({
                 filename: z.string().describe("Attachment file name"),
                 mimeType: z.string().describe("MIME type of the attachment"),

package/package.json

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