Skip to content

MCP server

Zaptime runs a Model Context Protocol server. Connect an AI assistant to it and the assistant can look up your booking links, check availability, search and manage reservations, edit event types, availability schedules, days off, booking forms, workflows and email templates on your behalf.

INFO

The MCP integration requires a paid Zaptime plan on at least one of your teams. Assistants connected to an account without a paid team receive an error on every call.

Server URL

https://my.zaptime.app/mcp

The URL is also shown in the Zaptime app under Integrations → AI Assistants (MCP), together with the list of connected assistants and a button to revoke each one.

Transport is streamable HTTP. Authentication is OAuth 2.1 with dynamic client registration: the assistant opens a Zaptime login page, you sign in and approve the access, and the assistant receives a token scoped to your user. No API key is needed.

Connect a client

txt
Settings → Connectors → Add custom connector
Name: Zaptime
URL:  https://my.zaptime.app/mcp
Sign in to Zaptime when prompted.
sh
claude mcp add --transport http zaptime https://my.zaptime.app/mcp
# then in a session:
/mcp   # pick "zaptime" and complete the OAuth login in the browser
txt
Settings → Connectors → Create
(requires a ChatGPT plan with connector support)
URL: https://my.zaptime.app/mcp
json
{
  "mcpServers": {
    "zaptime": {
      "url": "https://my.zaptime.app/mcp"
    }
  }
}

Other MCP clients that support streamable HTTP with OAuth work the same way: add the URL and complete the login.

Revoking access

In the Zaptime app open Integrations → AI Assistants (MCP) and click Revoke next to the client. The assistant loses access immediately and has to be authorized again to reconnect.

Tools

All tools act as the signed-in user and default to their personal team. When you belong to several teams, the assistant calls list_teams first and passes the team slug to the other tools.

ToolWhat it does
get_booking_linksList the user's event types with their public booking URLs.
resolve_booking_linkPick the best booking link for an inbound message ("Can I schedule a viewing?") and return its URL with a confidence score and alternatives. Built for drafting email replies.
check_availabilityAvailable time slots of an event type for a date range.
get_event_typeFull configuration of one event type.
manage_event_typeUpdate name, description, duration and similar; enable or disable; change the user's own booking rules and reschedule policy.
list_booking_form_fields / manage_booking_form_fieldRead and edit the questions of a booking form.

Reservations

ToolWhat it does
list_upcoming_reservationsUpcoming bookings of a team, optional date range.
search_reservationsFind reservations by email, name, phone, date or status.
cancel_reservationCancel a booking. Previews first; executes only with confirm: true.
reschedule_reservationMove a booking to a new start time. Previews first; executes only with confirm: true.

Schedules and absences

ToolWhat it does
list_availabilities / manage_availabilityWeekly opening-hours schedules; create, update, delete, attach to or detach from an event type.
list_days_off / manage_days_offThe user's own vacations and absences.

Appearance and domains

ToolWhat it does
list_appearances / manage_appearanceVisual themes of booking pages (colors, radius) and which event types use them.
list_booking_page_domains / manage_booking_page_domainCustom domains serving the public booking pages.
list_email_sending_domains / manage_email_sending_domainCustom domains for outgoing email.

Automation

ToolWhat it does
list_workflows / manage_workflowWorkflows (trigger → action such as email, SMS, Slack, webhook, CRM push) and their assignment to event types.
get_email_template / manage_email_templateSubject, title and content of a workflow's email template, including available merge tags.
list_integrationsConnected integrations and lookups the workflows need (Freelo projects, Ecomail lists, ...).

Statistics

ToolWhat it does
get_team_statsBooking statistics and trends for a team.
get_member_statsPer-member reservation statistics.

Safety rules

  • Destructive actions (cancel, reschedule, delete, detach) run in two steps. The first call returns a preview; the assistant must show it to you and call again with confirm: true.
  • Every write goes through the same authorization as the web app. A team member cannot do more through MCP than in the dashboard.
  • Personal settings (own booking rules, own availability attachment, own days off) are self-service only; the assistant cannot edit them for teammates.
  • Never editable through MCP: event type slugs, member assignments, payment (Stripe) settings, template attachments and logos. The assistant points you to the web app for those.
  • Shared objects (an availability or appearance used by several event types) report every affected event type when changed.

Example prompts

Reply to this email and include my booking link:
"Hi, I'd like to schedule a demo next week."
Who booked with me this week? Cancel the 3pm Thursday call with john@doe.test.
Add a day off next Friday and set Mon–Thu 9:00–16:00 as the availability for "Intro call".
Create a workflow that sends a reminder email 24 hours before every "Consultation" booking.