google-tools-mcp 1.0.12 → 1.0.14

package/README.md

@@ -235,6 +235,7 @@ Google Forms — create/read forms, manage responses, and publish settings.
 | `GOOGLE_CLIENT_SECRET` | No* | OAuth 2.0 Client Secret |
 | `GOOGLE_MCP_PROFILE` | No | Profile name for multi-account support (see above) |
 | `LOG_LEVEL` | No | `debug`, `info`, `warn`, `error`, or `silent` |
+| `GOOGLE_MCP_LOG_FILE` | No | Set to `1` to log to `~/.config/google-tools-mcp/server.log`, or set to a custom file path |
 | `SERVICE_ACCOUNT_PATH` | No | Path to service account JSON key (alternative to OAuth) |
 | `GOOGLE_IMPERSONATE_USER` | No | Email to impersonate with service account |
 

package/dist/auth.js

@@ -271,12 +271,16 @@ export async function authorize() {
     if (client) {
         // Proactively refresh to verify the token is still valid
         try {
+            logger.info('Refreshing access token...');
             const { credentials } = await client.refreshAccessToken();
             client.setCredentials(credentials);
             if (credentials.refresh_token) {
                 await saveCredentials(client);
             }
-            logger.info('Using saved credentials (token refreshed successfully).');
+            const expiryDate = credentials.expiry_date
+                ? new Date(credentials.expiry_date).toISOString()
+                : 'unknown';
+            logger.info(`Token refreshed successfully. Expires: ${expiryDate}`);
             return client;
         } catch (err) {
             const isInvalidGrant = err.message?.includes('invalid_grant') ||
@@ -286,6 +290,7 @@ export async function authorize() {
                 try { await fs.unlink(getTokenPath()); } catch {}
                 return authenticate();
             }
+            logger.error('Token refresh failed:', err.message || err);
             throw err;
         }
     }

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/index.js

@@ -24,14 +24,26 @@ if (process.argv[2] === 'auth') {
     }
 }
 
-// --- Server startup ---
+// --- Process lifecycle logging ---
 process.on('uncaughtException', (error) => {
     logger.error('Uncaught Exception:', error);
 });
 process.on('unhandledRejection', (reason, _promise) => {
     logger.error('Unhandled Promise Rejection:', reason);
 });
+process.on('SIGINT', () => {
+    logger.info('Received SIGINT — shutting down.');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    logger.info('Received SIGTERM — shutting down.');
+    process.exit(0);
+});
+process.on('exit', (code) => {
+    logger.info(`Process exiting with code ${code}.`);
+});
 
+// --- Server startup ---
 const server = new FastMCP({
     name: 'google-tools-mcp',
     version: '1.0.0',

package/dist/logger.js

@@ -1,5 +1,10 @@
 // Centralized logger with LOG_LEVEL support.
 // All log output goes to stderr (stdout reserved for MCP protocol).
+// If GOOGLE_MCP_LOG_FILE is set, logs are also appended to that file.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+
 const LOG_LEVELS = {
     debug: 0,
     info: 1,
@@ -21,25 +26,62 @@ export function refreshLogLevel() {
 function shouldLog(level) {
     return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel];
 }
-export const logger = {
-    debug(...args) {
-        if (shouldLog('debug')) {
-            console.error('[DEBUG]', ...args);
-        }
-    },
-    info(...args) {
-        if (shouldLog('info')) {
-            console.error('[INFO]', ...args);
-        }
-    },
-    warn(...args) {
-        if (shouldLog('warn')) {
-            console.error('[WARN]', ...args);
-        }
-    },
-    error(...args) {
-        if (shouldLog('error')) {
-            console.error('[ERROR]', ...args);
+
+// --- File logging ---
+let logStream = null;
+
+function getDefaultLogPath() {
+    const xdg = process.env.XDG_CONFIG_HOME;
+    const base = xdg || path.join(os.homedir(), '.config');
+    const baseDir = path.join(base, 'google-tools-mcp');
+    const profile = process.env.GOOGLE_MCP_PROFILE;
+    const dir = profile ? path.join(baseDir, profile) : baseDir;
+    return path.join(dir, 'server.log');
+}
+
+function initLogFile() {
+    if (logStream) return;
+    const logPath = process.env.GOOGLE_MCP_LOG_FILE === '1'
+        ? getDefaultLogPath()
+        : process.env.GOOGLE_MCP_LOG_FILE;
+    if (!logPath) return;
+    try {
+        fs.mkdirSync(path.dirname(logPath), { recursive: true });
+        logStream = fs.createWriteStream(logPath, { flags: 'a' });
+    } catch {
+        // If we can't open the log file, continue without file logging
+    }
+}
+initLogFile();
+
+function timestamp() {
+    return new Date().toISOString();
+}
+
+function formatArgs(args) {
+    return args.map(a => {
+        if (a instanceof Error) return a.stack || a.message;
+        if (typeof a === 'object') {
+            try { return JSON.stringify(a); } catch { return String(a); }
         }
-    },
+        return String(a);
+    }).join(' ');
+}
+
+function log(level, args) {
+    if (!shouldLog(level)) return;
+    const tag = level.toUpperCase();
+    const ts = timestamp();
+    const msg = formatArgs(args);
+    console.error(`${ts} [${tag}] ${msg}`);
+    if (logStream) {
+        logStream.write(`${ts} [${tag}] ${msg}\n`);
+    }
+}
+
+export const logger = {
+    debug(...args) { log('debug', args); },
+    info(...args) { log('info', args); },
+    warn(...args) { log('warn', args); },
+    error(...args) { log('error', args); },
 };

package/dist/tools/calendar/manageEvent.js

@@ -6,9 +6,9 @@ export function register(server) {
     server.addTool({
         name: 'manage_event',
         description:
-            'Create, update, or delete a calendar event. Supports attendees, Google Meet, reminders, attachments, visibility, and transparency settings.',
+            'Create, update, or delete a calendar event. Supports attendees, Google Meet, reminders, attachments, visibility, and transparency settings. IMPORTANT: To modify an existing event, always use action "update" with the existing event_id. Never delete and recreate an event to make changes — this destroys the event ID, attendee RSVPs, and sent notifications.',
         parameters: z.object({
-            action: z.enum(['create', 'update', 'delete']).describe('The operation to perform.'),
+            action: z.enum(['create', 'update', 'delete']).describe('The operation to perform. Use "update" to modify existing events — do not delete and recreate. "delete" should only be used to permanently remove an event, not to redo one.'),
             calendar_id: z
                 .string()
                 .optional()

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/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.12",
+  "version": "1.0.14",
   "description": "Combined Google Workspace MCP server (Drive, Docs, Sheets, Gmail) with lazy-loaded tool categories",
   "type": "module",
   "bin": {