MCP Server

Returns the authenticated user's full profile including name, username, timezone, branding settings, and plan. No inputs required — always returns the profile of the connected account.

Returns Profile object with id, username, full_name, email, timezone, time_format, brand_color, bio, week_start, avatar_url, plan.

Updates one or more profile fields. Only include the fields to change — omitted fields stay untouched. Timezone changes affect future slot calculations but do not alter existing bookings.

Returns Updated Profile object.

Lists all event types (meeting templates) for the authenticated user. Active events are returned by default; pass includeInactive to also retrieve disabled ones.

Returns Array of EventType objects sorted by creation date.

Creates a new event type. The slug must be unique per user and forms the booking URL path (/{username}/{slug}). Newly created event types are active by default.

Returns The created EventType object.

Updates any subset of fields on an existing event type. Use isActive to pause bookings without deleting. Slug changes take effect immediately.

Returns The updated EventType object.

Permanently deletes an event type. Existing confirmed bookings are not affected. Use isActive: false instead if you want to preserve booking history.

Returns { success: true }

Returns all open time slots for an event type within a date range. Slots account for working hours, buffer times, existing bookings, and synced external calendar events. Pass the guest's timezone for localised results.

Returns Array of { start: ISO 8601, end: ISO 8601 } objects.

Lists the authenticated user's bookings with optional filters. Returns upcoming confirmed bookings by default, sorted by start time.

Returns Array of Booking objects.

Retrieves full details for a single booking including nested event type metadata. Use to display confirmation pages or sync to external systems.

Returns Booking object with nested event_types field.

Creates a confirmed booking for a guest. The slot must be within the event's availability window — call get_available_slots first. Returns an error if the slot is taken. Confirmation emails are sent automatically.

Returns The created Booking object with status: confirmed.

Cancels a confirmed booking, removes the calendar event, deletes the Zoom meeting if applicable, and sends a cancellation email to the guest. This action is irreversible.

Returns Updated Booking object with status: cancelled_by_host.

Reschedules a booking to a new time. Creates a new confirmed booking, marks the original as rescheduled, and sends rescheduling emails. The new slot must be available.

Returns The new Booking object at the rescheduled time.

Returns the host's weekly availability schedule — the days and hours during which bookings are accepted. Used alongside buffer times and external calendar data to compute open slots.

Returns Schedule object with name, timezone, and rules array (dayOfWeek, startTime, endTime, isEnabled).

Replaces the weekly working hour schedule. This is a full replacement — send all rules you want active. Days not included will block all bookings.

Returns Updated Schedule object with new rules.

Discovers a host's public event types by username before attempting a booking. Returns available meeting types, durations, and booking page URLs.

Returns Array of public EventType objects with booking page URLs.

Finds the optimal time slot with a host using preference-aware scoring, then optionally creates the booking. Runs as a dry run by default — set dryRun: false to confirm the booking. Supports rich scheduling constraints for time-of-day and day-of-week preferences.

Returns Best slot with score, and Booking object if dryRun is false.

Retrieves active scheduling preference rules. Rules can be explicit (set manually) or learned (inferred by AI from booking history). These rules power the slot scoring engine.

Returns Array of Preference objects with rule_type, rule payload, priority, and is_learned flag.

Creates a scheduling preference rule. Higher priority rules override lower ones when they conflict. Contact-scoped rules only apply when scheduling with that specific contact.

Returns The created Preference object.

Deletes a preference rule. Takes effect immediately — subsequent slot scoring calls will no longer apply this rule. Learned rules can also be deleted.

Returns { success: true }

Returns AI-computed patterns from booking history: busiest days, peak hours, back-to-back frequency, and weekly load. Each insight includes a confidence score (0–1). Pass recompute: true to refresh stale data.

Returns Array of Insight objects with insightType, summary, data payload, and confidence score.

Returns the full scheduling history and learned context for a contact — past bookings, observed time preferences, and contact-scoped preference rules. Use before creating a scheduling request to find the most convenient times.

Returns ContactContext with email, totalMeetings, preferredDays, preferredHourRange, recentBookings, and rules.

Computes a weighted health score (0–100) for your calendar over a date range. The score factors in meeting density, back-to-back sequences, missing buffers, and available focus time. Also returns actionable text recommendations.

Returns CalendarHealthResult with score, totalMeetings, totalHoursBooked, backToBackCount, focusTimeHours, overbookedDays, and recommendations array.

Finds double-booked or overlapping events within a date range. Returns each conflicting pair with the specific overlap duration in minutes.

Returns Object with conflicts array (eventA, eventB, overlapMinutes) and a total count.

Returns a daily breakdown of a single week — meeting count, total hours, and back-to-back sequences per day. Includes warnings for overloaded days. Defaults to the current week.

Returns WeekSummary with totalMeetings, totalHours, and byDay array with per-day stats and warnings.

Finds uninterrupted blocks of free time suitable for deep work. Filters out blocks shorter than minBlockMinutes. Optionally restricts results to a preferred hour range.

Returns Object with focusBlocks array (start, end, durationMinutes, date) and totalFocusHours.

Identifies back-to-back meetings and overloaded days, then suggests which specific bookings to move and better alternative times. Powered by the same scoring engine as smart booking.

Returns Object with suggestions array — each has the booking to move, the reason, and up to 3 suggestedSlots.

Sends an async scheduling request to another skdul user. The engine automatically finds mutual availability and proposes a matched slot. A notification email goes to the target. Returns 400 if no mutual slot is found.

Returns SchedulingRequest with requestId, status: pending, matchedSlotStart, matchedSlotEnd.

Lists scheduling requests where you are the initiator or recipient. Use direction to filter to sent or received. Pending requests are awaiting a response.

Returns Array of SchedulingRequest objects sorted by creation date descending.

Retrieves full details for a specific scheduling request including the matched slot and current status.

Returns SchedulingRequest object with all fields.

Accepts or rejects an incoming scheduling request. Accepting automatically creates a confirmed booking at the matched slot and notifies the initiator. Only the recipient can respond.

Returns If accepted: Booking object. If rejected: SchedulingRequest with status: rejected.

Cancels an outgoing scheduling request that has not yet been accepted. Only the initiator can cancel. If already accepted, cancel the resulting booking via cancel_booking instead.

Returns SchedulingRequest with status: cancelled.