gogcli-mcp 2.0.11 → 2.2.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.0.11"
+    "version": "2.2.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.0.11",
+      "version": "2.2.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+## [2.1.0](https://github.com/chrischall/gogcli-mcp/compare/v2.0.13...v2.1.0) (2026-05-25)
+
+
+### Features
+
+* add gogcli-mcp-slides and gogcli-mcp-classroom sub-packages ([cee8724](https://github.com/chrischall/gogcli-mcp/commit/cee872442240e52ae1cac9b9085eabce0c5ff9c3))
+* add manifest.json and SKILL.md to sub-packages for .mcpb and .skill builds ([d1339c6](https://github.com/chrischall/gogcli-mcp/commit/d1339c690b1eeee8221b7cc15fd9e4fa48c1e20a))
+* address open issues for docs + sheets ([7109253](https://github.com/chrischall/gogcli-mcp/commit/7109253b3eb4b3dcc17cda7a8dfb1b6969023bcf))
+* **deploy:** per-sub-package registry listings (MCP Registry, ClawHub, Claude plugins) ([6cc1798](https://github.com/chrischall/gogcli-mcp/commit/6cc1798320af6dd3af709790e6bec30f46c5f3d2))
+* **drive:** add gogcli-mcp-drive sub-package ([d8eef61](https://github.com/chrischall/gogcli-mcp/commit/d8eef61f16266209da70cd05ca0d2378bf3c4613))
+* fold People into contacts and Meet into calendar; add TODO.md ([f649119](https://github.com/chrischall/gogcli-mcp/commit/f64911902094f87ae31420913e9d1a5ba608441f))
+* wrap new gog cli v0.18.0 tools ([173242a](https://github.com/chrischall/gogcli-mcp/commit/173242aafaa8c2f2d7282a2fbd8faedfc65a63bd))
+
+
+### Bug Fixes
+
+* emit type declarations from base so sub-packages can resolve gogcli-mcp/lib ([9cee5ed](https://github.com/chrischall/gogcli-mcp/commit/9cee5ed97b0cc72dde81c7f8a01d71c95a0291b7))
+* **mcpb:** add per-sub-package .mcpbignore to trim bundles ([e739d9e](https://github.com/chrischall/gogcli-mcp/commit/e739d9ec9ae8e4cc19b1189bb5bf7ac90481c943))
+* **runner:** augment PATH + helpful ENOENT message for missing gog ([34e696f](https://github.com/chrischall/gogcli-mcp/commit/34e696f8c74c7003e6b1bb31991a05184a3b6094))
+* **runner:** fall back to PATH lookup when GOG_PATH is empty string ([a726592](https://github.com/chrischall/gogcli-mcp/commit/a726592c86e869fe27b176798a9b8909e7821f4c))
+* **runner:** treat unresolved .mcpb placeholders as unset env vars ([17a0363](https://github.com/chrischall/gogcli-mcp/commit/17a0363f7dffd2757667e0d1d9377e2e2cb6fbc7))
+* treat empty GOG_PATH as unset, fall back to 'gog' on PATH ([0204638](https://github.com/chrischall/gogcli-mcp/commit/020463813f941b1fa8ec2360346c55abc244675f))
+
+
+### Refactor
+
+* aggressive cleanup pass (audit findings) ([e635b39](https://github.com/chrischall/gogcli-mcp/commit/e635b391cf611e9c102a422ffbce5ebe28687b80))
+* make sub-packages focused (auth + service only) ([4301306](https://github.com/chrischall/gogcli-mcp/commit/4301306cecf12e66d67dbc4ce9debae8f3dcfabc))
+* rebalance base vs sub-package tool split (120 -> 84 base) ([1074953](https://github.com/chrischall/gogcli-mcp/commit/1074953833fc4766e85cc0b28cbcc08834f8dc47))
+* remove comments escape hatch from base docs tool ([a5364c6](https://github.com/chrischall/gogcli-mcp/commit/a5364c6df1948e57b185b9d753aa11b033edd0d0))
+* restructure into npm workspaces monorepo ([9645100](https://github.com/chrischall/gogcli-mcp/commit/9645100e8120c03956ee972023b12d2e99876cc5))
+* review-pass cleanup (enums, shared schemas, test harness) ([ea851de](https://github.com/chrischall/gogcli-mcp/commit/ea851deb30b9cfef3f07ed506a011fc363b34018))
+* use relative imports instead of workspace symlinks ([a278d6f](https://github.com/chrischall/gogcli-mcp/commit/a278d6fb31be480571481e9d87e199d261a3f031))
+
+
+### Documentation
+
+* add per-package READMEs, update root README and CLAUDE.md for monorepo ([19d547e](https://github.com/chrischall/gogcli-mcp/commit/19d547e5ceb14298a75ab297d0a9a11c6ea59e24))
+* fix tool counts and stale descriptions across all docs ([3558c72](https://github.com/chrischall/gogcli-mcp/commit/3558c72fa5c3ee3dbc8a06e9d7fb51bf73ef77c7))
+* update gogcli repo URLs to openclaw/gogcli (was steipete/gogcli) ([951a181](https://github.com/chrischall/gogcli-mcp/commit/951a1818ebc269f203aee723ccbea32c13817d8b))

package/dist/index.js

@@ -31074,7 +31074,7 @@ async function run(args, options = {}) {
 
 // src/tools/utils.ts
 var accountParam = external_exports.string().optional().describe(
-  "Google account email to use (overrides GOG_ACCOUNT env var)"
+  "Google account email to use, e.g. you@gmail.com \u2014 must be the full address, not a bare username. Overrides the GOG_ACCOUNT env var. Omit to use the single configured account."
 );
 var ids = {
   course: external_exports.string().describe("Course ID"),
@@ -31133,26 +31133,41 @@ function toError(err) {
 }
 var AUTH_ERROR_PATTERN = /\b(401|unauthorized|token.*(expired|revoked)|invalid_grant)\b/i;
 var TRANSIENT_ERROR_PATTERN = /\b429\b|\b5\d\d\b|\bquota\b|rateLimit|\bDEADLINE_EXCEEDED\b/i;
+var GRID_LIMIT_ERROR_PATTERN = /exceeds grid limits/i;
 var AUTH_HINT = "\n\nAuthentication may have expired. Use gog_auth_add to re-authorize the account. Ask the user if they would like to re-authenticate.";
 var TRANSIENT_HINT = "\n\nThis error is often transient. Retry the same call before trying a different approach (do not fall back to smaller writes or row-by-row operations).";
+var GRID_LIMIT_HINT = "\n\nThe target range is outside the sheet's current grid. Add the missing rows or columns first with gog_sheets_insert (dimension: rows or cols), then retry the write.";
+function formatAccountList(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed?.accounts)) {
+      return parsed.accounts.map((a) => a?.email).filter(Boolean).join("\n");
+    }
+  } catch {
+  }
+  return raw.trim();
+}
+async function diagnose(err) {
+  const errText = toError(err).content[0].text;
+  const isAuthError = AUTH_ERROR_PATTERN.test(errText);
+  const isTransientError = !isAuthError && TRANSIENT_ERROR_PATTERN.test(errText);
+  const isGridLimitError = GRID_LIMIT_ERROR_PATTERN.test(errText);
+  const hint = isAuthError ? AUTH_HINT : isTransientError ? TRANSIENT_HINT : isGridLimitError ? GRID_LIMIT_HINT : "";
+  try {
+    const accounts = formatAccountList(await run(["auth", "list"]));
+    return toText(`${errText}
+
+Configured accounts:
+${accounts || "(none)"}${hint}`);
+  } catch {
+    return toText(`${errText}${hint}`);
+  }
+}
 async function runOrDiagnose(args, options) {
   try {
     return toText(await run(args, options));
   } catch (err) {
-    const base = toError(err);
-    const errText = base.content[0].text;
-    const isAuthError = AUTH_ERROR_PATTERN.test(errText);
-    const isTransientError = !isAuthError && TRANSIENT_ERROR_PATTERN.test(errText);
-    const hint = isAuthError ? AUTH_HINT : isTransientError ? TRANSIENT_HINT : "";
-    try {
-      const accounts = await run(["auth", "list"]);
-      return toText(`${errText}
-
-Configured accounts:
-${accounts}${hint}`);
-    } catch {
-      return toText(`${errText}${hint}`);
-    }
+    return diagnose(err);
   }
 }
 
@@ -31254,7 +31269,7 @@ function registerCalendarTools(server2) {
     return runOrDiagnose(["calendar", "event", calendarId, eventId], { account });
   });
   server2.registerTool("gog_calendar_create", {
-    description: "Create a calendar event.",
+    description: "Create a calendar event. Set withZoom=true to attach a Zoom meeting (requires Zoom S2S OAuth setup via gog_zoom_auth_setup; the join URL + meeting ID + passcode are appended to the event description \u2014 Google rejects native conference card writes from non-Workspace-Marketplace OAuth clients).",
     annotations: { destructiveHint: false },
     inputSchema: {
       calendarId: external_exports.string().describe('Calendar ID (use "primary" for the default calendar)'),
@@ -31265,18 +31280,20 @@ function registerCalendarTools(server2) {
       location: external_exports.string().optional().describe("Event location"),
       attendees: external_exports.string().optional().describe("Attendee emails, comma-separated"),
       allDay: external_exports.boolean().optional().describe("All-day event (use date-only in from/to)"),
+      withZoom: external_exports.boolean().optional().describe("Create a Zoom video conference for this event (requires Zoom S2S OAuth setup)"),
       account: accountParam
     }
-  }, async ({ calendarId, summary, from, to, description, location, attendees, allDay, account }) => {
+  }, async ({ calendarId, summary, from, to, description, location, attendees, allDay, withZoom, account }) => {
     const args = ["calendar", "create", calendarId, `--summary=${summary}`, `--from=${from}`, `--to=${to}`];
     if (description) args.push(`--description=${description}`);
     if (location) args.push(`--location=${location}`);
     if (attendees) args.push(`--attendees=${attendees}`);
     if (allDay) args.push("--all-day");
+    if (withZoom) args.push("--with-zoom");
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_calendar_update", {
-    description: "Update an existing calendar event.",
+    description: "Update an existing calendar event. Zoom: withZoom adds a Zoom meeting, regenerateZoom replaces the existing one, removeZoom strips it (each are independent \u2014 use one per call).",
     annotations: { destructiveHint: false },
     inputSchema: {
       calendarId: external_exports.string().describe("Calendar ID"),
@@ -31287,9 +31304,12 @@ function registerCalendarTools(server2) {
       description: external_exports.string().optional().describe("New description"),
       location: external_exports.string().optional().describe("New location"),
       attendees: external_exports.string().optional().describe("New attendee emails, comma-separated (replaces existing)"),
+      withZoom: external_exports.boolean().optional().describe("Create a Zoom video conference for this event"),
+      regenerateZoom: external_exports.boolean().optional().describe("Replace the event's existing Zoom video conference"),
+      removeZoom: external_exports.boolean().optional().describe("Remove the event's Zoom video conference"),
       account: accountParam
     }
-  }, async ({ calendarId, eventId, summary, from, to, description, location, attendees, account }) => {
+  }, async ({ calendarId, eventId, summary, from, to, description, location, attendees, withZoom, regenerateZoom, removeZoom, account }) => {
     const args = ["calendar", "update", calendarId, eventId];
     if (summary !== void 0) args.push(`--summary=${summary}`);
     if (from !== void 0) args.push(`--from=${from}`);
@@ -31297,6 +31317,9 @@ function registerCalendarTools(server2) {
     if (description !== void 0) args.push(`--description=${description}`);
     if (location !== void 0) args.push(`--location=${location}`);
     if (attendees !== void 0) args.push(`--attendees=${attendees}`);
+    if (withZoom) args.push("--with-zoom");
+    if (regenerateZoom) args.push("--regenerate-zoom");
+    if (removeZoom) args.push("--remove-zoom");
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_calendar_delete", {
@@ -31933,7 +31956,7 @@ function registerDriveTools(server2) {
 // src/tools/gmail.ts
 function registerGmailTools(server2) {
   server2.registerTool("gog_gmail_search", {
-    description: 'Search Gmail threads using Gmail query syntax (e.g. "from:alice subject:invoice is:unread").',
+    description: `Search Gmail threads using Gmail query syntax (e.g. "from:alice subject:invoice is:unread"). The query is passed verbatim to Gmail; a bare name token (from:alison) matches per Gmail's own heuristics, a full address (from:alison@example.com) is exact. To match a contact across several addresses, OR them: from:(a@x.com OR b@y.com).`,
     annotations: { readOnlyHint: true },
     inputSchema: {
       query: external_exports.string().describe("Gmail search query"),
@@ -31982,8 +32005,62 @@ function registerGmailTools(server2) {
   registerRunTool(server2, { service: "gmail", examples: '"archive", "mark-read", "labels"' });
 }
 
+// src/tools/sheets-a1.ts
+function colToLetter(n) {
+  let s = "";
+  while (n > 0) {
+    const rem = (n - 1) % 26;
+    s = String.fromCharCode(65 + rem) + s;
+    n = Math.floor((n - 1) / 26);
+  }
+  return s;
+}
+function letterToCol(s) {
+  let n = 0;
+  for (const ch of s.toUpperCase()) {
+    n = n * 26 + (ch.charCodeAt(0) - 64);
+  }
+  return n;
+}
+function expandAnchorRange(range, rows, cols) {
+  const bang = range.lastIndexOf("!");
+  const sheet = bang >= 0 ? range.slice(0, bang + 1) : "";
+  const cell = bang >= 0 ? range.slice(bang + 1) : range;
+  const m = /^([A-Za-z]+)([0-9]+)$/.exec(cell);
+  if (!m) return range;
+  const startCol = letterToCol(m[1]);
+  const startRow = parseInt(m[2], 10);
+  const endCol = colToLetter(startCol + cols - 1);
+  const endRow = startRow + rows - 1;
+  return `${sheet}${m[1].toUpperCase()}${startRow}:${endCol}${endRow}`;
+}
+function countNonEmptyCells(getOutput) {
+  let parsed;
+  try {
+    parsed = JSON.parse(getOutput);
+  } catch {
+    return -1;
+  }
+  const values = parsed?.values;
+  if (!Array.isArray(values)) return 0;
+  let count = 0;
+  for (const row of values) {
+    if (!Array.isArray(row)) continue;
+    for (const cell of row) {
+      if (cell !== null && String(cell).trim() !== "") count++;
+    }
+  }
+  return count;
+}
+
 // src/tools/sheets.ts
 var cellValueParam = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean(), external_exports.null()]);
+var dryRunParam = external_exports.boolean().optional().describe(
+  "Preview the operation without modifying the sheet (gog --dry-run): reports the intended actions and exits without writing."
+);
+var failIfNotEmptyParam = external_exports.boolean().optional().describe(
+  'Safety guard against silent overwrites: before writing, read the target range and refuse the write if any target cell already holds data. Costs one extra read. Anchor ranges (e.g. "Sheet1!A1") are expanded to the full area your values will cover; explicit and named ranges are checked as-is.'
+);
 function registerSheetsTools(server2) {
   server2.registerTool("gog_sheets_get", {
     description: 'Read values from a Google Sheets range. Returns a JSON object with a "values" array of rows.',
@@ -32003,13 +32080,31 @@ function registerSheetsTools(server2) {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID (from the URL)"),
       range: external_exports.string().describe("Top-left cell or range in A1 notation, e.g. Sheet1!A1"),
       values: external_exports.array(external_exports.array(cellValueParam)).describe('2D array of values (rows of columns). Cells may be string/number/boolean/null; strings starting with "=" are formulas.'),
+      dry_run: dryRunParam,
+      fail_if_not_empty: failIfNotEmptyParam,
       account: accountParam
     }
-  }, async ({ spreadsheetId, range, values, account }) => {
-    return runOrDiagnose(
-      ["sheets", "update", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`],
-      { account }
-    );
+  }, async ({ spreadsheetId, range, values, account, dry_run, fail_if_not_empty }) => {
+    const cols = values.reduce((max, row) => Math.max(max, row.length), 0);
+    if (fail_if_not_empty && values.length > 0 && cols > 0) {
+      const readRange = expandAnchorRange(range, values.length, cols);
+      let existing;
+      try {
+        existing = await run(["sheets", "get", spreadsheetId, readRange], { account });
+      } catch (err) {
+        return diagnose(err);
+      }
+      const occupied = countNonEmptyCells(existing);
+      if (occupied !== 0) {
+        const detail = occupied < 0 ? "could not be verified as empty" : `already contains data in ${occupied} cell(s)`;
+        return toText(
+          `Write aborted (fail_if_not_empty): target range ${readRange} ${detail}. Re-run without fail_if_not_empty to overwrite, or clear it first with gog_sheets_clear.`
+        );
+      }
+    }
+    const args = ["sheets", "update", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`];
+    if (dry_run) args.push("--dry-run");
+    return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_sheets_append", {
     description: 'Append rows to a Google Sheet after the last row with data in the given range. Values may be strings, numbers, booleans, or null. Strings starting with "=" are interpreted as formulas.',
@@ -32018,13 +32113,13 @@ function registerSheetsTools(server2) {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID (from the URL)"),
       range: external_exports.string().describe("Range indicating which sheet/columns to append to, e.g. Sheet1!A:C"),
       values: external_exports.array(external_exports.array(cellValueParam)).describe('2D array of rows to append. Cells may be string/number/boolean/null; strings starting with "=" are formulas.'),
+      dry_run: dryRunParam,
       account: accountParam
     }
-  }, async ({ spreadsheetId, range, values, account }) => {
-    return runOrDiagnose(
-      ["sheets", "append", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`],
-      { account }
-    );
+  }, async ({ spreadsheetId, range, values, account, dry_run }) => {
+    const args = ["sheets", "append", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`];
+    if (dry_run) args.push("--dry-run");
+    return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_sheets_clear", {
     description: "Clear all values in a Google Sheets range (formatting is preserved).",
@@ -32032,13 +32127,16 @@ function registerSheetsTools(server2) {
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       range: external_exports.string().describe("Range in A1 notation to clear"),
+      dry_run: dryRunParam,
       account: accountParam
     }
-  }, async ({ spreadsheetId, range, account }) => {
-    return runOrDiagnose(["sheets", "clear", spreadsheetId, range], { account });
+  }, async ({ spreadsheetId, range, account, dry_run }) => {
+    const args = ["sheets", "clear", spreadsheetId, range];
+    if (dry_run) args.push("--dry-run");
+    return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_sheets_metadata", {
-    description: "Get spreadsheet metadata: title, sheet tabs, named ranges, and other properties.",
+    description: "Get spreadsheet metadata: title, named ranges, and per-tab properties including grid dimensions (gridProperties.rowCount / columnCount). Use this to learn a sheet's current size before writing \u2014 a write outside the grid fails.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
@@ -32224,7 +32322,7 @@ function registerTasksTools(server2) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.0.11" : "0.0.0";
+var VERSION = true ? "2.2.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",

package/dist/lib.js

@@ -30981,7 +30981,7 @@ async function run(args, options = {}) {
 
 // src/tools/utils.ts
 var accountParam = external_exports.string().optional().describe(
-  "Google account email to use (overrides GOG_ACCOUNT env var)"
+  "Google account email to use, e.g. you@gmail.com \u2014 must be the full address, not a bare username. Overrides the GOG_ACCOUNT env var. Omit to use the single configured account."
 );
 var ids = {
   course: external_exports.string().describe("Course ID"),
@@ -31045,26 +31045,41 @@ function toError(err) {
 }
 var AUTH_ERROR_PATTERN = /\b(401|unauthorized|token.*(expired|revoked)|invalid_grant)\b/i;
 var TRANSIENT_ERROR_PATTERN = /\b429\b|\b5\d\d\b|\bquota\b|rateLimit|\bDEADLINE_EXCEEDED\b/i;
+var GRID_LIMIT_ERROR_PATTERN = /exceeds grid limits/i;
 var AUTH_HINT = "\n\nAuthentication may have expired. Use gog_auth_add to re-authorize the account. Ask the user if they would like to re-authenticate.";
 var TRANSIENT_HINT = "\n\nThis error is often transient. Retry the same call before trying a different approach (do not fall back to smaller writes or row-by-row operations).";
+var GRID_LIMIT_HINT = "\n\nThe target range is outside the sheet's current grid. Add the missing rows or columns first with gog_sheets_insert (dimension: rows or cols), then retry the write.";
+function formatAccountList(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed?.accounts)) {
+      return parsed.accounts.map((a) => a?.email).filter(Boolean).join("\n");
+    }
+  } catch {
+  }
+  return raw.trim();
+}
+async function diagnose(err) {
+  const errText = toError(err).content[0].text;
+  const isAuthError = AUTH_ERROR_PATTERN.test(errText);
+  const isTransientError = !isAuthError && TRANSIENT_ERROR_PATTERN.test(errText);
+  const isGridLimitError = GRID_LIMIT_ERROR_PATTERN.test(errText);
+  const hint = isAuthError ? AUTH_HINT : isTransientError ? TRANSIENT_HINT : isGridLimitError ? GRID_LIMIT_HINT : "";
+  try {
+    const accounts = formatAccountList(await run(["auth", "list"]));
+    return toText(`${errText}
+
+Configured accounts:
+${accounts || "(none)"}${hint}`);
+  } catch {
+    return toText(`${errText}${hint}`);
+  }
+}
 async function runOrDiagnose(args, options) {
   try {
     return toText(await run(args, options));
   } catch (err) {
-    const base = toError(err);
-    const errText = base.content[0].text;
-    const isAuthError = AUTH_ERROR_PATTERN.test(errText);
-    const isTransientError = !isAuthError && TRANSIENT_ERROR_PATTERN.test(errText);
-    const hint = isAuthError ? AUTH_HINT : isTransientError ? TRANSIENT_HINT : "";
-    try {
-      const accounts = await run(["auth", "list"]);
-      return toText(`${errText}
-
-Configured accounts:
-${accounts}${hint}`);
-    } catch {
-      return toText(`${errText}${hint}`);
-    }
+    return diagnose(err);
   }
 }
 
@@ -31166,7 +31181,7 @@ function registerCalendarTools(server) {
     return runOrDiagnose(["calendar", "event", calendarId, eventId], { account });
   });
   server.registerTool("gog_calendar_create", {
-    description: "Create a calendar event.",
+    description: "Create a calendar event. Set withZoom=true to attach a Zoom meeting (requires Zoom S2S OAuth setup via gog_zoom_auth_setup; the join URL + meeting ID + passcode are appended to the event description \u2014 Google rejects native conference card writes from non-Workspace-Marketplace OAuth clients).",
     annotations: { destructiveHint: false },
     inputSchema: {
       calendarId: external_exports.string().describe('Calendar ID (use "primary" for the default calendar)'),
@@ -31177,18 +31192,20 @@ function registerCalendarTools(server) {
       location: external_exports.string().optional().describe("Event location"),
       attendees: external_exports.string().optional().describe("Attendee emails, comma-separated"),
       allDay: external_exports.boolean().optional().describe("All-day event (use date-only in from/to)"),
+      withZoom: external_exports.boolean().optional().describe("Create a Zoom video conference for this event (requires Zoom S2S OAuth setup)"),
       account: accountParam
     }
-  }, async ({ calendarId, summary, from, to, description, location, attendees, allDay, account }) => {
+  }, async ({ calendarId, summary, from, to, description, location, attendees, allDay, withZoom, account }) => {
     const args = ["calendar", "create", calendarId, `--summary=${summary}`, `--from=${from}`, `--to=${to}`];
     if (description) args.push(`--description=${description}`);
     if (location) args.push(`--location=${location}`);
     if (attendees) args.push(`--attendees=${attendees}`);
     if (allDay) args.push("--all-day");
+    if (withZoom) args.push("--with-zoom");
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_calendar_update", {
-    description: "Update an existing calendar event.",
+    description: "Update an existing calendar event. Zoom: withZoom adds a Zoom meeting, regenerateZoom replaces the existing one, removeZoom strips it (each are independent \u2014 use one per call).",
     annotations: { destructiveHint: false },
     inputSchema: {
       calendarId: external_exports.string().describe("Calendar ID"),
@@ -31199,9 +31216,12 @@ function registerCalendarTools(server) {
       description: external_exports.string().optional().describe("New description"),
       location: external_exports.string().optional().describe("New location"),
       attendees: external_exports.string().optional().describe("New attendee emails, comma-separated (replaces existing)"),
+      withZoom: external_exports.boolean().optional().describe("Create a Zoom video conference for this event"),
+      regenerateZoom: external_exports.boolean().optional().describe("Replace the event's existing Zoom video conference"),
+      removeZoom: external_exports.boolean().optional().describe("Remove the event's Zoom video conference"),
       account: accountParam
     }
-  }, async ({ calendarId, eventId, summary, from, to, description, location, attendees, account }) => {
+  }, async ({ calendarId, eventId, summary, from, to, description, location, attendees, withZoom, regenerateZoom, removeZoom, account }) => {
     const args = ["calendar", "update", calendarId, eventId];
     if (summary !== void 0) args.push(`--summary=${summary}`);
     if (from !== void 0) args.push(`--from=${from}`);
@@ -31209,6 +31229,9 @@ function registerCalendarTools(server) {
     if (description !== void 0) args.push(`--description=${description}`);
     if (location !== void 0) args.push(`--location=${location}`);
     if (attendees !== void 0) args.push(`--attendees=${attendees}`);
+    if (withZoom) args.push("--with-zoom");
+    if (regenerateZoom) args.push("--regenerate-zoom");
+    if (removeZoom) args.push("--remove-zoom");
     return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_calendar_delete", {
@@ -31845,7 +31868,7 @@ function registerDriveTools(server) {
 // src/tools/gmail.ts
 function registerGmailTools(server) {
   server.registerTool("gog_gmail_search", {
-    description: 'Search Gmail threads using Gmail query syntax (e.g. "from:alice subject:invoice is:unread").',
+    description: `Search Gmail threads using Gmail query syntax (e.g. "from:alice subject:invoice is:unread"). The query is passed verbatim to Gmail; a bare name token (from:alison) matches per Gmail's own heuristics, a full address (from:alison@example.com) is exact. To match a contact across several addresses, OR them: from:(a@x.com OR b@y.com).`,
     annotations: { readOnlyHint: true },
     inputSchema: {
       query: external_exports.string().describe("Gmail search query"),
@@ -31894,8 +31917,62 @@ function registerGmailTools(server) {
   registerRunTool(server, { service: "gmail", examples: '"archive", "mark-read", "labels"' });
 }
 
+// src/tools/sheets-a1.ts
+function colToLetter(n) {
+  let s = "";
+  while (n > 0) {
+    const rem = (n - 1) % 26;
+    s = String.fromCharCode(65 + rem) + s;
+    n = Math.floor((n - 1) / 26);
+  }
+  return s;
+}
+function letterToCol(s) {
+  let n = 0;
+  for (const ch of s.toUpperCase()) {
+    n = n * 26 + (ch.charCodeAt(0) - 64);
+  }
+  return n;
+}
+function expandAnchorRange(range, rows, cols) {
+  const bang = range.lastIndexOf("!");
+  const sheet = bang >= 0 ? range.slice(0, bang + 1) : "";
+  const cell = bang >= 0 ? range.slice(bang + 1) : range;
+  const m = /^([A-Za-z]+)([0-9]+)$/.exec(cell);
+  if (!m) return range;
+  const startCol = letterToCol(m[1]);
+  const startRow = parseInt(m[2], 10);
+  const endCol = colToLetter(startCol + cols - 1);
+  const endRow = startRow + rows - 1;
+  return `${sheet}${m[1].toUpperCase()}${startRow}:${endCol}${endRow}`;
+}
+function countNonEmptyCells(getOutput) {
+  let parsed;
+  try {
+    parsed = JSON.parse(getOutput);
+  } catch {
+    return -1;
+  }
+  const values = parsed?.values;
+  if (!Array.isArray(values)) return 0;
+  let count = 0;
+  for (const row of values) {
+    if (!Array.isArray(row)) continue;
+    for (const cell of row) {
+      if (cell !== null && String(cell).trim() !== "") count++;
+    }
+  }
+  return count;
+}
+
 // src/tools/sheets.ts
 var cellValueParam = external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean(), external_exports.null()]);
+var dryRunParam = external_exports.boolean().optional().describe(
+  "Preview the operation without modifying the sheet (gog --dry-run): reports the intended actions and exits without writing."
+);
+var failIfNotEmptyParam = external_exports.boolean().optional().describe(
+  'Safety guard against silent overwrites: before writing, read the target range and refuse the write if any target cell already holds data. Costs one extra read. Anchor ranges (e.g. "Sheet1!A1") are expanded to the full area your values will cover; explicit and named ranges are checked as-is.'
+);
 function registerSheetsTools(server) {
   server.registerTool("gog_sheets_get", {
     description: 'Read values from a Google Sheets range. Returns a JSON object with a "values" array of rows.',
@@ -31915,13 +31992,31 @@ function registerSheetsTools(server) {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID (from the URL)"),
       range: external_exports.string().describe("Top-left cell or range in A1 notation, e.g. Sheet1!A1"),
       values: external_exports.array(external_exports.array(cellValueParam)).describe('2D array of values (rows of columns). Cells may be string/number/boolean/null; strings starting with "=" are formulas.'),
+      dry_run: dryRunParam,
+      fail_if_not_empty: failIfNotEmptyParam,
       account: accountParam
     }
-  }, async ({ spreadsheetId, range, values, account }) => {
-    return runOrDiagnose(
-      ["sheets", "update", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`],
-      { account }
-    );
+  }, async ({ spreadsheetId, range, values, account, dry_run, fail_if_not_empty }) => {
+    const cols = values.reduce((max, row) => Math.max(max, row.length), 0);
+    if (fail_if_not_empty && values.length > 0 && cols > 0) {
+      const readRange = expandAnchorRange(range, values.length, cols);
+      let existing;
+      try {
+        existing = await run(["sheets", "get", spreadsheetId, readRange], { account });
+      } catch (err) {
+        return diagnose(err);
+      }
+      const occupied = countNonEmptyCells(existing);
+      if (occupied !== 0) {
+        const detail = occupied < 0 ? "could not be verified as empty" : `already contains data in ${occupied} cell(s)`;
+        return toText(
+          `Write aborted (fail_if_not_empty): target range ${readRange} ${detail}. Re-run without fail_if_not_empty to overwrite, or clear it first with gog_sheets_clear.`
+        );
+      }
+    }
+    const args = ["sheets", "update", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`];
+    if (dry_run) args.push("--dry-run");
+    return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_sheets_append", {
     description: 'Append rows to a Google Sheet after the last row with data in the given range. Values may be strings, numbers, booleans, or null. Strings starting with "=" are interpreted as formulas.',
@@ -31930,13 +32025,13 @@ function registerSheetsTools(server) {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID (from the URL)"),
       range: external_exports.string().describe("Range indicating which sheet/columns to append to, e.g. Sheet1!A:C"),
       values: external_exports.array(external_exports.array(cellValueParam)).describe('2D array of rows to append. Cells may be string/number/boolean/null; strings starting with "=" are formulas.'),
+      dry_run: dryRunParam,
       account: accountParam
     }
-  }, async ({ spreadsheetId, range, values, account }) => {
-    return runOrDiagnose(
-      ["sheets", "append", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`],
-      { account }
-    );
+  }, async ({ spreadsheetId, range, values, account, dry_run }) => {
+    const args = ["sheets", "append", spreadsheetId, range, `--values-json=${JSON.stringify(values)}`];
+    if (dry_run) args.push("--dry-run");
+    return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_sheets_clear", {
     description: "Clear all values in a Google Sheets range (formatting is preserved).",
@@ -31944,13 +32039,16 @@ function registerSheetsTools(server) {
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       range: external_exports.string().describe("Range in A1 notation to clear"),
+      dry_run: dryRunParam,
       account: accountParam
     }
-  }, async ({ spreadsheetId, range, account }) => {
-    return runOrDiagnose(["sheets", "clear", spreadsheetId, range], { account });
+  }, async ({ spreadsheetId, range, account, dry_run }) => {
+    const args = ["sheets", "clear", spreadsheetId, range];
+    if (dry_run) args.push("--dry-run");
+    return runOrDiagnose(args, { account });
   });
   server.registerTool("gog_sheets_metadata", {
-    description: "Get spreadsheet metadata: title, sheet tabs, named ranges, and other properties.",
+    description: "Get spreadsheet metadata: title, named ranges, and per-tab properties including grid dimensions (gridProperties.rowCount / columnCount). Use this to learn a sheet's current size before writing \u2014 a write outside the grid fails.",
     annotations: { readOnlyHint: true },
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
@@ -32136,7 +32234,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "2.0.11" : "0.0.0";
+var VERSION = true ? "2.2.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "2.0.11",
+  "version": "2.2.0",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "2.0.11",
+  "version": "2.2.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>",
@@ -45,8 +45,8 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.6.2",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
     "esbuild": "^0.28.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.6"