google-tools-mcp 1.0.13 → 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/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/package.json

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