Knows the business
Services, duration, price, professionals, time zone and today's date in the business time zone.
get_businessIf your company already has a bot talking to clients on WhatsApp or any other channel, connect it to Calendsk. The bot handles the conversation; open times, bookings and reminders live here.
Up to 10 bookings a month are free. No credit card.
Studio Aurora
bot connected to Calendsk
Hi! Any time for a haircut on Friday?
Sure! Friday with Camila:
2:30, please
Done, Marina! Haircut on Friday at 2:30 PM with Camila. Code A1B2C3D4.
tool called by the bot
create_booking({
starts_at: "2026-11-20T14:30:00-03:00",
customer_name: "Marina Lima",
customer_phone: "+5581999990000"
})booking confirmed · A1B2C3D4
Works with the agent you already use
Any agent that speaks MCP (Streamable HTTP) or calls a REST API can connect to the calendar.
Nothing to install: one key and one address.
In the dashboard, under Settings → API and MCP. Choose whether the key only reads or can also book. It is shown only once.
Over MCP at the address below, or through the REST API at /api/v1. The key goes in the Authorization header; over MCP, the agent can also sign in with your account (OAuth), no key needed.
It reads services and open times, confirms with the client and creates the booking. You see everything in the dashboard.
{
"mcpServers": {
"calendsk": {
"type": "http",
"url": "https://calendsk.com.br/api/mcp",
"headers": {
"Authorization": "Bearer csk_SUA_API_KEY"
}
}
}
}curl "https://calendsk.com.br/api/v1/slots?service_id=SERVICE_ID&days=3" \
-H "Authorization: Bearer csk_SUA_API_KEY"curl -X POST "https://calendsk.com.br/api/v1/bookings" \
-H "Authorization: Bearer csk_SUA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: conversa-8841-sexta-1430" \
-d '{
"service_id": "SERVICE_ID",
"starts_at": "2026-11-20T14:30:00-03:00",
"customer_name": "Marina Lima",
"customer_phone": "+5581999990000",
"notes": "came from WhatsApp"
}'The same operations exist over MCP and the REST API, with the same calendar rules.
Services, duration, price, professionals, time zone and today's date in the business time zone.
get_businessDay by day, up to 14 days at once, with the local time ready to tell the client.
get_available_slotsTwo clients never get the same time: the second one gets SLOT_TAKEN and the bot offers another.
create_bookingLists the bookings of whoever is in the conversation by phone number, or looks one up by code.
list_bookingsget_bookingRespecting how many hours ahead the business allows changes. Rescheduling doesn't use the monthly limit.
reschedule_bookingcancel_bookingThe client said they're coming? The bot records it and the confirmation shows up in the business dashboard.
confirm_bookingWith an idempotency key, repeating the same call returns the same booking.
idempotency_keyEvery failure comes with a stable code, a message and, when it makes sense, how long to wait before retrying.
{ code, message, retry_after }Each booking created comes with a link for the client to view, reschedule or cancel on their own.
manage_urlWith a valid mobile number, Calendsk sends the reminder up to 24 h before the appointment. You can turn it off if your bot already reminds the client.
The booking shows up in the calendar tagged “bot”, with a notification for the business.
Better to know before you integrate.
Calendsk doesn't send or answer the service messages. The conversation belongs to your bot; the calendar and the reminder live here.
The Calendsk reminder for bot bookings is optional. If your bot already reminds the client, turn it off in Settings.
That's the limit for each API key, MCP and REST API combined.
A booking created by the bot counts like any other: 10 a month on the Free plan, unlimited on Professional ($9.90 a month).
No. Any agent that connects to an MCP server over Streamable HTTP or can call a REST API works: OpenClaw, Hermes Agent, ChatGPT, Claude, n8n and others.
No. Your bot is the one talking to the client. Calendsk stores the bookings and only sends the reminder, up to 24 h before, when the booking has a valid mobile number.
Only the first one books. The second gets the SLOT_TAKEN error, and the bot fetches the open times again to offer another.
By default the deadline the business set in Settings applies (for example, up to 2 hours before). Past the deadline the call returns WINDOW_CLOSED.
Nothing extra. Bot bookings count toward your plan limit: 10 a month on Free and unlimited on Professional, for $9.90 a month.
Create the account, generate the API key and connect. The first bookings of the month are on us.