@elitedcs/ghl-mcp 3.34.7 → 3.34.9

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # Changelog
 
+## 3.34.9 — Calendar availability: create_calendar / update_calendar now set `openHours`
+
+Closes the on-camera "assign availability hours" gap. `create_calendar` and
+`update_calendar` previously exposed no availability parameter, so every calendar
+was created with `openHours: {}` and a caller could not set business hours through
+the MCP — the calendar only offered GHL's default window.
+
+- **New `openHours` (and `availabilityType`) params on `create_calendar` and
+  `update_calendar`.** `openHours` is an array of `{daysOfTheWeek:[0-6], hours:
+  [{openHour,openMinute,closeHour,closeMinute}]}` (0=Sun … 6=Sat, 24-hour clock).
+  When `openHours` is supplied the builder also sends `availabilityType: 0`
+  (standard weekly hours) — the exact payload GHL honors — unless the caller
+  overrides it.
+- **Multi-day blocks are auto-expanded to one block per day.** GHL's CREATE
+  endpoint 422s (`openHours.0.must be a valid day of week`) on a block listing more
+  than one weekday. Single-day-per-block is GHL's own canonical form (what it reads
+  back) and is accepted by both create and update. The builder accepts the natural
+  compact form (`daysOfTheWeek:[1,2,3,4,5]`) and expands it to per-day blocks. Logic
+  extracted to `buildCreateCalendarBody` / `buildUpdateCalendarBody` /
+  `expandOpenHours`, with tests.
+
+**Corrects the 3.34.8 note.** The earlier guess — that round-robin availability
+comes only from the user's working hours and not a calendar `openHours` field — was
+wrong. Pinned live on a real sub-account, the full model is:
+
+- `openHours` **does** drive availability. Setting it changes `/free-slots`
+  immediately (a Wed-only 13:00–15:00 window collapsed slots to Wednesdays
+  13:00–14:30; a Mon–Fri 9–6 window produced exactly 09:00–17:30 each weekday).
+- On **event / simple** calendars `openHours` is the sole source — every configured
+  day/time becomes bookable (a Sat 10–1 window booked Saturdays).
+- On **round_robin** "OptimizeForAvailability" calendars the bookable slots are the
+  **intersection** of `openHours` and each assigned user's working hours, so a day
+  only opens if a team member is also available then (the same Sat 10–1 window
+  produced zero slots when the lone user had no Saturday availability). To open a day
+  on round_robin, set the user's availability too (UI-gated), or use an event-type
+  calendar where `openHours` alone controls. The tool descriptions state this.
+
+Write-verified live: created calendars with hours through the builders, read the
+hours back, and confirmed `/free-slots` returned exactly the configured days/times;
+all throwaways deleted. Suite 289 pass / 1 skip.
+
+## 3.34.8 — create_opportunity + get_funnel_pages no longer 422 on omitted required params
+
+Two real defects found during a full end-to-end build test on a live sub-account
+(every advertised object created, read back, and deleted). Both are cases where GHL
+requires a parameter the tool treated as optional, so the call 422'd unless the
+caller happened to pass it.
+
+- **`create_opportunity` now defaults `status` to `"open"`.** GHL's
+  `POST /opportunities/` rejects a create with no status (`422 "status should not
+  be empty"`). The tool exposed `status` as optional and omitted it from the body,
+  so a bare create always failed. It now sends `status: "open"` when the caller
+  doesn't specify one. Logic extracted to `buildCreateOpportunityBody` with tests.
+- **`get_funnel_pages` now defaults `limit`/`offset`.** GHL's `GET /funnels/page`
+  requires both (`422 "limit should not be empty" / "offset should not be empty"`)
+  and caps `limit` at 20. The tool only sent them when provided, so listing a
+  funnel's pages failed by default. It now sends `limit: 20, offset: 0` when
+  omitted. (`get_funnels` / `GET /funnels/funnel/list` does not require them and is
+  unchanged.) Logic extracted to `buildFunnelPagesParams` with tests.
+
+Verified working in the same test pass (no change needed): create_funnel,
+create_funnel_page, create_form, create_calendar (incl. team-member assignment),
+create_custom_field, create_location_tag, create_contact, and the full workflow
+lifecycle (create → update actions → validate → publish). Suite 280 pass / 1 skip.
+
+Known follow-up (not in this release): exposing calendar availability / `openHours`.
+Investigation showed round-robin "OptimizeForAvailability" calendars derive
+availability from the assigned user's working hours, not a calendar `openHours`
+field (every live round-robin calendar inspected had `openHours: {}`), so this needs
+a design + live write-verification pass before shipping rather than a guessed shape.
+
 ## 3.34.7 — Audit now sees UUID pipeline-stage ids (dead-stage silent failure)
 
 - **`audit_workflows` / `validate_workflow` now catch a dead pipeline STAGE

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@elitedcs/ghl-mcp",
-      version: "3.34.7",
+      version: "3.34.9",
       mcpName: "io.github.drjerryrelth/ghl-command",
       description: "GoHighLevel MCP Server for Claude. 218 tools \u2014 full CRM, automation, marketing control, account-wide workflow audit, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
       main: "dist/index.js",
