gogcli-mcp-sheets 2.0.12 → 2.3.0

package/dist/index.js

@@ -31074,7 +31074,7 @@ async function run(args, options = {}) {
 
 // ../gogcli-mcp/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);
   }
 }
 
@@ -31218,8 +31233,62 @@ function registerAuthTools(server2) {
   });
 }
 
+// ../gogcli-mcp/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;
+}
+
 // ../gogcli-mcp/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.',
@@ -31239,13 +31308,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.',
@@ -31254,13 +31341,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).",
@@ -31268,13 +31355,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"),
@@ -31309,7 +31399,7 @@ function registerSheetsTools(server2) {
 }
 
 // ../gogcli-mcp/src/server.ts
-var VERSION = true ? "2.0.12" : "0.0.0";
+var VERSION = true ? "2.3.0" : "0.0.0";
 function createServer(options) {
   return new McpServer({
     name: options?.name ?? "gogcli",
@@ -31329,6 +31419,33 @@ function hexToRgb(hex3) {
     blue: (n & 255) / 255
   };
 }
+async function checkDateFormatTarget(spreadsheetId, range, account) {
+  const peek = await runOrDiagnose(
+    ["sheets", "get", spreadsheetId, range, "--render=UNFORMATTED_VALUE"],
+    { account }
+  );
+  let parsed;
+  try {
+    parsed = JSON.parse(peek.content[0].text);
+  } catch {
+    return null;
+  }
+  const rows = parsed.values;
+  if (!Array.isArray(rows) || rows.length === 0) return null;
+  let sawSmallInt = false;
+  for (const row of rows) {
+    for (const cell of row) {
+      if (cell === null || cell === void 0 || cell === "") continue;
+      if (typeof cell !== "number") return null;
+      if (!Number.isInteger(cell)) return null;
+      if (cell < 0) return null;
+      if (cell >= 1e4) return null;
+      sawSmallInt = true;
+    }
+  }
+  if (!sawSmallInt) return null;
+  return "Warning: applying DATE/DATE_TIME format to cells holding small integers (< 10000) will render them as dates near 1899-12-30 because Sheets interprets numeric values as day-serials from that epoch. If those integers are ordinals (1, 2, 3, ...) and not day offsets, this is almost certainly not what you want. Pass force:true to suppress this warning, or convert the cells to real dates / strings first.";
+}
 function registerExtraSheetsTools(server2) {
   server2.registerTool("gog_sheets_list_tabs", {
     description: "List tabs (sheets) in a spreadsheet with their titles, sheetIds, and indices. A friendlier view than gog_sheets_metadata when you only need the tab list \u2014 useful for restructuring a workbook over a long agent session without losing track of names.",
@@ -31422,7 +31539,7 @@ function registerExtraSheetsTools(server2) {
     return runOrDiagnose(args, { account });
   });
   server2.registerTool("gog_sheets_insert", {
-    description: "Insert rows or columns into a sheet.",
+    description: "Insert rows or columns into a sheet. With after:false (default), the new dimension lands at start. With after:true, the new dimension lands at start+1 (the existing dimension at start is preserved).",
     annotations: { destructiveHint: true },
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
@@ -31430,11 +31547,12 @@ function registerExtraSheetsTools(server2) {
       dimension: external_exports.string().describe("Dimension to insert: ROWS or COLUMNS"),
       start: external_exports.number().describe("Start index (0-based)"),
       count: external_exports.number().optional().describe("Number of rows/columns to insert (default: 1)"),
-      after: external_exports.boolean().optional().describe("Insert after the start index instead of before"),
+      after: external_exports.boolean().optional().describe("Insert after the start index instead of before. With after:true the new dimension lands at start+1, leaving the existing dimension at start untouched."),
       account: accountParam
     }
   }, async ({ spreadsheetId, sheet, dimension, start, count, after, account }) => {
-    const args = ["sheets", "insert", spreadsheetId, sheet, dimension, String(start)];
+    const effectiveStart = after ? start + 1 : start;
+    const args = ["sheets", "insert", spreadsheetId, sheet, dimension, String(effectiveStart)];
     if (count !== void 0) args.push(`--count=${count}`);
     if (after) args.push("--after");
     return runOrDiagnose(args, { account });
@@ -31553,20 +31671,29 @@ function registerExtraSheetsTools(server2) {
     return runOrDiagnose(args, { account: a.account });
   });
   server2.registerTool("gog_sheets_number_format", {
-    description: "Set number format on a range (currency, percentage, date, etc.).",
+    description: "Set number format on a range (currency, percentage, date, etc.). When type is DATE or DATE_TIME, the target range is peeked first; if every numeric cell is a small integer (< 10000), a warning is prepended to the response because Sheets will render those as 1899/1900 day-serials. Pass force:true to skip the check.",
     annotations: { destructiveHint: true },
     inputSchema: {
       spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
       range: external_exports.string().describe("Range to format (e.g. Sheet1!A1:A10)"),
-      type: external_exports.string().optional().describe("Format type: NUMBER, CURRENCY, PERCENT, DATE, TIME, SCIENTIFIC, etc."),
+      type: external_exports.string().optional().describe("Format type: NUMBER, CURRENCY, PERCENT, DATE, DATE_TIME, TIME, SCIENTIFIC, etc."),
       pattern: external_exports.string().optional().describe('Custom format pattern (e.g. "#,##0.00", "yyyy-mm-dd")'),
+      force: external_exports.boolean().optional().describe("Skip the DATE/DATE_TIME small-integer warning check"),
       account: accountParam
     }
-  }, async ({ spreadsheetId, range, type, pattern, account }) => {
+  }, async ({ spreadsheetId, range, type, pattern, force, account }) => {
+    const isDateType = type === "DATE" || type === "DATE_TIME";
+    const warning = isDateType && !force ? await checkDateFormatTarget(spreadsheetId, range, account) : null;
     const args = ["sheets", "number-format", spreadsheetId, range];
     if (type) args.push(`--type=${type}`);
     if (pattern) args.push(`--pattern=${pattern}`);
-    return runOrDiagnose(args, { account });
+    const result = await runOrDiagnose(args, { account });
+    if (warning) {
+      return { content: [{ type: "text", text: `${warning}
+
+${result.content[0].text}` }] };
+    }
+    return result;
   });
   server2.registerTool("gog_sheets_read_format", {
     description: "Read cell formatting for a range.",
@@ -31742,6 +31869,248 @@ function registerExtraSheetsTools(server2) {
       { account }
     );
   });
+  server2.registerTool("gog_sheets_chart_list", {
+    description: "List embedded charts in a spreadsheet (chartId, type, position).",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, account }) => {
+    return runOrDiagnose(["sheets", "chart", "list", spreadsheetId], { account });
+  });
+  server2.registerTool("gog_sheets_chart_get", {
+    description: "Get the full definition (spec + position) of a single chart by its numeric chart ID.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      chartId: external_exports.string().describe("Numeric chart ID (from gog_sheets_chart_list)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, chartId, account }) => {
+    return runOrDiagnose(["sheets", "chart", "get", spreadsheetId, chartId], { account });
+  });
+  server2.registerTool("gog_sheets_chart_create", {
+    description: "Create an embedded chart from a JSON spec. specJson is a Sheets API ChartSpec (or full EmbeddedChart) \u2014 inline or @/path/to/file.json. Anchor the chart with sheet + anchor (A1 cell), and optionally size it with width/height pixels.",
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      specJson: external_exports.string().describe("ChartSpec or EmbeddedChart JSON (inline or @file)"),
+      sheet: external_exports.string().optional().describe("Sheet name for the anchor (resolved to sheetId)"),
+      anchor: external_exports.string().optional().describe("Anchor cell in A1 notation (e.g. A1, E10)"),
+      width: external_exports.number().optional().describe("Chart width in pixels (default: 600)"),
+      height: external_exports.number().optional().describe("Chart height in pixels (default: 371)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, specJson, sheet, anchor, width, height, account }) => {
+    const args = ["sheets", "chart", "create", spreadsheetId, `--spec-json=${specJson}`];
+    if (sheet) args.push(`--sheet=${sheet}`);
+    if (anchor) args.push(`--anchor=${anchor}`);
+    if (width !== void 0) args.push(`--width=${width}`);
+    if (height !== void 0) args.push(`--height=${height}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_chart_update", {
+    description: "Replace a chart spec by chart ID. specJson is a Sheets API ChartSpec (or full EmbeddedChart) \u2014 inline or @/path/to/file.json.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      chartId: external_exports.string().describe("Numeric chart ID to update"),
+      specJson: external_exports.string().describe("ChartSpec or EmbeddedChart JSON (inline or @file)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, chartId, specJson, account }) => {
+    return runOrDiagnose(
+      ["sheets", "chart", "update", spreadsheetId, chartId, `--spec-json=${specJson}`],
+      { account }
+    );
+  });
+  server2.registerTool("gog_sheets_chart_delete", {
+    description: "Delete a chart by its numeric chart ID.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      chartId: external_exports.string().describe("Numeric chart ID to delete"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, chartId, account }) => {
+    return runOrDiagnose(["sheets", "chart", "delete", spreadsheetId, chartId], { account });
+  });
+  server2.registerTool("gog_sheets_table_list", {
+    description: "List Google Sheets tables in a spreadsheet (tableId, name, range).",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, account }) => {
+    return runOrDiagnose(["sheets", "table", "list", spreadsheetId], { account });
+  });
+  server2.registerTool("gog_sheets_table_get", {
+    description: "Get a single Google Sheets table (definition + columns) by its table ID.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      tableId: external_exports.string().describe("Table ID (from gog_sheets_table_list)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, tableId, account }) => {
+    return runOrDiagnose(["sheets", "table", "get", spreadsheetId, tableId], { account });
+  });
+  server2.registerTool("gog_sheets_table_create", {
+    description: "Create a Google Sheets table over a range. columnsJson is a JSON array of column definitions (each {columnName, columnType?}); valid columnType values: TEXT, DOUBLE, BOOLEAN, DATE, DROPDOWN. Inline JSON or @/path/to/file.json.",
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range the table covers (e.g. Sheet1!A1:D20)"),
+      name: external_exports.string().describe("Table name"),
+      columnsJson: external_exports.string().describe("Column definitions as JSON array or @file (columnName + optional columnType)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, name, columnsJson, account }) => {
+    return runOrDiagnose(
+      ["sheets", "table", "create", spreadsheetId, range, `--name=${name}`, `--columns-json=${columnsJson}`],
+      { account }
+    );
+  });
+  server2.registerTool("gog_sheets_table_append", {
+    description: "Append data rows to a table. valuesJson is a JSON 2D array of row values.",
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      tableId: external_exports.string().describe("Table ID to append to"),
+      valuesJson: external_exports.string().describe('Values as JSON 2D array (e.g. [["a",1],["b",2]])'),
+      input: external_exports.enum(["RAW", "USER_ENTERED"]).optional().describe("Value input option (default: USER_ENTERED)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, tableId, valuesJson, input, account }) => {
+    const args = ["sheets", "table", "append", spreadsheetId, tableId, `--values-json=${valuesJson}`];
+    if (input) args.push(`--input=${input}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_table_clear", {
+    description: "Clear all data rows from a table (keeps the table and its columns).",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      tableId: external_exports.string().describe("Table ID to clear"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, tableId, account }) => {
+    return runOrDiagnose(["sheets", "table", "clear", spreadsheetId, tableId], { account });
+  });
+  server2.registerTool("gog_sheets_table_delete", {
+    description: "Delete a table by its table ID.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      tableId: external_exports.string().describe("Table ID to delete"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, tableId, account }) => {
+    return runOrDiagnose(["sheets", "table", "delete", spreadsheetId, tableId], { account });
+  });
+  server2.registerTool("gog_sheets_banding_list", {
+    description: "List alternating-color banded ranges. Optionally scope to a single sheet.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      sheet: external_exports.string().optional().describe("Only list banding from this sheet"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, sheet, account }) => {
+    const args = ["sheets", "banding", "list", spreadsheetId];
+    if (sheet) args.push(`--sheet=${sheet}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_banding_set", {
+    description: "Apply alternating colors to a range. Provide rowPropertiesJson and/or columnPropertiesJson \u2014 each a Sheets API BandingProperties JSON object ({headerColor, firstBandColor, secondBandColor, footerColor}). At least one is required.",
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range to band (e.g. Sheet1!A1:D20)"),
+      rowPropertiesJson: external_exports.string().optional().describe("BandingProperties JSON for row colors"),
+      columnPropertiesJson: external_exports.string().optional().describe("BandingProperties JSON for column colors"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, rowPropertiesJson, columnPropertiesJson, account }) => {
+    const args = ["sheets", "banding", "set", spreadsheetId, range];
+    if (rowPropertiesJson) args.push(`--row-properties-json=${rowPropertiesJson}`);
+    if (columnPropertiesJson) args.push(`--column-properties-json=${columnPropertiesJson}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_banding_clear", {
+    description: "Remove alternating-color banding. Pass id to remove a single banded range, or all:true with sheet to remove every banding on that sheet.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      id: external_exports.number().optional().describe("Banded range ID to remove"),
+      all: external_exports.boolean().optional().describe("Remove all banding from the sheet (requires sheet)"),
+      sheet: external_exports.string().optional().describe("Sheet name (used with all:true)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, id, all, sheet, account }) => {
+    const args = ["sheets", "banding", "clear", spreadsheetId];
+    if (id !== void 0) args.push(`--id=${id}`);
+    if (all) args.push("--all");
+    if (sheet) args.push(`--sheet=${sheet}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_conditional_format_list", {
+    description: "List conditional formatting rules. Optionally scope to a single sheet.",
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      sheet: external_exports.string().optional().describe("Only list rules from this sheet"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, sheet, account }) => {
+    const args = ["sheets", "conditional-format", "list", spreadsheetId];
+    if (sheet) args.push(`--sheet=${sheet}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_conditional_format_add", {
+    description: "Add a conditional formatting rule to a range. type picks the condition; expr is its value/formula (omit for blank/not-blank). formatJson is the CellFormat to apply when the condition matches (inline or @file). Use formatFields to force-send zero/false fields (e.g. backgroundColor,textFormat.bold).",
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      range: external_exports.string().describe("Range the rule applies to (e.g. Sheet1!A1:A100)"),
+      type: external_exports.enum([
+        "text-eq",
+        "text-contains",
+        "text-starts-with",
+        "text-ends-with",
+        "number-eq",
+        "number-gt",
+        "number-gte",
+        "number-lt",
+        "number-lte",
+        "blank",
+        "not-blank",
+        "custom-formula"
+      ]).describe("Rule type"),
+      formatJson: external_exports.string().describe("CellFormat JSON to apply when the condition matches (inline or @file)"),
+      expr: external_exports.string().optional().describe("Expression value or custom formula (omit for blank/not-blank)"),
+      formatFields: external_exports.string().optional().describe("Format field mask for force-sending zero/false fields (e.g. backgroundColor,textFormat.bold)"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, range, type, formatJson, expr, formatFields, account }) => {
+    const args = ["sheets", "conditional-format", "add", spreadsheetId, range, `--type=${type}`, `--format-json=${formatJson}`];
+    if (expr !== void 0) args.push(`--expr=${expr}`);
+    if (formatFields) args.push(`--format-fields=${formatFields}`);
+    return runOrDiagnose(args, { account });
+  });
+  server2.registerTool("gog_sheets_conditional_format_clear", {
+    description: "Remove conditional formatting rules from a sheet. Pass index to remove a single rule by its 0-based index, or all:true to remove every rule on the sheet.",
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      spreadsheetId: external_exports.string().describe("Spreadsheet ID"),
+      sheet: external_exports.string().describe("Sheet name to clear rules from"),
+      index: external_exports.number().optional().describe("0-based rule index to remove"),
+      all: external_exports.boolean().optional().describe("Remove all conditional formatting rules from the sheet"),
+      account: accountParam
+    }
+  }, async ({ spreadsheetId, sheet, index, all, account }) => {
+    const args = ["sheets", "conditional-format", "clear", spreadsheetId, `--sheet=${sheet}`];
+    if (index !== void 0) args.push(`--index=${index}`);
+    if (all) args.push("--all");
+    return runOrDiagnose(args, { account });
+  });
 }
 
 // src/index.ts

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp-sheets",
   "display_name": "gogcli (Sheets)",
-  "version": "2.0.12",
+  "version": "2.3.0",
   "description": "Extended Google Sheets for Claude via gogcli — auth + full Sheets support",
   "author": {
     "name": "Chris Hall",
@@ -150,7 +150,7 @@
     },
     {
       "name": "gog_sheets_number_format",
-      "description": "Set number format on a range (currency, percentage, date, etc.)."
+      "description": "Set number format on a range (currency, percentage, date, etc.). When type is DATE or DATE_TIME, peeks the target range first and warns if every numeric cell is a small integer (< 10000) — Sheets would render those as 1899/1900 day-serials. Pass force:true to skip the check."
     },
     {
       "name": "gog_sheets_read_format",
@@ -207,6 +207,74 @@
     {
       "name": "gog_sheets_reorder_tab",
       "description": "Move a tab to a specific 0-based position."
+    },
+    {
+      "name": "gog_sheets_chart_list",
+      "description": "List embedded charts in a spreadsheet."
+    },
+    {
+      "name": "gog_sheets_chart_get",
+      "description": "Get a chart's full definition (spec + position) by chart ID."
+    },
+    {
+      "name": "gog_sheets_chart_create",
+      "description": "Create an embedded chart from a JSON ChartSpec."
+    },
+    {
+      "name": "gog_sheets_chart_update",
+      "description": "Replace a chart's spec by chart ID."
+    },
+    {
+      "name": "gog_sheets_chart_delete",
+      "description": "Delete a chart by chart ID."
+    },
+    {
+      "name": "gog_sheets_table_list",
+      "description": "List Google Sheets tables in a spreadsheet."
+    },
+    {
+      "name": "gog_sheets_table_get",
+      "description": "Get a Google Sheets table by table ID."
+    },
+    {
+      "name": "gog_sheets_table_create",
+      "description": "Create a Google Sheets table over a range with typed columns."
+    },
+    {
+      "name": "gog_sheets_table_append",
+      "description": "Append data rows to a table."
+    },
+    {
+      "name": "gog_sheets_table_clear",
+      "description": "Clear all data rows from a table."
+    },
+    {
+      "name": "gog_sheets_table_delete",
+      "description": "Delete a table by table ID."
+    },
+    {
+      "name": "gog_sheets_banding_list",
+      "description": "List alternating-color banded ranges."
+    },
+    {
+      "name": "gog_sheets_banding_set",
+      "description": "Apply alternating colors to a range."
+    },
+    {
+      "name": "gog_sheets_banding_clear",
+      "description": "Remove alternating-color banding by ID or for a whole sheet."
+    },
+    {
+      "name": "gog_sheets_conditional_format_list",
+      "description": "List conditional formatting rules."
+    },
+    {
+      "name": "gog_sheets_conditional_format_add",
+      "description": "Add a conditional formatting rule to a range."
+    },
+    {
+      "name": "gog_sheets_conditional_format_clear",
+      "description": "Remove conditional formatting rules from a sheet."
     }
   ],
   "compatibility": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp-sheets",
-  "version": "2.0.12",
+  "version": "2.3.0",
   "mcpName": "io.github.chrischall/gogcli-mcp-sheets",
   "description": "Extended Google Sheets MCP server via gogcli — all base tools plus full Sheets support",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",