Availability lookup
Retrieve available slots over a selected date range.
Scheduling API, webhooks and MCP
Connect LunaCal scheduling to your application, automation or AI assistant. Use the API to manage appointments, webhooks to respond to booking changes and MCP to give compatible AI clients access to scheduling tools.
Start your free trialCompare scheduling tools ↓
Developer access across the appointment lifecycle
Use the integration surface that matches the job: API requests for actions, webhooks for notifications and MCP for AI tools.
Create bookings
Book an appointment through the API.
Reschedule and cancel
Update an appointment or cancel it programmatically.
Booking retrieval
Retrieve paginated booking lists, including upcoming, past and cancelled bookings.
Event-type management
List, create, update and delete event types through the API.
Publishing controls
Switch event types between published and unpublished states.
OAuth authorization
Connect an account with an authorization-code flow.
Booking webhooks
Receive notifications for seven booking and payment events.
Remote MCP server
Connect compatible AI clients through OAuth-based authorization.
Send booking changes to your own endpoint
Create a webhook subscription for the events your application needs. The payload carries booking information and responses from the appointment form.
- Open the webhook settings and enter the subscriber URL.
- Select the booking or payment triggers your integration handles.
- Use Ping Test to send a sample payload and check for a successful response.
Choose how your software connects
Scheduling API
Send authenticated JSON requests to manage availability, bookings and event types from your backend. LunaCal API endpoints use POST, including read operations.
Webhooks
Let booking activity trigger your application instead of repeatedly checking for changes. Choose the events each subscription receives.
MCP server
Connect a compatible AI client to https://mcp.lunacal.ai/mcp using Streamable HTTP and OAuth authorization.
No-code connections
Use existing integrations when an automation tool can handle the workflow without custom application code.
Handle more than the initial booking
A request, an approved booking and a successful payment are separate moments. LunaCal exposes distinct webhook triggers so your integration can react to the right one.
Booking lifecycle
Subscribe to Booking Created, Booking Rescheduled and Booking Cancelled.
Approval decisions
Use Booking Requested and Booking Rejected for appointment workflows that need review.
Payment lifecycle
Separate Booking Payment Initiated from Booking Paid before marking an appointment as paid in another system.
Keep your service configuration in LunaCal
Your integration works with LunaCal event types rather than maintaining a second catalogue of booking links. Retrieve the event configuration or update it through the API.
- Retrieve event types grouped by scheduling profile.
- Create or update event details and control publication.
- Use MCP tools to find availability, create or cancel bookings and manage event types.
Why build a scheduling integration with LunaCal?
Connect the booking system you already operate to the tools your team needs, from traditional backends to AI assistants.
Appointment and payment signals together
The webhook event set covers approval decisions and payment stages as well as created, cancelled and rescheduled appointments.
One service configuration
Manage event types in LunaCal and use the same objects through your application or connected AI client.
Choose the level of integration
Teams starts at $15 per user per month and includes webhooks. Enterprise starts at $25 and includes the MCP server beta alongside SSO.
LunaCal vs Calendly, Cal.com and Acuity for developers
Each tool supports custom scheduling integrations. Choose by the actions, authorization model and booking information your application needs.
| Capability | LunaCal | Calendly | Cal.com | Acuity |
|---|---|---|---|---|
| Public API | Yes | Yes | Yes | Yes |
| Authentication options | OAuth | OAuth / tokens | OAuth / keys | OAuth / keys |
| Availability lookup | Yes | Yes | Yes | Yes |
| Create bookings | Yes | Yes | Yes | Yes |
| Retrieve bookings | Yes | Yes | Yes | Yes |
| Cancel bookings | Yes | Yes | Yes | Yes |
| Event-type retrieval | Yes | Yes | Yes | Yes |
| Booking-created webhooks | Yes | Yes | Yes | Yes |
| Cancellation webhooks | Yes | Yes | Yes | Yes |
| Rescheduling webhooks | Yes | Yes | Yes | Yes |
| Custom booking responses | Webhook payload | API / webhooks | API / webhooks | Appointment API |
| Website embedding | Yes | Yes | Yes | Yes |
| No-code integrations | Yes | Yes | Yes | Yes |
Scheduling developer questions
What can I do with the LunaCal API?
Retrieve availability and bookings, create, reschedule or cancel appointments, and manage event types. The API documentation describes the required fields and responses for each endpoint.
How does API authentication work?
LunaCal uses an OAuth 2.0 authorization-code flow. Access tokens last one hour; refresh tokens last 365 days and rotate when refreshed. Store the newly returned tokens securely on your server.
Do read endpoints use GET?
No. The documented LunaCal API endpoints use POST with JSON bodies, including endpoints that retrieve data.
Which webhook events are available?
Booking Created, Booking Cancelled, Booking Rescheduled, Booking Requested, Booking Rejected, Booking Payment Initiated and Booking Paid.
Can webhooks include custom booking answers?
Yes. Booking-question answers are included in the payload’s responses field, allowing your integration to retain information collected during booking.
How do AI clients connect to LunaCal?
Compatible clients connect to the remote MCP endpoint using Streamable HTTP. The server uses OAuth 2.1 with PKCE rather than requiring you to paste an API key into the client.
Can an AI assistant change bookings?
The MCP tool set includes availability lookup, booking creation and cancellation, booking retrieval and event-type management. Connect the account and authorize the client before using those tools.