Skip to main content
GHL MCP Guide
BLK

Block Slots

Calendars & Scheduling · Basic · Updated March 2026

Create and manage blocked time periods on calendars to prevent bookings during specific times. Useful for holidays, meetings, and personal time.

Not every hour should be bookable. Holidays, team meetings, lunch breaks, personal time, and client-specific blackout periods all need to be blocked on calendars. Block Slots lets you programmatically manage these restrictions, which is especially useful when you need to apply blocks across multiple calendars or locations simultaneously.

What This MCP Tool Does

Create, update, list, and manage blocked time periods on calendars. Blocked slots remove time from availability, preventing bookings during those periods. This affects the results from Free Slots and the booking widget.

Endpoint Reference

Create a block: POST /calendars/block-slots Block a time period on a specific calendar. The blocked time is immediately removed from availability.

Update a block: PUT /calendars/block-slots/{blockId} Modify the dates, times, or calendar assignment of an existing block.

List blocked slots: GET /calendars/blocked-slots Retrieve all blocked time periods for a calendar.

Authentication

Requires a Private Integration Token (PIT) with the calendars scope enabled.

Key Parameters

  • calendarId — the calendar to block time on
  • startTime — block start in ISO 8601 format
  • endTime — block end in ISO 8601 format
  • title — optional label for the block (e.g., “Holiday,” “Team Meeting”)

Important Notes

Blocks are applied per calendar. To block time across all calendars in a location (like a company holiday), you need to create blocks on each calendar individually. This is where MCP automation shines — script a loop that applies the same block across every calendar.

Blocks don’t cancel existing appointments. If someone is already booked during a time you block, their appointment remains. Blocks only prevent new bookings. Check for existing appointments before blocking if you need to handle conflicts.

Recurring blocks (every Monday 12-1pm for team meetings) aren’t supported as a native recurring pattern. You’d create individual blocks for each occurrence, which is straightforward to automate through MCP.

Common Questions

Can I block an entire day? Yes. Set the start time to the beginning of the day and end time to the end of the day in the calendar’s timezone.

Do blocks affect existing appointments? No. Existing bookings remain. Blocks only prevent new bookings during the blocked period.

Can I create recurring blocks? Not natively. Create individual blocks for each occurrence. This is easy to script: generate dates for every Monday for the next 3 months and create a block for each one.

How do I unblock time? Delete the block via the block ID. The time immediately becomes available again for booking.

Back to GHL MCP Guide