@elitedcs/ghl-mcp 3.62.1 → 3.63.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 3.63.0 — the guide library grows from 3 guides to 20
+
+- **`get_user_guide` now opens a 20-guide library.** Seventeen guides were
+  written and proven live but had never shipped, so anyone running
+  `get user guide` was still getting the three-guide edition. The bundled
+  offline guide goes from 43KB to 111KB: 20 open guides, 10 still marked
+  "Available in the app" until their prompts are proven. Every prompt marked
+  "Proven live" was run against a real GoHighLevel account before it shipped.
+- Same library renders to ghlcommand.com/skills, so the in-product guide and
+  the website always match.
+- **Fix: reading appointments returned nothing.** `get_calendar_events` sent
+  ISO timestamps, but GHL's `/calendars/events` needs epoch milliseconds and
+  answers a wrong-format request with `200` and an empty array instead of an
+  error — so a calendar holding real confirmed bookings read back as "nothing
+  booked". Now converts via the timezone-aware helper free-slots already used,
+  plus an optional `timezone` parameter so a bare `YYYY-MM-DD` window resolves
+  in the sub-account's timezone (end date inclusive). Live-proven both
+  directions.
+
 ## 3.62.1 — update_pipeline works again (Bug 8)
 
 - **Fix: `update_pipeline` no longer 422s.** GHL's pipeline PUT rejects unknown

package/dist/index.js

@@ -2854,7 +2854,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.62.1",
+      version: "3.63.0",
       mcpName: "io.github.drjerryrelth/ghl-command",
       description: "GoHighLevel MCP Server for Claude. 235 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, live funnel-capture verification, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
@@ -7643,7 +7643,7 @@ function toEpochMillis(value, opts = {}) {
   const trimmed = value.trim();
   if (/^\d+$/.test(trimmed)) {
     if (trimmed.length === 13) return trimmed;
-    throw new Error(`Ambiguous numeric date "${value}" for free-slots \u2014 pass epoch MILLISECONDS (13 digits), a YYYY-MM-DD date, or a full ISO datetime.`);
+    throw new Error(`Ambiguous numeric date "${value}" \u2014 pass epoch MILLISECONDS (13 digits), a YYYY-MM-DD date, or a full ISO datetime.`);
   }
   const dateOnly = /^(\d{4})-(\d{2})-(\d{2})$/.exec(trimmed);
   if (dateOnly) {
@@ -7658,7 +7658,7 @@ function toEpochMillis(value, opts = {}) {
   }
   const parsed = Date.parse(trimmed);
   if (!Number.isNaN(parsed)) return String(parsed);
-  throw new Error(`Invalid date "${value}" for free-slots \u2014 use YYYY-MM-DD, a full ISO datetime, or epoch milliseconds.`);
+  throw new Error(`Invalid date "${value}" \u2014 use YYYY-MM-DD, a full ISO datetime, or epoch milliseconds.`);
 }
 function buildFreeSlotsParams(args) {
   const params = {
@@ -7669,6 +7669,16 @@ function buildFreeSlotsParams(args) {
   if (args.userId !== void 0) params.userId = args.userId;
   return params;
 }
+function buildCalendarEventsParams(args) {
+  const params = {
+    locationId: args.locationId,
+    startTime: toEpochMillis(args.startTime, { timeZone: args.timezone }),
+    endTime: toEpochMillis(args.endTime, { endOfDay: true, timeZone: args.timezone })
+  };
+  if (args.calendarId !== void 0) params.calendarId = args.calendarId;
+  if (args.userId !== void 0) params.userId = args.userId;
+  return params;
+}
 function registerCalendarTools(server2, client) {
   safeTool(
     server2,
@@ -7789,20 +7799,25 @@ function registerCalendarTools(server2, client) {
     "List calendar events for a location within a time range",
     {
       locationId: import_zod12.z.string().optional().describe("Location ID (falls back to GHL_LOCATION_ID env var)"),
-      startTime: import_zod12.z.string().describe("Start time in ISO format"),
-      endTime: import_zod12.z.string().describe("End time in ISO format"),
+      startTime: import_zod12.z.string().describe(
+        "Start of the window. Accepts a date (YYYY-MM-DD), a full ISO datetime, or epoch milliseconds. A bare date is taken as start-of-day in `timezone` (UTC if unset). GHL needs epoch ms here; the tool converts for you."
+      ),
+      endTime: import_zod12.z.string().describe(
+        "End of the window. Accepts a date (YYYY-MM-DD), a full ISO datetime, or epoch milliseconds. A bare date is taken as END of that day, inclusive, in `timezone`."
+      ),
+      timezone: import_zod12.z.string().optional().describe("IANA timezone (e.g. America/Phoenix) used to resolve bare YYYY-MM-DD dates. Defaults to UTC."),
       calendarId: import_zod12.z.string().optional().describe("Filter by calendar ID"),
       userId: import_zod12.z.string().optional().describe("Filter by user ID")
     },
-    async ({ locationId: locationId2, startTime, endTime, calendarId, userId }) => {
-      const resolvedLocationId = client.resolveLocationId(locationId2);
-      const params = {
-        locationId: resolvedLocationId,
+    async ({ locationId: locationId2, startTime, endTime, timezone, calendarId, userId }) => {
+      const params = buildCalendarEventsParams({
+        locationId: client.resolveLocationId(locationId2),
         startTime,
-        endTime
-      };
-      if (calendarId !== void 0) params.calendarId = calendarId;
-      if (userId !== void 0) params.userId = userId;
+        endTime,
+        timezone,
+        calendarId,
+        userId
+      });
       return await client.get("/calendars/events", { params });
     }
   );