gogcli-mcp 2.28.0 → 2.29.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-    "version": "2.28.0"
+    "version": "2.29.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli",
       "source": "./",
       "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-      "version": "2.28.0",
+      "version": "2.29.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gogcli-mcp",
   "displayName": "gogcli",
-  "version": "2.28.0",
+  "version": "2.29.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/dist/index.js

@@ -31323,6 +31323,77 @@ function redactSecrets(text) {
   return text.replace(BEARER_RE, "$1[REDACTED]").replace(BASIC_AUTH_RE, "$1[REDACTED]").replace(SET_COOKIE_RE, "$1$2=[REDACTED]").replace(COOKIE_HEADER_RE, (_m, prefix, pairs) => `${prefix}${pairs.replace(/=[^;,\s]*/g, "=[REDACTED]")}`).replace(API_KEY_RE, "[REDACTED]").replace(QUERY_SECRET_RE, "$1[REDACTED]").replace(AWS_SIGV4_RE, "$1[REDACTED]").replace(JSON_SECRET_DQ_RE, "$1[REDACTED]$2").replace(JSON_SECRET_SQ_RE, "$1[REDACTED]$2").replace(JWT_RE, "[REDACTED]");
 }
 
+// ../../node_modules/@chrischall/mcp-utils/dist/response/view.js
+var VIEWS = ["compact", "full", "raw"];
+var DEFAULT_VIEW = "compact";
+var BLURB = {
+  compact: '"compact" (default) drops fields the response already carries elsewhere',
+  full: '"full" returns every field this server understands',
+  raw: '"raw" returns the upstream payload unprojected'
+};
+function viewParam(honoured, opts = {}) {
+  if (honoured.length < 2) {
+    throw new Error("viewParam needs at least two rungs: a parameter offering one value decides nothing");
+  }
+  if (!honoured.includes("compact")) {
+    throw new Error('viewParam must offer "compact": a tool with no cheap rung has nothing to default to');
+  }
+  const ordered = VIEWS.filter((v) => honoured.includes(v));
+  const sentence = `Response shape: ${ordered.map((v) => BLURB[v]).join("; ")}.`;
+  return external_exports.enum(Object.fromEntries(ordered.map((v) => [v, v]))).optional().describe(opts.note ? `${sentence} ${opts.note}` : sentence);
+}
+function resolveView(value, honoured) {
+  return value !== void 0 && honoured.includes(value) ? value : DEFAULT_VIEW;
+}
+function minifiedResult(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+
+// ../../node_modules/@chrischall/mcp-utils/dist/response/media.js
+var MEDIA_NOUN = "(?:avatar|tall_avatar|cover_photo|cover_image|picture|photo|thumbnail|thumb|image|icon|banner|profile_pic(?:ture)?|logo)";
+var MEDIA_KEY = new RegExp(`^${MEDIA_NOUN}s?(?:(?:link|uri|url)s?)?$`, "i");
+var MEDIA_URL = /^https?:\/\/[^\s]+?\.(png|jpe?g|gif|webp|svg|avif|bmp|ico)([?#]|$)/i;
+function stripMediaUrls(value, opts = {}) {
+  const keep = new Set((opts.keep ?? []).map((k) => k.toLowerCase()));
+  const drop = (opts.drop ?? []).map((rule) => typeof rule === "string" ? rule.toLowerCase() : new RegExp(rule.source, rule.flags));
+  return walk(value, keep, drop);
+}
+function alsoDrop(key, drop) {
+  const lower = key.toLowerCase();
+  for (const rule of drop) {
+    if (typeof rule === "string") {
+      if (rule === lower)
+        return true;
+      continue;
+    }
+    rule.lastIndex = 0;
+    if (rule.test(key))
+      return true;
+  }
+  return false;
+}
+function walk(value, keep, drop) {
+  if (Array.isArray(value))
+    return value.map((v) => walk(v, keep, drop));
+  if (value === null || typeof value !== "object")
+    return value;
+  if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+    return value;
+  const out = {};
+  for (const [key, v] of Object.entries(value)) {
+    if (keep.has(key.toLowerCase())) {
+      out[key] = v;
+      continue;
+    }
+    if (MEDIA_KEY.test(key) || alsoDrop(key, drop))
+      continue;
+    if (typeof v === "string" && MEDIA_URL.test(v))
+      continue;
+    out[key] = walk(v, keep, drop);
+  }
+  return out;
+}
+
 // ../../node_modules/@chrischall/mcp-utils/dist/response/index.js
 function rawTextResult(text) {
   return { content: [{ type: "text", text }] };
@@ -31852,11 +31923,11 @@ function parseTimestampValue(key, value, assumeNaiveIn) {
   }
   return null;
 }
-function walk(node, tz, naiveTz) {
+function walk2(node, tz, naiveTz) {
   let changed = false;
   if (Array.isArray(node)) {
     for (const item of node) {
-      if (walk(item, tz, naiveTz)) changed = true;
+      if (walk2(item, tz, naiveTz)) changed = true;
     }
     return changed;
   }
@@ -31865,7 +31936,7 @@ function walk(node, tz, naiveTz) {
   for (const key of Object.keys(obj)) {
     const value = obj[key];
     if (value !== null && typeof value === "object") {
-      if (walk(value, tz, naiveTz)) changed = true;
+      if (walk2(value, tz, naiveTz)) changed = true;
       continue;
     }
     if (ZONE_NAME_KEYS.has(key) || !TIMESTAMP_KEYS.has(key)) continue;
@@ -31891,7 +31962,7 @@ function normalizeTimestamps(text, tz = displayTimeZone(), naiveTz = naiveSource
   } catch {
     return text;
   }
-  if (!walk(parsed, tz, naiveTz)) return text;
+  if (!walk2(parsed, tz, naiveTz)) return text;
   return JSON.stringify(parsed, null, detectIndent(text));
 }
 
@@ -32069,10 +32140,38 @@ ${accounts || "(none)"}${hint}`);
     return errorResult(`${errText}${hint}`);
   }
 }
+function minifiedOrRawText(text, stripMedia = false) {
+  const trimmed = text.trim();
+  if (trimmed === "" || !/^[[{]/.test(trimmed)) return rawTextResult(text);
+  try {
+    const parsed = JSON.parse(trimmed);
+    return minifiedResult(stripMedia ? stripMediaUrls(parsed) : parsed);
+  } catch {
+    return rawTextResult(text);
+  }
+}
+function isRejectedFieldMask(err) {
+  return /invalidParameter|invalid field selection/i.test(String(err));
+}
+async function runProjected(args, options) {
+  const { fieldsMask } = options;
+  if (!fieldsMask) return run(args, options);
+  try {
+    return await run([...args, `--fields=${fieldsMask}`], options);
+  } catch (err) {
+    if (!isRejectedFieldMask(err)) throw err;
+    process.stderr.write(
+      `gogcli-mcp: Google rejected the compact field mask (${fieldsMask}); retrying unprojected
+`
+    );
+    return run(args, options);
+  }
+}
 async function runOrDiagnose(args, options) {
   try {
-    const raw = await run(args, options);
-    return rawTextResult(options.lossless ? raw : stripConsumedPageToken(normalizeTimestamps(raw)));
+    const raw = await runProjected(args, options);
+    if (options.lossless) return rawTextResult(raw);
+    return minifiedOrRawText(stripConsumedPageToken(normalizeTimestamps(raw)), options.stripMedia);
   } catch (err) {
     return diagnose(err);
   }
@@ -32446,6 +32545,7 @@ function pushReminderFlags(args, p) {
   }
   for (const reminder of p.reminders) args.push(`--reminder=${reminder}`);
 }
+var CALENDAR_EVENTS_COMPACT_FIELDS = "nextPageToken,items(id,summary,start,end,location,status,htmlLink)";
 function registerCalendarTools(server) {
   server.registerTool("gog_calendar_events", {
     description: 'List calendar events. Describe the window ONE way and one way only (gog >= 0.36.0 rejects the rest as ambiguous rather than silently discarding a flag): today on its own; or from + to; or from + days; or days on its own (a window of that many days starting today). today cannot be combined with from, to or days, and days cannot be combined with to. gog returns only 10 events by default, so a wide date range is USUALLY INCOMPLETE: raise max, or page with pageToken until the response carries no nextPageToken. A response carrying "truncated": true is an incomplete view \u2014 never conclude an event does not exist from one.',
@@ -32468,9 +32568,12 @@ function registerCalendarTools(server) {
       all: external_exports.boolean().optional().describe('Fetch events from ALL CALENDARS. NOTE: unlike the gmail search tools, this does NOT mean "all pages" \u2014 it widens the calendar set, not the page window. Use pageToken to reach later pages.'),
       eventTypes: external_exports.array(external_exports.enum(["default", "birthday", "focus-time", "from-gmail", "out-of-office", "working-location"])).optional().describe("Filter to specific event types (repeatable)"),
       timezone: external_exports.string().optional().describe(`Display timezone for event times (IANA name, e.g. America/New_York, or "local" for the system timezone). Default: each event's timezone, then its calendar's timezone.`),
+      view: viewParam(["compact", "full"], {
+        note: "compact (the default) drops description and attendees \u2014 together two thirds of a listing's bytes \u2014 plus etag/iCalUID/kind. Ask for full when you need a body or a guest list."
+      }),
       account: accountParam
     }
-  }, async ({ calendarId, from, to, days, today, query, max, pageToken, page, all, eventTypes, timezone, account }) => {
+  }, async ({ calendarId, from, to, days, today, query, max, pageToken, page, all, eventTypes, timezone, view, account }) => {
     const args = ["calendar", "events"];
     if (calendarId) args.push(calendarId);
     if (from) args.push(`--from=${from}`);
@@ -32484,7 +32587,11 @@ function registerCalendarTools(server) {
     if (all) args.push("--all");
     if (eventTypes) for (const t of eventTypes) args.push(`--event-types=${t}`);
     if (timezone) args.push(`--timezone=${timezone}`);
-    const result = await runOrDiagnose(args, { account });
+    const rung = resolveView(view, ["compact", "full"]);
+    const result = await runOrDiagnose(args, {
+      account,
+      fieldsMask: rung === "compact" ? CALENDAR_EVENTS_COMPACT_FIELDS : void 0
+    });
     return annotateTruncatedList(result, "events");
   });
   server.registerTool("gog_calendar_get", {
@@ -33417,6 +33524,7 @@ function fileMeta(raw) {
   const f = parsed.file ?? parsed;
   return { name: f.name, mimeType: f.mimeType };
 }
+var DRIVE_LS_COMPACT_FIELDS = "nextPageToken,files(id,name,mimeType,modifiedTime,size,webViewLink)";
 function registerDriveTools(server) {
   server.registerTool("gog_drive_ls", {
     description: "List files in a Google Drive folder (default: root).",
@@ -33428,9 +33536,12 @@ function registerDriveTools(server) {
       page: pageAliasParam,
       query: external_exports.string().optional().describe(`Drive query filter (e.g. "name contains 'budget'")`),
       allDrives: external_exports.boolean().optional().describe("Include shared drives (default: true). Set false for My Drive only."),
+      view: viewParam(["compact", "full"], {
+        note: "compact (the default) drops owners, parents, thumbnailLink and hasThumbnail \u2014 near-constant across a listing and 48% of its bytes. Ask for full to get them."
+      }),
       account: accountParam
     }
-  }, async ({ folderId, max, pageToken, page, query, allDrives, account }) => {
+  }, async ({ folderId, max, pageToken, page, query, allDrives, view, account }) => {
     const args = ["drive", "ls"];
     if (folderId) args.push(`--parent=${folderId}`);
     if (max !== void 0) args.push(`--max=${max}`);
@@ -33438,27 +33549,48 @@ function registerDriveTools(server) {
     if (token) args.push(`--page=${token}`);
     if (query) args.push(`--query=${query}`);
     if (allDrives === false) args.push("--no-all-drives");
-    return runOrDiagnose(args, { account });
+    const rung = resolveView(view, ["compact", "full"]);
+    return runOrDiagnose(args, {
+      account,
+      fieldsMask: rung === "compact" ? DRIVE_LS_COMPACT_FIELDS : void 0
+    });
   });
   server.registerTool("gog_drive_search", {
     description: "Search Google Drive files by full-text query.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       query: external_exports.string().describe("Search query"),
+      // gog's `drive search` accepts no --fields mask, so unlike gog_drive_ls
+      // this tool's compact rung is a LOCAL projection. Same vocabulary either
+      // way: a caller does not need to know which lever is being pulled.
+      view: viewParam(["compact", "full"], { note: "compact (the default) drops thumbnailLink \u2014 a URL a model cannot see, and 30%+ of a Drive file record. Ask for full to get it back." }),
       account: accountParam
     }
-  }, async ({ query, account }) => {
-    return runOrDiagnose(["drive", "search", query], { account });
+  }, async ({ query, view, account }) => {
+    return runOrDiagnose(["drive", "search", query], {
+      account,
+      stripMedia: resolveView(view, ["compact", "full"]) === "compact"
+    });
   });
   server.registerTool("gog_drive_get", {
     description: "Get metadata for a Google Drive file.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       fileId: external_exports.string().describe("File ID"),
+      // A --fields mask saves only 7% here: the default set is already narrow,
+      // which is why this tool takes no mask. The media strip saves 27.5% of
+      // the tool's actual output, measured end to end over stdio, which is why
+      // it takes a view after all. (An earlier note said 32.9%; that was a
+      // minified-vs-stripped comparison of the raw gog payload rather than of
+      // what the tool returns. The end-to-end figure is the one a caller sees.)
+      view: viewParam(["compact", "full"], { note: "compact (the default) drops thumbnailLink \u2014 a URL a model cannot see, and 30%+ of a Drive file record. Ask for full to get it back." }),
       account: accountParam
     }
-  }, async ({ fileId, account }) => {
-    return runOrDiagnose(["drive", "get", fileId], { account });
+  }, async ({ fileId, view, account }) => {
+    return runOrDiagnose(["drive", "get", fileId], {
+      account,
+      stripMedia: resolveView(view, ["compact", "full"]) === "compact"
+    });
   });
   server.registerTool("gog_drive_mkdir", {
     description: "Create a new folder in Google Drive.",
@@ -34191,7 +34323,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.28.0" : "0.0.0";
+var VERSION = true ? "2.29.0" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/dist/lib.js

@@ -23237,6 +23237,77 @@ function redactSecrets(text) {
   return text.replace(BEARER_RE, "$1[REDACTED]").replace(BASIC_AUTH_RE, "$1[REDACTED]").replace(SET_COOKIE_RE, "$1$2=[REDACTED]").replace(COOKIE_HEADER_RE, (_m, prefix, pairs) => `${prefix}${pairs.replace(/=[^;,\s]*/g, "=[REDACTED]")}`).replace(API_KEY_RE, "[REDACTED]").replace(QUERY_SECRET_RE, "$1[REDACTED]").replace(AWS_SIGV4_RE, "$1[REDACTED]").replace(JSON_SECRET_DQ_RE, "$1[REDACTED]$2").replace(JSON_SECRET_SQ_RE, "$1[REDACTED]$2").replace(JWT_RE, "[REDACTED]");
 }
 
+// ../../node_modules/@chrischall/mcp-utils/dist/response/view.js
+var VIEWS = ["compact", "full", "raw"];
+var DEFAULT_VIEW = "compact";
+var BLURB = {
+  compact: '"compact" (default) drops fields the response already carries elsewhere',
+  full: '"full" returns every field this server understands',
+  raw: '"raw" returns the upstream payload unprojected'
+};
+function viewParam(honoured, opts = {}) {
+  if (honoured.length < 2) {
+    throw new Error("viewParam needs at least two rungs: a parameter offering one value decides nothing");
+  }
+  if (!honoured.includes("compact")) {
+    throw new Error('viewParam must offer "compact": a tool with no cheap rung has nothing to default to');
+  }
+  const ordered = VIEWS.filter((v) => honoured.includes(v));
+  const sentence = `Response shape: ${ordered.map((v) => BLURB[v]).join("; ")}.`;
+  return external_exports.enum(Object.fromEntries(ordered.map((v) => [v, v]))).optional().describe(opts.note ? `${sentence} ${opts.note}` : sentence);
+}
+function resolveView(value, honoured) {
+  return value !== void 0 && honoured.includes(value) ? value : DEFAULT_VIEW;
+}
+function minifiedResult(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+
+// ../../node_modules/@chrischall/mcp-utils/dist/response/media.js
+var MEDIA_NOUN = "(?:avatar|tall_avatar|cover_photo|cover_image|picture|photo|thumbnail|thumb|image|icon|banner|profile_pic(?:ture)?|logo)";
+var MEDIA_KEY = new RegExp(`^${MEDIA_NOUN}s?(?:(?:link|uri|url)s?)?$`, "i");
+var MEDIA_URL = /^https?:\/\/[^\s]+?\.(png|jpe?g|gif|webp|svg|avif|bmp|ico)([?#]|$)/i;
+function stripMediaUrls(value, opts = {}) {
+  const keep = new Set((opts.keep ?? []).map((k) => k.toLowerCase()));
+  const drop = (opts.drop ?? []).map((rule) => typeof rule === "string" ? rule.toLowerCase() : new RegExp(rule.source, rule.flags));
+  return walk(value, keep, drop);
+}
+function alsoDrop(key, drop) {
+  const lower = key.toLowerCase();
+  for (const rule of drop) {
+    if (typeof rule === "string") {
+      if (rule === lower)
+        return true;
+      continue;
+    }
+    rule.lastIndex = 0;
+    if (rule.test(key))
+      return true;
+  }
+  return false;
+}
+function walk(value, keep, drop) {
+  if (Array.isArray(value))
+    return value.map((v) => walk(v, keep, drop));
+  if (value === null || typeof value !== "object")
+    return value;
+  if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+    return value;
+  const out = {};
+  for (const [key, v] of Object.entries(value)) {
+    if (keep.has(key.toLowerCase())) {
+      out[key] = v;
+      continue;
+    }
+    if (MEDIA_KEY.test(key) || alsoDrop(key, drop))
+      continue;
+    if (typeof v === "string" && MEDIA_URL.test(v))
+      continue;
+    out[key] = walk(v, keep, drop);
+  }
+  return out;
+}
+
 // ../../node_modules/@chrischall/mcp-utils/dist/response/index.js
 function rawTextResult(text) {
   return { content: [{ type: "text", text }] };
@@ -23698,11 +23769,11 @@ function parseTimestampValue(key, value, assumeNaiveIn) {
   }
   return null;
 }
-function walk(node, tz, naiveTz) {
+function walk2(node, tz, naiveTz) {
   let changed = false;
   if (Array.isArray(node)) {
     for (const item of node) {
-      if (walk(item, tz, naiveTz)) changed = true;
+      if (walk2(item, tz, naiveTz)) changed = true;
     }
     return changed;
   }
@@ -23711,7 +23782,7 @@ function walk(node, tz, naiveTz) {
   for (const key of Object.keys(obj)) {
     const value = obj[key];
     if (value !== null && typeof value === "object") {
-      if (walk(value, tz, naiveTz)) changed = true;
+      if (walk2(value, tz, naiveTz)) changed = true;
       continue;
     }
     if (ZONE_NAME_KEYS.has(key) || !TIMESTAMP_KEYS.has(key)) continue;
@@ -23737,7 +23808,7 @@ function normalizeTimestamps(text, tz = displayTimeZone(), naiveTz = naiveSource
   } catch {
     return text;
   }
-  if (!walk(parsed, tz, naiveTz)) return text;
+  if (!walk2(parsed, tz, naiveTz)) return text;
   return JSON.stringify(parsed, null, detectIndent(text));
 }
 
@@ -23915,10 +23986,38 @@ ${accounts || "(none)"}${hint}`);
     return errorResult(`${errText}${hint}`);
   }
 }
+function minifiedOrRawText(text, stripMedia = false) {
+  const trimmed = text.trim();
+  if (trimmed === "" || !/^[[{]/.test(trimmed)) return rawTextResult(text);
+  try {
+    const parsed = JSON.parse(trimmed);
+    return minifiedResult(stripMedia ? stripMediaUrls(parsed) : parsed);
+  } catch {
+    return rawTextResult(text);
+  }
+}
+function isRejectedFieldMask(err) {
+  return /invalidParameter|invalid field selection/i.test(String(err));
+}
+async function runProjected(args, options) {
+  const { fieldsMask } = options;
+  if (!fieldsMask) return run(args, options);
+  try {
+    return await run([...args, `--fields=${fieldsMask}`], options);
+  } catch (err) {
+    if (!isRejectedFieldMask(err)) throw err;
+    process.stderr.write(
+      `gogcli-mcp: Google rejected the compact field mask (${fieldsMask}); retrying unprojected
+`
+    );
+    return run(args, options);
+  }
+}
 async function runOrDiagnose(args, options) {
   try {
-    const raw = await run(args, options);
-    return rawTextResult(options.lossless ? raw : stripConsumedPageToken(normalizeTimestamps(raw)));
+    const raw = await runProjected(args, options);
+    if (options.lossless) return rawTextResult(raw);
+    return minifiedOrRawText(stripConsumedPageToken(normalizeTimestamps(raw)), options.stripMedia);
   } catch (err) {
     return diagnose(err);
   }
@@ -24295,6 +24394,7 @@ function pushReminderFlags(args, p) {
   }
   for (const reminder of p.reminders) args.push(`--reminder=${reminder}`);
 }
+var CALENDAR_EVENTS_COMPACT_FIELDS = "nextPageToken,items(id,summary,start,end,location,status,htmlLink)";
 function registerCalendarTools(server) {
   server.registerTool("gog_calendar_events", {
     description: 'List calendar events. Describe the window ONE way and one way only (gog >= 0.36.0 rejects the rest as ambiguous rather than silently discarding a flag): today on its own; or from + to; or from + days; or days on its own (a window of that many days starting today). today cannot be combined with from, to or days, and days cannot be combined with to. gog returns only 10 events by default, so a wide date range is USUALLY INCOMPLETE: raise max, or page with pageToken until the response carries no nextPageToken. A response carrying "truncated": true is an incomplete view \u2014 never conclude an event does not exist from one.',
@@ -24317,9 +24417,12 @@ function registerCalendarTools(server) {
       all: external_exports.boolean().optional().describe('Fetch events from ALL CALENDARS. NOTE: unlike the gmail search tools, this does NOT mean "all pages" \u2014 it widens the calendar set, not the page window. Use pageToken to reach later pages.'),
       eventTypes: external_exports.array(external_exports.enum(["default", "birthday", "focus-time", "from-gmail", "out-of-office", "working-location"])).optional().describe("Filter to specific event types (repeatable)"),
       timezone: external_exports.string().optional().describe(`Display timezone for event times (IANA name, e.g. America/New_York, or "local" for the system timezone). Default: each event's timezone, then its calendar's timezone.`),
+      view: viewParam(["compact", "full"], {
+        note: "compact (the default) drops description and attendees \u2014 together two thirds of a listing's bytes \u2014 plus etag/iCalUID/kind. Ask for full when you need a body or a guest list."
+      }),
       account: accountParam
     }
-  }, async ({ calendarId, from, to, days, today, query, max, pageToken, page, all, eventTypes, timezone, account }) => {
+  }, async ({ calendarId, from, to, days, today, query, max, pageToken, page, all, eventTypes, timezone, view, account }) => {
     const args = ["calendar", "events"];
     if (calendarId) args.push(calendarId);
     if (from) args.push(`--from=${from}`);
@@ -24333,7 +24436,11 @@ function registerCalendarTools(server) {
     if (all) args.push("--all");
     if (eventTypes) for (const t of eventTypes) args.push(`--event-types=${t}`);
     if (timezone) args.push(`--timezone=${timezone}`);
-    const result = await runOrDiagnose(args, { account });
+    const rung = resolveView(view, ["compact", "full"]);
+    const result = await runOrDiagnose(args, {
+      account,
+      fieldsMask: rung === "compact" ? CALENDAR_EVENTS_COMPACT_FIELDS : void 0
+    });
     return annotateTruncatedList(result, "events");
   });
   server.registerTool("gog_calendar_get", {
@@ -25266,6 +25373,7 @@ function fileMeta(raw) {
   const f = parsed.file ?? parsed;
   return { name: f.name, mimeType: f.mimeType };
 }
+var DRIVE_LS_COMPACT_FIELDS = "nextPageToken,files(id,name,mimeType,modifiedTime,size,webViewLink)";
 function registerDriveTools(server) {
   server.registerTool("gog_drive_ls", {
     description: "List files in a Google Drive folder (default: root).",
@@ -25277,9 +25385,12 @@ function registerDriveTools(server) {
       page: pageAliasParam,
       query: external_exports.string().optional().describe(`Drive query filter (e.g. "name contains 'budget'")`),
       allDrives: external_exports.boolean().optional().describe("Include shared drives (default: true). Set false for My Drive only."),
+      view: viewParam(["compact", "full"], {
+        note: "compact (the default) drops owners, parents, thumbnailLink and hasThumbnail \u2014 near-constant across a listing and 48% of its bytes. Ask for full to get them."
+      }),
       account: accountParam
     }
-  }, async ({ folderId, max, pageToken, page, query, allDrives, account }) => {
+  }, async ({ folderId, max, pageToken, page, query, allDrives, view, account }) => {
     const args = ["drive", "ls"];
     if (folderId) args.push(`--parent=${folderId}`);
     if (max !== void 0) args.push(`--max=${max}`);
@@ -25287,27 +25398,48 @@ function registerDriveTools(server) {
     if (token) args.push(`--page=${token}`);
     if (query) args.push(`--query=${query}`);
     if (allDrives === false) args.push("--no-all-drives");
-    return runOrDiagnose(args, { account });
+    const rung = resolveView(view, ["compact", "full"]);
+    return runOrDiagnose(args, {
+      account,
+      fieldsMask: rung === "compact" ? DRIVE_LS_COMPACT_FIELDS : void 0
+    });
   });
   server.registerTool("gog_drive_search", {
     description: "Search Google Drive files by full-text query.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       query: external_exports.string().describe("Search query"),
+      // gog's `drive search` accepts no --fields mask, so unlike gog_drive_ls
+      // this tool's compact rung is a LOCAL projection. Same vocabulary either
+      // way: a caller does not need to know which lever is being pulled.
+      view: viewParam(["compact", "full"], { note: "compact (the default) drops thumbnailLink \u2014 a URL a model cannot see, and 30%+ of a Drive file record. Ask for full to get it back." }),
       account: accountParam
     }
-  }, async ({ query, account }) => {
-    return runOrDiagnose(["drive", "search", query], { account });
+  }, async ({ query, view, account }) => {
+    return runOrDiagnose(["drive", "search", query], {
+      account,
+      stripMedia: resolveView(view, ["compact", "full"]) === "compact"
+    });
   });
   server.registerTool("gog_drive_get", {
     description: "Get metadata for a Google Drive file.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       fileId: external_exports.string().describe("File ID"),
+      // A --fields mask saves only 7% here: the default set is already narrow,
+      // which is why this tool takes no mask. The media strip saves 27.5% of
+      // the tool's actual output, measured end to end over stdio, which is why
+      // it takes a view after all. (An earlier note said 32.9%; that was a
+      // minified-vs-stripped comparison of the raw gog payload rather than of
+      // what the tool returns. The end-to-end figure is the one a caller sees.)
+      view: viewParam(["compact", "full"], { note: "compact (the default) drops thumbnailLink \u2014 a URL a model cannot see, and 30%+ of a Drive file record. Ask for full to get it back." }),
       account: accountParam
     }
-  }, async ({ fileId, account }) => {
-    return runOrDiagnose(["drive", "get", fileId], { account });
+  }, async ({ fileId, view, account }) => {
+    return runOrDiagnose(["drive", "get", fileId], {
+      account,
+      stripMedia: resolveView(view, ["compact", "full"]) === "compact"
+    });
   });
   server.registerTool("gog_drive_mkdir", {
     description: "Create a new folder in Google Drive.",
@@ -26040,7 +26172,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.28.0" : "0.0.0";
+var VERSION = true ? "2.29.0" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "2.28.0",
+  "version": "2.29.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",
@@ -126,7 +126,7 @@
     },
     {
       "name": "gog_calendar_events",
-      "description": "List calendar events; paginated (gog returns only 10 by default) and flags a truncated range"
+      "description": "List calendar events; compact by default (view=full for descriptions and attendees), paginated and flags a truncated range"
     },
     {
       "name": "gog_calendar_get",
@@ -254,11 +254,11 @@
     },
     {
       "name": "gog_drive_ls",
-      "description": "List files in a Google Drive folder"
+      "description": "List files in a Google Drive folder; compact by default (view=full for owners, parents and thumbnails)"
     },
     {
       "name": "gog_drive_search",
-      "description": "Search Google Drive files"
+      "description": "Search Google Drive files; compact by default (view=full for thumbnails)"
     },
     {
       "name": "gog_drive_extract_text",
@@ -270,7 +270,7 @@
     },
     {
       "name": "gog_drive_get",
-      "description": "Get Google Drive file metadata"
+      "description": "Get Google Drive file metadata; compact by default (view=full for thumbnails)"
     },
     {
       "name": "gog_drive_mkdir",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "2.28.0",
+  "version": "2.29.0",
   "mcpName": "io.github.chrischall/gogcli-mcp",
   "description": "MCP server wrapping gogcli for Google service access",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
@@ -41,7 +41,7 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@chrischall/mcp-utils": "^0.17.1",
+    "@chrischall/mcp-utils": "^0.23.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.4.3"
   },

package/server.json

@@ -7,12 +7,12 @@
     "source": "github",
     "subfolder": "packages/gogcli-mcp"
   },
-  "version": "2.28.0",
+  "version": "2.29.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "gogcli-mcp",
-      "version": "2.28.0",
+      "version": "2.29.0",
       "transport": {
         "type": "stdio"
       },