@elitedcs/ghl-mcp 3.34.8 → 3.34.9

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # 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

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.8",
+      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",
@@ -2727,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,
@@ -2771,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 });
     }
   );
@@ -2810,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(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elitedcs/ghl-mcp",
-  "version": "3.34.8",
+  "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",