@@ -2540,6 +2540,20 @@ function registerConversationTools(server2, client) {
 var import_zod8 = require("zod");
 var statusEnum = import_zod8.z.enum(["open", "won", "lost", "abandoned"]).describe("Opportunity status");
 var statusEnumWithAll = import_zod8.z.enum(["open", "won", "lost", "abandoned", "all"]).describe("Opportunity status filter (use 'all' to include every status)");
+function buildCreateOpportunityBody(args, locationId2) {
+  const body = {
+    locationId: locationId2,
+    pipelineId: args.pipelineId,
+    pipelineStageId: args.pipelineStageId,
+    contactId: args.contactId,
+    name: args.name,
+    status: args.status ?? "open"
+  };
+  if (args.monetaryValue !== void 0) body.monetaryValue = args.monetaryValue;
+  if (args.assignedTo !== void 0) body.assignedTo = args.assignedTo;
+  if (args.source !== void 0) body.source = args.source;
+  return body;
+}
 function registerOpportunityTools(server2, client) {
   safeTool(
     server2,
@@ -2612,25 +2626,14 @@ function registerOpportunityTools(server2, client) {
       pipelineStageId: import_zod8.z.string().describe("Pipeline stage ID (required)"),
       contactId: import_zod8.z.string().describe("Contact ID (required)"),
       name: import_zod8.z.string().describe("Opportunity name (required)"),
-      status: statusEnum.optional().describe("Opportunity status"),
+      status: statusEnum.optional().describe("Opportunity status. Defaults to 'open' (GHL requires a non-empty status on create)."),
       monetaryValue: import_zod8.z.number().optional().describe("Monetary value of the opportunity"),
       assignedTo: import_zod8.z.string().optional().describe("User ID to assign the opportunity to"),
       source: import_zod8.z.string().optional().describe("Lead source")
     },
     async (args) => {
       const locationId2 = client.resolveLocationId(args.locationId);
-      const body = {
-        locationId: locationId2,
-        pipelineId: args.pipelineId,
-        pipelineStageId: args.pipelineStageId,
-        contactId: args.contactId,
-        name: args.name
-      };
-      if (args.status !== void 0) body.status = args.status;
-      if (args.monetaryValue !== void 0)
-        body.monetaryValue = args.monetaryValue;
-      if (args.assignedTo !== void 0) body.assignedTo = args.assignedTo;
-      if (args.source !== void 0) body.source = args.source;
+      const body = buildCreateOpportunityBody(args, locationId2);
       return await client.post("/opportunities/", { body });
     }
   );
@@ -2724,6 +2727,58 @@ var CalendarTeamMemberSchema = import_zod9.z.object({
   selected: import_zod9.z.boolean().describe("Whether this user is currently active on the calendar (true to enable)."),
   locationConfigurations: import_zod9.z.array(TeamMemberLocationConfigSchema).min(1).describe("At least one meeting-location config. Typical shape: [{kind:'custom', position:0, location:''}].")
 }).strict();
+var OpenHoursWindowSchema = import_zod9.z.object({
+  openHour: import_zod9.z.number().int().min(0).max(23).describe("Opening hour on a 24-hour clock (0-23)."),
+  openMinute: import_zod9.z.number().int().min(0).max(59).describe("Opening minute (0-59)."),
+  closeHour: import_zod9.z.number().int().min(0).max(23).describe("Closing hour on a 24-hour clock (0-23)."),
+  closeMinute: import_zod9.z.number().int().min(0).max(59).describe("Closing minute (0-59).")
+}).strict();
+var OpenHoursBlockSchema = import_zod9.z.object({
+  daysOfTheWeek: import_zod9.z.array(import_zod9.z.number().int().min(0).max(6)).min(1).describe("Weekdays this block applies to. 0=Sunday, 1=Monday, \u2026 6=Saturday."),
+  hours: import_zod9.z.array(OpenHoursWindowSchema).min(1).describe("One or more open time windows that apply to these days.")
+}).strict();
+function expandOpenHours(blocks) {
+  const out = [];
+  for (const block of blocks) {
+    for (const day of block.daysOfTheWeek) {
+      out.push({ daysOfTheWeek: [day], hours: block.hours });
+    }
+  }
+  return out;
+}
+function applyCalendarFields(body, args) {
+  if (args.description !== void 0) body.description = args.description;
+  if (args.slug !== void 0) body.slug = args.slug;
+  if (args.widgetSlug !== void 0) body.widgetSlug = args.widgetSlug;
+  if (args.calendarType !== void 0) body.calendarType = args.calendarType;
+  if (args.teamMembers !== void 0) body.teamMembers = args.teamMembers;
+  if (args.eventTitle !== void 0) body.eventTitle = args.eventTitle;
+  if (args.eventColor !== void 0) body.eventColor = args.eventColor;
+  if (args.slotDuration !== void 0) body.slotDuration = args.slotDuration;
+  if (args.slotBuffer !== void 0) body.slotBuffer = args.slotBuffer;
+  if (args.slotInterval !== void 0) body.slotInterval = args.slotInterval;
+  if (args.appointmentPerSlot !== void 0) body.appointmentPerSlot = args.appointmentPerSlot;
+  if (args.openHours !== void 0) {
+    body.openHours = expandOpenHours(args.openHours);
+    body.availabilityType = args.availabilityType ?? 0;
+  } else if (args.availabilityType !== void 0) {
+    body.availabilityType = args.availabilityType;
+  }
+}
+function buildCreateCalendarBody(args, resolvedLocationId) {
+  const body = {
+    locationId: resolvedLocationId,
+    name: args.name
+  };
+  applyCalendarFields(body, args);
+  return body;
+}
+function buildUpdateCalendarBody(args) {
+  const body = {};
+  if (args.name !== void 0) body.name = args.name;
+  applyCalendarFields(body, args);
+  return body;
+}
 function registerCalendarTools(server2, client) {
   safeTool(
     server2,
@@ -2768,25 +2823,15 @@ function registerCalendarTools(server2, client) {
       slotDuration: import_zod9.z.number().optional().describe("Slot duration in minutes"),
       slotBuffer: import_zod9.z.number().optional().describe("Buffer time between slots in minutes"),
       slotInterval: import_zod9.z.number().optional().describe("Slot interval in minutes"),
-      appointmentPerSlot: import_zod9.z.number().optional().describe("Max appointments per slot")
+      appointmentPerSlot: import_zod9.z.number().optional().describe("Max appointments per slot"),
+      openHours: import_zod9.z.array(OpenHoursBlockSchema).optional().describe(
+        "Weekly business hours that make slots bookable (the 'assign availability hours' step). Each entry maps weekdays (0=Sun \u2026 6=Sat) to one or more open windows on a 24-hour clock; multi-day entries are auto-expanded to GHL's required one-block-per-day form. Example Mon-Fri 9-6 + Sat 10-1: [{daysOfTheWeek:[1,2,3,4,5],hours:[{openHour:9,openMinute:0,closeHour:18,closeMinute:0}]},{daysOfTheWeek:[6],hours:[{openHour:10,openMinute:0,closeHour:13,closeMinute:0}]}]. Behavior (verified live): on event/simple calendars these hours are the sole source of availability. On round_robin calendars the bookable slots are the INTERSECTION of these hours and each assigned user's working hours, so a day only opens if a team member is also available then (e.g. a Saturday window needs a user with Saturday availability). Omit to use GHL's defaults."
+      ),
+      availabilityType: import_zod9.z.number().int().optional().describe("Availability mode. 0 = standard weekly hours (from openHours); auto-set when you pass openHours. Leave unset otherwise.")
     },
-    async ({ locationId: locationId2, name, description, slug, widgetSlug, calendarType, teamMembers, eventTitle, eventColor, slotDuration, slotBuffer, slotInterval, appointmentPerSlot }) => {
-      const resolvedLocationId = client.resolveLocationId(locationId2);
-      const body = {
-        locationId: resolvedLocationId,
-        name
-      };
-      if (description !== void 0) body.description = description;
-      if (slug !== void 0) body.slug = slug;
-      if (widgetSlug !== void 0) body.widgetSlug = widgetSlug;
-      if (calendarType !== void 0) body.calendarType = calendarType;
-      if (teamMembers !== void 0) body.teamMembers = teamMembers;
-      if (eventTitle !== void 0) body.eventTitle = eventTitle;
-      if (eventColor !== void 0) body.eventColor = eventColor;
-      if (slotDuration !== void 0) body.slotDuration = slotDuration;
-      if (slotBuffer !== void 0) body.slotBuffer = slotBuffer;
-      if (slotInterval !== void 0) body.slotInterval = slotInterval;
-      if (appointmentPerSlot !== void 0) body.appointmentPerSlot = appointmentPerSlot;
+    async (args) => {
+      const resolvedLocationId = client.resolveLocationId(args.locationId);
+      const body = buildCreateCalendarBody(args, resolvedLocationId);
       return await client.post("/calendars/", { body });
     }
   );
@@ -2807,23 +2852,15 @@ function registerCalendarTools(server2, client) {
       slotDuration: import_zod9.z.number().optional().describe("Slot duration in minutes"),
       slotBuffer: import_zod9.z.number().optional().describe("Buffer time between slots in minutes"),
       slotInterval: import_zod9.z.number().optional().describe("Slot interval in minutes"),
-      appointmentPerSlot: import_zod9.z.number().optional().describe("Max appointments per slot")
+      appointmentPerSlot: import_zod9.z.number().optional().describe("Max appointments per slot"),
+      openHours: import_zod9.z.array(OpenHoursBlockSchema).optional().describe(
+        "Weekly business hours that make slots bookable. Each entry maps weekdays (0=Sun \u2026 6=Sat) to one or more open windows on a 24-hour clock; multi-day entries are auto-expanded to GHL's required one-block-per-day form (e.g. [{daysOfTheWeek:[1,2,3,4,5],hours:[{openHour:9,openMinute:0,closeHour:18,closeMinute:0}]}] = Mon-Fri 9am-6pm). Replaces the calendar's existing hours. Behavior (verified live): event/simple calendars use these hours directly; round_robin calendars intersect them with each assigned user's working hours (a day only opens if a team member is available then)."
+      ),
+      availabilityType: import_zod9.z.number().int().optional().describe("Availability mode. 0 = standard weekly hours (from openHours); auto-set when you pass openHours. Leave unset otherwise.")
     },
-    async ({ calendarId, name, description, slug, widgetSlug, calendarType, teamMembers, eventTitle, eventColor, slotDuration, slotBuffer, slotInterval, appointmentPerSlot }) => {
-      const body = {};
-      if (name !== void 0) body.name = name;
-      if (description !== void 0) body.description = description;
-      if (slug !== void 0) body.slug = slug;
-      if (widgetSlug !== void 0) body.widgetSlug = widgetSlug;
-      if (calendarType !== void 0) body.calendarType = calendarType;
-      if (teamMembers !== void 0) body.teamMembers = teamMembers;
-      if (eventTitle !== void 0) body.eventTitle = eventTitle;
-      if (eventColor !== void 0) body.eventColor = eventColor;
-      if (slotDuration !== void 0) body.slotDuration = slotDuration;
-      if (slotBuffer !== void 0) body.slotBuffer = slotBuffer;
-      if (slotInterval !== void 0) body.slotInterval = slotInterval;
-      if (appointmentPerSlot !== void 0) body.appointmentPerSlot = appointmentPerSlot;
-      return await client.put(`/calendars/${calendarId}`, { body });
+    async (args) => {
+      const body = buildUpdateCalendarBody(args);
+      return await client.put(`/calendars/${args.calendarId}`, { body });
     }
   );
   safeTool(
@@ -3289,6 +3326,14 @@ function registerWorkflowTools(server2, client) {
 
 // src/tools/funnels.ts
 var import_zod12 = require("zod");
+function buildFunnelPagesParams(args) {
+  return {
+    locationId: args.locationId,
+    funnelId: args.funnelId,
+    limit: args.limit ?? 20,
+    offset: args.offset ?? 0
+  };
+}
 function registerFunnelTools(server2, client) {
   safeTool(
     server2,
@@ -3314,17 +3359,12 @@ function registerFunnelTools(server2, client) {
     {
       locationId: import_zod12.z.string().optional().describe("GHL Location ID (optional if GHL_LOCATION_ID is set)"),
       funnelId: import_zod12.z.string().describe("The funnel ID"),
-      limit: import_zod12.z.number().optional().describe("Max number of pages to return"),
-      offset: import_zod12.z.number().optional().describe("Offset for pagination")
+      limit: import_zod12.z.number().optional().describe("Max number of pages to return (1-20). Defaults to 20 (GHL requires it and caps at 20)."),
+      offset: import_zod12.z.number().optional().describe("Offset for pagination. Defaults to 0 (GHL requires it).")
     },
     async ({ locationId: locationId2, funnelId, limit, offset }) => {
       const resolvedLocationId = client.resolveLocationId(locationId2);
-      const params = {
-        locationId: resolvedLocationId,
-        funnelId
-      };
-      if (limit !== void 0) params.limit = limit;
-      if (offset !== void 0) params.offset = offset;
+      const params = buildFunnelPagesParams({ locationId: resolvedLocationId, funnelId, limit, offset });
       return client.get("/funnels/page", { params });
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.34.7",
+  "version": "3.34.9",
   "mcpName": "io.github.drjerryrelth/ghl-command",
   "description": "GoHighLevel MCP Server for Claude. 218 tools — full CRM, automation, marketing control, account-wide workflow audit, and the only programmatic GHL workflow builder, now multi-tenant across client accounts.",
   "main": "dist/index.js",