gogcli-mcp 4.0.0 → 4.0.1

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": "4.0.0"
+    "version": "4.0.1"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "gogcli",
       "source": "./",
       "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
-      "version": "4.0.0",
+      "version": "4.0.1",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

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

package/dist/index.js

@@ -33989,6 +33989,207 @@ var pageSchema = {
 
 // src/runner.ts
 import { delimiter, join } from "node:path";
+
+// src/timestamps.ts
+var DEFAULT_DISPLAY_TZ = "America/New_York";
+function isValidTimeZone(tz) {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: tz });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function displayTimeZone() {
+  const configured = readEnvVar("DISPLAY_TZ");
+  if (configured && isValidTimeZone(configured)) return configured;
+  return DEFAULT_DISPLAY_TZ;
+}
+function naiveSourceTimeZone() {
+  const configured = readEnvVar("GOG_TIMEZONE");
+  if (configured && isValidTimeZone(configured)) return configured;
+  return displayTimeZone();
+}
+function offsetAt(instant, tz) {
+  const w = wallPartsIn(instant, tz);
+  const asUTC = Date.UTC(w.year, w.month - 1, w.day, w.hour, w.minute, w.second, instant.getUTCMilliseconds());
+  const minutes = Math.round((asUTC - instant.getTime()) / 6e4);
+  const sign = minutes < 0 ? "-" : "+";
+  const abs = Math.abs(minutes);
+  return `${sign}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
+}
+function wallPartsIn(instant, tz) {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    // h23 pins midnight to hour 00; without it some ICU builds render hour 24.
+    hourCycle: "h23"
+  }).formatToParts(instant);
+  const out = {};
+  for (const p of parts) {
+    if (p.type !== "literal") out[p.type] = Number(p.value);
+  }
+  return out;
+}
+function wallTimeToInstant(y, mo, d, h, mi, s, ms, tz) {
+  let guess = Date.UTC(y, mo - 1, d, h, mi, s, ms);
+  for (let i = 0; i < 2; i += 1) {
+    const seen = wallPartsIn(new Date(guess), tz);
+    const seenUTC = Date.UTC(seen.year, seen.month - 1, seen.day, seen.hour, seen.minute, seen.second, ms);
+    const drift = Date.UTC(y, mo - 1, d, h, mi, s, ms) - seenUTC;
+    if (drift === 0) break;
+    guess += drift;
+  }
+  return new Date(guess);
+}
+function pad(n, width = 2) {
+  return String(n).padStart(width, "0");
+}
+function isoWithOffset(instant, tz, offset) {
+  const w = wallPartsIn(instant, tz);
+  const msPart = instant.getUTCMilliseconds();
+  const frac = msPart ? `.${pad(msPart, 3)}` : "";
+  return `${pad(w.year, 4)}-${pad(w.month)}-${pad(w.day)}T${pad(w.hour)}:${pad(w.minute)}:${pad(w.second)}${frac}${offset}`;
+}
+function formatInstant(instant, tz = displayTimeZone()) {
+  const offset = offsetAt(instant, tz);
+  const display = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    weekday: "short",
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "2-digit",
+    timeZoneName: "short"
+  }).format(instant);
+  return { iso: isoWithOffset(instant, tz, offset), display };
+}
+var TIMESTAMP_KEYS = /* @__PURE__ */ new Set([
+  "date",
+  // gog gmail message/thread listings ("2026-07-28 03:36")
+  "dateTime",
+  // Calendar event start/end
+  "internalDate",
+  // Gmail, epoch milliseconds (authoritative)
+  // gog >= 0.35.0 Gmail message AND thread listings. Already offset-bearing
+  // (RFC3339 from internalDate), so it needs no offset repair — it is
+  // allowlisted purely to gain a Display sibling, and to be re-rendered in
+  // DISPLAY_TZ like every other instant. Separately sourced from the sibling
+  // `date`, which is a naive re-format of the sender's Date header; the two may
+  // legitimately disagree. See docs/timestamps.md.
+  "internalDateIso",
+  "modifiedTime",
+  // Drive
+  "createdTime",
+  // Drive
+  "createTime",
+  "updateTime",
+  "updated",
+  "originalStartTime",
+  "expirationTime",
+  "lastModified",
+  "sentAt",
+  "viewedAt",
+  "modifiedAt",
+  "fetchedBodyAt",
+  "asOf"
+]);
+var ZONE_NAME_KEYS = /* @__PURE__ */ new Set(["timeZone", "timezone"]);
+var RFC3339_WITH_OFFSET = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?(?:\.(\d{1,9}))?(Z|[+-]\d{2}:?\d{2})$/;
+var NAIVE_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?(?:\.(\d{1,9}))?$/;
+var EPOCH_MILLIS = /^\d{13}$/;
+var DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+function isRealCalendarDate(p) {
+  const utc = new Date(Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second));
+  return utc.getUTCFullYear() === p.year && utc.getUTCMonth() === p.month - 1 && utc.getUTCDate() === p.day && utc.getUTCHours() === p.hour && utc.getUTCMinutes() === p.minute && utc.getUTCSeconds() === p.second;
+}
+function parseTimestampValue(key, value, assumeNaiveIn) {
+  if (typeof value !== "string") return null;
+  const raw = value.trim();
+  if (raw === "" || DATE_ONLY.test(raw)) return null;
+  if (key === "internalDate" && EPOCH_MILLIS.test(raw)) {
+    return new Date(Number(raw));
+  }
+  if (RFC3339_WITH_OFFSET.test(raw)) {
+    const parsed = new Date(raw.replace(" ", "T"));
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+  const naive = NAIVE_DATE_TIME.exec(raw);
+  if (naive) {
+    const [, y, mo, d, h, mi, s, frac] = naive;
+    const ms = frac ? Number(frac.padEnd(3, "0").slice(0, 3)) : 0;
+    const parts = {
+      year: Number(y),
+      month: Number(mo),
+      day: Number(d),
+      hour: Number(h),
+      minute: Number(mi),
+      second: Number(s ?? "0")
+    };
+    if (!isRealCalendarDate(parts)) return null;
+    return wallTimeToInstant(
+      parts.year,
+      parts.month,
+      parts.day,
+      parts.hour,
+      parts.minute,
+      parts.second,
+      ms,
+      assumeNaiveIn
+    );
+  }
+  return null;
+}
+function walk2(node2, tz, naiveTz) {
+  let changed = false;
+  if (Array.isArray(node2)) {
+    for (const item of node2) {
+      if (walk2(item, tz, naiveTz)) changed = true;
+    }
+    return changed;
+  }
+  if (node2 === null || typeof node2 !== "object") return false;
+  const obj = node2;
+  for (const key of Object.keys(obj)) {
+    const value = obj[key];
+    if (value !== null && typeof value === "object") {
+      if (walk2(value, tz, naiveTz)) changed = true;
+      continue;
+    }
+    if (ZONE_NAME_KEYS.has(key) || !TIMESTAMP_KEYS.has(key)) continue;
+    const instant = parseTimestampValue(key, value, naiveTz);
+    if (!instant) continue;
+    const { iso, display } = formatInstant(instant, tz);
+    obj[key] = iso;
+    obj[`${key}Display`] = display;
+    changed = true;
+  }
+  return changed;
+}
+function detectIndent(text) {
+  const match = /\n(\s+)\S/.exec(text);
+  return match ? match[1].replace(/\t/g, "  ").length : 0;
+}
+function normalizeTimestamps(text, tz = displayTimeZone(), naiveTz = naiveSourceTimeZone()) {
+  const trimmed = text.trim();
+  if (trimmed === "" || !/^[[{]/.test(trimmed)) return text;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    return text;
+  }
+  if (!walk2(parsed, tz, naiveTz)) return text;
+  return JSON.stringify(parsed, null, detectIndent(text));
+}
+
+// src/runner.ts
 function isGogFileArg(arg) {
   return typeof arg !== "string";
 }
@@ -34109,7 +34310,7 @@ async function spawnGog(fullArgs, opts) {
   const spawn = spawner ?? (await import("node:child_process")).spawn;
   const effectiveTimeout = timeout ?? TIMEOUT_MS;
   return new Promise((resolve, reject) => {
-    const childEnv = { ...sanitizedEnv(), PATH: augmentedPath() };
+    const childEnv = { ...sanitizedEnv(), GOG_TIMEZONE: naiveSourceTimeZone(), PATH: augmentedPath() };
     const child = spawn(readEnvVar("GOG_PATH") ?? "gog", fullArgs, { env: childEnv });
     const stdoutChunks = [];
     const stderrChunks = [];
@@ -34191,205 +34392,6 @@ async function runBinary(args, options = {}) {
   return spawnExecutor(fullArgs, { timeout, interactive: false, spawner, binary: true });
 }
 
-// src/timestamps.ts
-var DEFAULT_DISPLAY_TZ = "America/New_York";
-function isValidTimeZone(tz) {
-  try {
-    new Intl.DateTimeFormat("en-US", { timeZone: tz });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function displayTimeZone() {
-  const configured = readEnvVar("DISPLAY_TZ");
-  if (configured && isValidTimeZone(configured)) return configured;
-  return DEFAULT_DISPLAY_TZ;
-}
-function naiveSourceTimeZone() {
-  const configured = readEnvVar("GOG_TIMEZONE");
-  if (configured && isValidTimeZone(configured)) return configured;
-  return displayTimeZone();
-}
-function offsetAt(instant, tz) {
-  const w = wallPartsIn(instant, tz);
-  const asUTC = Date.UTC(w.year, w.month - 1, w.day, w.hour, w.minute, w.second, instant.getUTCMilliseconds());
-  const minutes = Math.round((asUTC - instant.getTime()) / 6e4);
-  const sign = minutes < 0 ? "-" : "+";
-  const abs = Math.abs(minutes);
-  return `${sign}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
-}
-function wallPartsIn(instant, tz) {
-  const parts = new Intl.DateTimeFormat("en-US", {
-    timeZone: tz,
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-    // h23 pins midnight to hour 00; without it some ICU builds render hour 24.
-    hourCycle: "h23"
-  }).formatToParts(instant);
-  const out = {};
-  for (const p of parts) {
-    if (p.type !== "literal") out[p.type] = Number(p.value);
-  }
-  return out;
-}
-function wallTimeToInstant(y, mo, d, h, mi, s, ms, tz) {
-  let guess = Date.UTC(y, mo - 1, d, h, mi, s, ms);
-  for (let i = 0; i < 2; i += 1) {
-    const seen = wallPartsIn(new Date(guess), tz);
-    const seenUTC = Date.UTC(seen.year, seen.month - 1, seen.day, seen.hour, seen.minute, seen.second, ms);
-    const drift = Date.UTC(y, mo - 1, d, h, mi, s, ms) - seenUTC;
-    if (drift === 0) break;
-    guess += drift;
-  }
-  return new Date(guess);
-}
-function pad(n, width = 2) {
-  return String(n).padStart(width, "0");
-}
-function isoWithOffset(instant, tz, offset) {
-  const w = wallPartsIn(instant, tz);
-  const msPart = instant.getUTCMilliseconds();
-  const frac = msPart ? `.${pad(msPart, 3)}` : "";
-  return `${pad(w.year, 4)}-${pad(w.month)}-${pad(w.day)}T${pad(w.hour)}:${pad(w.minute)}:${pad(w.second)}${frac}${offset}`;
-}
-function formatInstant(instant, tz = displayTimeZone()) {
-  const offset = offsetAt(instant, tz);
-  const display = new Intl.DateTimeFormat("en-US", {
-    timeZone: tz,
-    weekday: "short",
-    month: "short",
-    day: "numeric",
-    year: "numeric",
-    hour: "numeric",
-    minute: "2-digit",
-    timeZoneName: "short"
-  }).format(instant);
-  return { iso: isoWithOffset(instant, tz, offset), display };
-}
-var TIMESTAMP_KEYS = /* @__PURE__ */ new Set([
-  "date",
-  // gog gmail message/thread listings ("2026-07-28 03:36")
-  "dateTime",
-  // Calendar event start/end
-  "internalDate",
-  // Gmail, epoch milliseconds (authoritative)
-  // gog >= 0.35.0 Gmail message AND thread listings. Already offset-bearing
-  // (RFC3339 from internalDate), so it needs no offset repair — it is
-  // allowlisted purely to gain a Display sibling, and to be re-rendered in
-  // DISPLAY_TZ like every other instant. Separately sourced from the sibling
-  // `date`, which is a naive re-format of the sender's Date header; the two may
-  // legitimately disagree. See docs/timestamps.md.
-  "internalDateIso",
-  "modifiedTime",
-  // Drive
-  "createdTime",
-  // Drive
-  "createTime",
-  "updateTime",
-  "updated",
-  "originalStartTime",
-  "expirationTime",
-  "lastModified",
-  "sentAt",
-  "viewedAt",
-  "modifiedAt",
-  "fetchedBodyAt",
-  "asOf"
-]);
-var ZONE_NAME_KEYS = /* @__PURE__ */ new Set(["timeZone", "timezone"]);
-var RFC3339_WITH_OFFSET = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?(?:\.(\d{1,9}))?(Z|[+-]\d{2}:?\d{2})$/;
-var NAIVE_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?(?:\.(\d{1,9}))?$/;
-var EPOCH_MILLIS = /^\d{13}$/;
-var DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
-function isRealCalendarDate(p) {
-  const utc = new Date(Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second));
-  return utc.getUTCFullYear() === p.year && utc.getUTCMonth() === p.month - 1 && utc.getUTCDate() === p.day && utc.getUTCHours() === p.hour && utc.getUTCMinutes() === p.minute && utc.getUTCSeconds() === p.second;
-}
-function parseTimestampValue(key, value, assumeNaiveIn) {
-  if (typeof value !== "string") return null;
-  const raw = value.trim();
-  if (raw === "" || DATE_ONLY.test(raw)) return null;
-  if (key === "internalDate" && EPOCH_MILLIS.test(raw)) {
-    return new Date(Number(raw));
-  }
-  if (RFC3339_WITH_OFFSET.test(raw)) {
-    const parsed = new Date(raw.replace(" ", "T"));
-    return Number.isNaN(parsed.getTime()) ? null : parsed;
-  }
-  const naive = NAIVE_DATE_TIME.exec(raw);
-  if (naive) {
-    const [, y, mo, d, h, mi, s, frac] = naive;
-    const ms = frac ? Number(frac.padEnd(3, "0").slice(0, 3)) : 0;
-    const parts = {
-      year: Number(y),
-      month: Number(mo),
-      day: Number(d),
-      hour: Number(h),
-      minute: Number(mi),
-      second: Number(s ?? "0")
-    };
-    if (!isRealCalendarDate(parts)) return null;
-    return wallTimeToInstant(
-      parts.year,
-      parts.month,
-      parts.day,
-      parts.hour,
-      parts.minute,
-      parts.second,
-      ms,
-      assumeNaiveIn
-    );
-  }
-  return null;
-}
-function walk2(node2, tz, naiveTz) {
-  let changed = false;
-  if (Array.isArray(node2)) {
-    for (const item of node2) {
-      if (walk2(item, tz, naiveTz)) changed = true;
-    }
-    return changed;
-  }
-  if (node2 === null || typeof node2 !== "object") return false;
-  const obj = node2;
-  for (const key of Object.keys(obj)) {
-    const value = obj[key];
-    if (value !== null && typeof value === "object") {
-      if (walk2(value, tz, naiveTz)) changed = true;
-      continue;
-    }
-    if (ZONE_NAME_KEYS.has(key) || !TIMESTAMP_KEYS.has(key)) continue;
-    const instant = parseTimestampValue(key, value, naiveTz);
-    if (!instant) continue;
-    const { iso, display } = formatInstant(instant, tz);
-    obj[key] = iso;
-    obj[`${key}Display`] = display;
-    changed = true;
-  }
-  return changed;
-}
-function detectIndent(text) {
-  const match = /\n(\s+)\S/.exec(text);
-  return match ? match[1].replace(/\t/g, "  ").length : 0;
-}
-function normalizeTimestamps(text, tz = displayTimeZone(), naiveTz = naiveSourceTimeZone()) {
-  const trimmed = text.trim();
-  if (trimmed === "" || !/^[[{]/.test(trimmed)) return text;
-  let parsed;
-  try {
-    parsed = JSON.parse(trimmed);
-  } catch {
-    return text;
-  }
-  if (!walk2(parsed, tz, naiveTz)) return text;
-  return JSON.stringify(parsed, null, detectIndent(text));
-}
-
 // src/pagination.ts
 function detectIndent2(text) {
   const match = /\n(\s+)\S/.exec(text);
@@ -36863,7 +36865,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "4.0.0" : "0.0.0";
+var VERSION = true ? "4.0.1" : "0.0.0";
 var BASE_TOOL_REGISTRARS = [
   registerApiTools,
   registerAppScriptTools,

package/dist/lib.js

@@ -33037,6 +33037,207 @@ var pageSchema = {
 
 // src/runner.ts
 import { delimiter, join } from "node:path";
+
+// src/timestamps.ts
+var DEFAULT_DISPLAY_TZ = "America/New_York";
+function isValidTimeZone(tz) {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: tz });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function displayTimeZone() {
+  const configured = readEnvVar("DISPLAY_TZ");
+  if (configured && isValidTimeZone(configured)) return configured;
+  return DEFAULT_DISPLAY_TZ;
+}
+function naiveSourceTimeZone() {
+  const configured = readEnvVar("GOG_TIMEZONE");
+  if (configured && isValidTimeZone(configured)) return configured;
+  return displayTimeZone();
+}
+function offsetAt(instant, tz) {
+  const w = wallPartsIn(instant, tz);
+  const asUTC = Date.UTC(w.year, w.month - 1, w.day, w.hour, w.minute, w.second, instant.getUTCMilliseconds());
+  const minutes = Math.round((asUTC - instant.getTime()) / 6e4);
+  const sign2 = minutes < 0 ? "-" : "+";
+  const abs = Math.abs(minutes);
+  return `${sign2}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
+}
+function wallPartsIn(instant, tz) {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    // h23 pins midnight to hour 00; without it some ICU builds render hour 24.
+    hourCycle: "h23"
+  }).formatToParts(instant);
+  const out = {};
+  for (const p of parts) {
+    if (p.type !== "literal") out[p.type] = Number(p.value);
+  }
+  return out;
+}
+function wallTimeToInstant(y, mo, d, h, mi, s, ms, tz) {
+  let guess = Date.UTC(y, mo - 1, d, h, mi, s, ms);
+  for (let i = 0; i < 2; i += 1) {
+    const seen = wallPartsIn(new Date(guess), tz);
+    const seenUTC = Date.UTC(seen.year, seen.month - 1, seen.day, seen.hour, seen.minute, seen.second, ms);
+    const drift = Date.UTC(y, mo - 1, d, h, mi, s, ms) - seenUTC;
+    if (drift === 0) break;
+    guess += drift;
+  }
+  return new Date(guess);
+}
+function pad(n, width = 2) {
+  return String(n).padStart(width, "0");
+}
+function isoWithOffset(instant, tz, offset) {
+  const w = wallPartsIn(instant, tz);
+  const msPart = instant.getUTCMilliseconds();
+  const frac = msPart ? `.${pad(msPart, 3)}` : "";
+  return `${pad(w.year, 4)}-${pad(w.month)}-${pad(w.day)}T${pad(w.hour)}:${pad(w.minute)}:${pad(w.second)}${frac}${offset}`;
+}
+function formatInstant(instant, tz = displayTimeZone()) {
+  const offset = offsetAt(instant, tz);
+  const display = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    weekday: "short",
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "2-digit",
+    timeZoneName: "short"
+  }).format(instant);
+  return { iso: isoWithOffset(instant, tz, offset), display };
+}
+var TIMESTAMP_KEYS = /* @__PURE__ */ new Set([
+  "date",
+  // gog gmail message/thread listings ("2026-07-28 03:36")
+  "dateTime",
+  // Calendar event start/end
+  "internalDate",
+  // Gmail, epoch milliseconds (authoritative)
+  // gog >= 0.35.0 Gmail message AND thread listings. Already offset-bearing
+  // (RFC3339 from internalDate), so it needs no offset repair — it is
+  // allowlisted purely to gain a Display sibling, and to be re-rendered in
+  // DISPLAY_TZ like every other instant. Separately sourced from the sibling
+  // `date`, which is a naive re-format of the sender's Date header; the two may
+  // legitimately disagree. See docs/timestamps.md.
+  "internalDateIso",
+  "modifiedTime",
+  // Drive
+  "createdTime",
+  // Drive
+  "createTime",
+  "updateTime",
+  "updated",
+  "originalStartTime",
+  "expirationTime",
+  "lastModified",
+  "sentAt",
+  "viewedAt",
+  "modifiedAt",
+  "fetchedBodyAt",
+  "asOf"
+]);
+var ZONE_NAME_KEYS = /* @__PURE__ */ new Set(["timeZone", "timezone"]);
+var RFC3339_WITH_OFFSET = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?(?:\.(\d{1,9}))?(Z|[+-]\d{2}:?\d{2})$/;
+var NAIVE_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?(?:\.(\d{1,9}))?$/;
+var EPOCH_MILLIS = /^\d{13}$/;
+var DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+function isRealCalendarDate(p) {
+  const utc = new Date(Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second));
+  return utc.getUTCFullYear() === p.year && utc.getUTCMonth() === p.month - 1 && utc.getUTCDate() === p.day && utc.getUTCHours() === p.hour && utc.getUTCMinutes() === p.minute && utc.getUTCSeconds() === p.second;
+}
+function parseTimestampValue(key, value, assumeNaiveIn) {
+  if (typeof value !== "string") return null;
+  const raw = value.trim();
+  if (raw === "" || DATE_ONLY.test(raw)) return null;
+  if (key === "internalDate" && EPOCH_MILLIS.test(raw)) {
+    return new Date(Number(raw));
+  }
+  if (RFC3339_WITH_OFFSET.test(raw)) {
+    const parsed = new Date(raw.replace(" ", "T"));
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+  }
+  const naive = NAIVE_DATE_TIME.exec(raw);
+  if (naive) {
+    const [, y, mo, d, h, mi, s, frac] = naive;
+    const ms = frac ? Number(frac.padEnd(3, "0").slice(0, 3)) : 0;
+    const parts = {
+      year: Number(y),
+      month: Number(mo),
+      day: Number(d),
+      hour: Number(h),
+      minute: Number(mi),
+      second: Number(s ?? "0")
+    };
+    if (!isRealCalendarDate(parts)) return null;
+    return wallTimeToInstant(
+      parts.year,
+      parts.month,
+      parts.day,
+      parts.hour,
+      parts.minute,
+      parts.second,
+      ms,
+      assumeNaiveIn
+    );
+  }
+  return null;
+}
+function walk2(node2, tz, naiveTz) {
+  let changed = false;
+  if (Array.isArray(node2)) {
+    for (const item of node2) {
+      if (walk2(item, tz, naiveTz)) changed = true;
+    }
+    return changed;
+  }
+  if (node2 === null || typeof node2 !== "object") return false;
+  const obj = node2;
+  for (const key of Object.keys(obj)) {
+    const value = obj[key];
+    if (value !== null && typeof value === "object") {
+      if (walk2(value, tz, naiveTz)) changed = true;
+      continue;
+    }
+    if (ZONE_NAME_KEYS.has(key) || !TIMESTAMP_KEYS.has(key)) continue;
+    const instant = parseTimestampValue(key, value, naiveTz);
+    if (!instant) continue;
+    const { iso, display } = formatInstant(instant, tz);
+    obj[key] = iso;
+    obj[`${key}Display`] = display;
+    changed = true;
+  }
+  return changed;
+}
+function detectIndent(text) {
+  const match = /\n(\s+)\S/.exec(text);
+  return match ? match[1].replace(/\t/g, "  ").length : 0;
+}
+function normalizeTimestamps(text, tz = displayTimeZone(), naiveTz = naiveSourceTimeZone()) {
+  const trimmed = text.trim();
+  if (trimmed === "" || !/^[[{]/.test(trimmed)) return text;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    return text;
+  }
+  if (!walk2(parsed, tz, naiveTz)) return text;
+  return JSON.stringify(parsed, null, detectIndent(text));
+}
+
+// src/runner.ts
 function isGogFileArg(arg) {
   return typeof arg !== "string";
 }
@@ -33158,7 +33359,7 @@ async function spawnGog(fullArgs, opts) {
   const spawn = spawner ?? (await import("node:child_process")).spawn;
   const effectiveTimeout = timeout ?? TIMEOUT_MS;
   return new Promise((resolve, reject) => {
-    const childEnv = { ...sanitizedEnv(), PATH: augmentedPath() };
+    const childEnv = { ...sanitizedEnv(), GOG_TIMEZONE: naiveSourceTimeZone(), PATH: augmentedPath() };
     const child = spawn(readEnvVar("GOG_PATH") ?? "gog", fullArgs, { env: childEnv });
     const stdoutChunks = [];
     const stderrChunks = [];
@@ -33240,205 +33441,6 @@ async function runBinary(args, options = {}) {
   return spawnExecutor(fullArgs, { timeout, interactive: false, spawner, binary: true });
 }
 
-// src/timestamps.ts
-var DEFAULT_DISPLAY_TZ = "America/New_York";
-function isValidTimeZone(tz) {
-  try {
-    new Intl.DateTimeFormat("en-US", { timeZone: tz });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function displayTimeZone() {
-  const configured = readEnvVar("DISPLAY_TZ");
-  if (configured && isValidTimeZone(configured)) return configured;
-  return DEFAULT_DISPLAY_TZ;
-}
-function naiveSourceTimeZone() {
-  const configured = readEnvVar("GOG_TIMEZONE");
-  if (configured && isValidTimeZone(configured)) return configured;
-  return displayTimeZone();
-}
-function offsetAt(instant, tz) {
-  const w = wallPartsIn(instant, tz);
-  const asUTC = Date.UTC(w.year, w.month - 1, w.day, w.hour, w.minute, w.second, instant.getUTCMilliseconds());
-  const minutes = Math.round((asUTC - instant.getTime()) / 6e4);
-  const sign2 = minutes < 0 ? "-" : "+";
-  const abs = Math.abs(minutes);
-  return `${sign2}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
-}
-function wallPartsIn(instant, tz) {
-  const parts = new Intl.DateTimeFormat("en-US", {
-    timeZone: tz,
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-    // h23 pins midnight to hour 00; without it some ICU builds render hour 24.
-    hourCycle: "h23"
-  }).formatToParts(instant);
-  const out = {};
-  for (const p of parts) {
-    if (p.type !== "literal") out[p.type] = Number(p.value);
-  }
-  return out;
-}
-function wallTimeToInstant(y, mo, d, h, mi, s, ms, tz) {
-  let guess = Date.UTC(y, mo - 1, d, h, mi, s, ms);
-  for (let i = 0; i < 2; i += 1) {
-    const seen = wallPartsIn(new Date(guess), tz);
-    const seenUTC = Date.UTC(seen.year, seen.month - 1, seen.day, seen.hour, seen.minute, seen.second, ms);
-    const drift = Date.UTC(y, mo - 1, d, h, mi, s, ms) - seenUTC;
-    if (drift === 0) break;
-    guess += drift;
-  }
-  return new Date(guess);
-}
-function pad(n, width = 2) {
-  return String(n).padStart(width, "0");
-}
-function isoWithOffset(instant, tz, offset) {
-  const w = wallPartsIn(instant, tz);
-  const msPart = instant.getUTCMilliseconds();
-  const frac = msPart ? `.${pad(msPart, 3)}` : "";
-  return `${pad(w.year, 4)}-${pad(w.month)}-${pad(w.day)}T${pad(w.hour)}:${pad(w.minute)}:${pad(w.second)}${frac}${offset}`;
-}
-function formatInstant(instant, tz = displayTimeZone()) {
-  const offset = offsetAt(instant, tz);
-  const display = new Intl.DateTimeFormat("en-US", {
-    timeZone: tz,
-    weekday: "short",
-    month: "short",
-    day: "numeric",
-    year: "numeric",
-    hour: "numeric",
-    minute: "2-digit",
-    timeZoneName: "short"
-  }).format(instant);
-  return { iso: isoWithOffset(instant, tz, offset), display };
-}
-var TIMESTAMP_KEYS = /* @__PURE__ */ new Set([
-  "date",
-  // gog gmail message/thread listings ("2026-07-28 03:36")
-  "dateTime",
-  // Calendar event start/end
-  "internalDate",
-  // Gmail, epoch milliseconds (authoritative)
-  // gog >= 0.35.0 Gmail message AND thread listings. Already offset-bearing
-  // (RFC3339 from internalDate), so it needs no offset repair — it is
-  // allowlisted purely to gain a Display sibling, and to be re-rendered in
-  // DISPLAY_TZ like every other instant. Separately sourced from the sibling
-  // `date`, which is a naive re-format of the sender's Date header; the two may
-  // legitimately disagree. See docs/timestamps.md.
-  "internalDateIso",
-  "modifiedTime",
-  // Drive
-  "createdTime",
-  // Drive
-  "createTime",
-  "updateTime",
-  "updated",
-  "originalStartTime",
-  "expirationTime",
-  "lastModified",
-  "sentAt",
-  "viewedAt",
-  "modifiedAt",
-  "fetchedBodyAt",
-  "asOf"
-]);
-var ZONE_NAME_KEYS = /* @__PURE__ */ new Set(["timeZone", "timezone"]);
-var RFC3339_WITH_OFFSET = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?(?:\.(\d{1,9}))?(Z|[+-]\d{2}:?\d{2})$/;
-var NAIVE_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2}))?(?:\.(\d{1,9}))?$/;
-var EPOCH_MILLIS = /^\d{13}$/;
-var DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
-function isRealCalendarDate(p) {
-  const utc = new Date(Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second));
-  return utc.getUTCFullYear() === p.year && utc.getUTCMonth() === p.month - 1 && utc.getUTCDate() === p.day && utc.getUTCHours() === p.hour && utc.getUTCMinutes() === p.minute && utc.getUTCSeconds() === p.second;
-}
-function parseTimestampValue(key, value, assumeNaiveIn) {
-  if (typeof value !== "string") return null;
-  const raw = value.trim();
-  if (raw === "" || DATE_ONLY.test(raw)) return null;
-  if (key === "internalDate" && EPOCH_MILLIS.test(raw)) {
-    return new Date(Number(raw));
-  }
-  if (RFC3339_WITH_OFFSET.test(raw)) {
-    const parsed = new Date(raw.replace(" ", "T"));
-    return Number.isNaN(parsed.getTime()) ? null : parsed;
-  }
-  const naive = NAIVE_DATE_TIME.exec(raw);
-  if (naive) {
-    const [, y, mo, d, h, mi, s, frac] = naive;
-    const ms = frac ? Number(frac.padEnd(3, "0").slice(0, 3)) : 0;
-    const parts = {
-      year: Number(y),
-      month: Number(mo),
-      day: Number(d),
-      hour: Number(h),
-      minute: Number(mi),
-      second: Number(s ?? "0")
-    };
-    if (!isRealCalendarDate(parts)) return null;
-    return wallTimeToInstant(
-      parts.year,
-      parts.month,
-      parts.day,
-      parts.hour,
-      parts.minute,
-      parts.second,
-      ms,
-      assumeNaiveIn
-    );
-  }
-  return null;
-}
-function walk2(node2, tz, naiveTz) {
-  let changed = false;
-  if (Array.isArray(node2)) {
-    for (const item of node2) {
-      if (walk2(item, tz, naiveTz)) changed = true;
-    }
-    return changed;
-  }
-  if (node2 === null || typeof node2 !== "object") return false;
-  const obj = node2;
-  for (const key of Object.keys(obj)) {
-    const value = obj[key];
-    if (value !== null && typeof value === "object") {
-      if (walk2(value, tz, naiveTz)) changed = true;
-      continue;
-    }
-    if (ZONE_NAME_KEYS.has(key) || !TIMESTAMP_KEYS.has(key)) continue;
-    const instant = parseTimestampValue(key, value, naiveTz);
-    if (!instant) continue;
-    const { iso, display } = formatInstant(instant, tz);
-    obj[key] = iso;
-    obj[`${key}Display`] = display;
-    changed = true;
-  }
-  return changed;
-}
-function detectIndent(text) {
-  const match = /\n(\s+)\S/.exec(text);
-  return match ? match[1].replace(/\t/g, "  ").length : 0;
-}
-function normalizeTimestamps(text, tz = displayTimeZone(), naiveTz = naiveSourceTimeZone()) {
-  const trimmed = text.trim();
-  if (trimmed === "" || !/^[[{]/.test(trimmed)) return text;
-  let parsed;
-  try {
-    parsed = JSON.parse(trimmed);
-  } catch {
-    return text;
-  }
-  if (!walk2(parsed, tz, naiveTz)) return text;
-  return JSON.stringify(parsed, null, detectIndent(text));
-}
-
 // src/pagination.ts
 function detectIndent2(text) {
   const match = /\n(\s+)\S/.exec(text);
@@ -35915,7 +35917,7 @@ function registerTasksTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "4.0.0" : "0.0.0";
+var VERSION = true ? "4.0.1" : "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": "4.0.0",
+  "version": "4.0.1",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/mint.yaml

@@ -72,10 +72,10 @@ env:
   - name: GOG_TIMEZONE
     required: false
     help: >-
-      The IANA zone gog itself formats its naive timestamps in. The wrapper
-      reads it (naiveSourceTimeZone) to re-attach the correct offset, so it
-      should match gog's own configuration. Falls back to DISPLAY_TZ, then to
-      America/New_York.
+      The IANA zone gog formats its naive timestamps in. The wrapper passes
+      it to every spawned gog and reads it back (naiveSourceTimeZone) to
+      re-attach the offset, so the two always agree. Unset or invalid, both
+      use DISPLAY_TZ, then America/New_York — never the host's local zone.
   - name: DISPLAY_TZ
     required: false
     help: >-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "mcpName": "io.github.chrischall/gogcli-mcp",
   "description": "MCP server wrapping gogcli for Google service access",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

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

package/src/runner.ts

@@ -1,6 +1,7 @@
 import type { ChildProcess } from 'node:child_process';
 import { delimiter, join } from 'node:path';
 import { parseBoolEnv, readEnvVar, redactSecrets as redactSharedSecrets } from '@chrischall/mcp-utils';
+import { naiveSourceTimeZone } from './timestamps.js';
 
 export type Spawner = (
   command: string,
@@ -371,7 +372,9 @@ async function spawnGog(
   const effectiveTimeout = timeout ?? TIMEOUT_MS;
 
   return new Promise((resolve, reject) => {
-    const childEnv = { ...sanitizedEnv(), PATH: augmentedPath() };
+    // gog must format naive dates in the zone normalizeTimestamps assumes; left
+    // to itself it falls back to the host's local zone (UTC on mcp-host).
+    const childEnv = { ...sanitizedEnv(), GOG_TIMEZONE: naiveSourceTimeZone(), PATH: augmentedPath() };
     const child = spawn(readEnvVar('GOG_PATH') ?? 'gog', fullArgs, { env: childEnv });
     const stdoutChunks: Buffer[] = [];
     const stderrChunks: Buffer[] = [];

package/tests/runner.test.ts

@@ -1,4 +1,4 @@
-import { describe, it, expect, vi } from 'vitest';
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 import { EventEmitter } from 'node:events';
 import { spawn as mockedSpawn } from 'node:child_process';
 import { run, runBinary } from '../src/runner.js';
@@ -588,6 +588,50 @@ describe('run', () => {
     }
   });
 
+  // gog formats naive dates in GOG_TIMEZONE, else the process's local zone; the
+  // wrapper re-attaches offsets assuming GOG_TIMEZONE, else DISPLAY_TZ. Unless
+  // gog is TOLD the zone the wrapper assumes, a UTC host shifts every date.
+  describe('pins gog to the zone the wrapper reads its naive dates in', () => {
+    const keys = ['GOG_TIMEZONE', 'DISPLAY_TZ'] as const;
+    let snapshot: Record<string, string | undefined>;
+    beforeEach(() => { snapshot = Object.fromEntries(keys.map((k) => [k, process.env[k]])); });
+    afterEach(() => {
+      for (const [k, v] of Object.entries(snapshot)) {
+        if (v === undefined) delete process.env[k];
+        else process.env[k] = v;
+      }
+    });
+    const zoneGogGets = async (): Promise<string | undefined> => {
+      const spawner = makeSpawner(0, '{}');
+      await run(['gmail', 'search', 'x'], { spawner });
+      return ((spawner as ReturnType<typeof vi.fn>).mock.calls[0][2].env as NodeJS.ProcessEnv).GOG_TIMEZONE;
+    };
+
+    it('defaults gog to America/New_York when neither zone is set', async () => {
+      delete process.env.GOG_TIMEZONE;
+      delete process.env.DISPLAY_TZ;
+      expect(await zoneGogGets()).toBe('America/New_York');
+    });
+
+    it('hands gog DISPLAY_TZ when GOG_TIMEZONE is unset', async () => {
+      delete process.env.GOG_TIMEZONE;
+      process.env.DISPLAY_TZ = 'America/Los_Angeles';
+      expect(await zoneGogGets()).toBe('America/Los_Angeles');
+    });
+
+    it('passes a valid GOG_TIMEZONE through unchanged', async () => {
+      process.env.GOG_TIMEZONE = 'Europe/London';
+      process.env.DISPLAY_TZ = 'America/Los_Angeles';
+      expect(await zoneGogGets()).toBe('Europe/London');
+    });
+
+    it('replaces an invalid GOG_TIMEZONE with the zone the wrapper falls back to', async () => {
+      process.env.GOG_TIMEZONE = 'Not/AZone';
+      delete process.env.DISPLAY_TZ;
+      expect(await zoneGogGets()).toBe('America/New_York');
+    });
+  });
+
   it('redacts Bearer with quoted/encoded characters', async () => {
     const stderrLeak = 'http 401: header was Bearer eyJ.test+slash/equal=padding more text';
     const spawner = makeSpawner(1, '', stderrLeak);