API and MCP for customer service bots

Your bot does the talking. Calendsk keeps the calendar.

If 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.

Works with the agent you already use

Any agent that speaks MCP (Streamable HTTP) or calls a REST API can connect to the calendar.

OpenClawHermes AgentOpenDotsOpenAI DotsChatGPTClaudeGeminiGrokCursorn8nPerplexity
How it works

From zero to the first booking in three steps

Nothing to install: one key and one address.

  1. 01

    Create an API key

    In the dashboard, under Settings → API and MCP. Choose whether the key only reads or can also book. It is shown only once.

  2. 02

    Connect the bot

    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.

  3. 03

    The bot checks and books

    It reads services and open times, confirms with the client and creates the booking. You see everything in the dashboard.

MCP configuration
{
  "mcpServers": {
    "calendsk": {
      "type": "http",
      "url": "https://calendsk.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer csk_SUA_API_KEY"
      }
    }
  }
}
GET /api/v1/slots · Open times
curl "https://calendsk.com.br/api/v1/slots?service_id=SERVICE_ID&days=3" \
  -H "Authorization: Bearer csk_SUA_API_KEY"
POST /api/v1/bookings · Create a booking
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"
  }'
What the bot does

Everything the front desk does, in eight tools

The same operations exist over MCP and the REST API, with the same calendar rules.

Knows the business

Services, duration, price, professionals, time zone and today's date in the business time zone.

get_business

Sees open times

Day by day, up to 14 days at once, with the local time ready to tell the client.

get_available_slots

Books without conflicts

Two clients never get the same time: the second one gets SLOT_TAKEN and the bot offers another.

create_booking

Finds the client by phone

Lists the bookings of whoever is in the conversation by phone number, or looks one up by code.

list_bookingsget_booking

Reschedules and cancels

Respecting how many hours ahead the business allows changes. Rescheduling doesn't use the monthly limit.

reschedule_bookingcancel_booking

Confirms attendance

The client said they're coming? The bot records it and the confirmation shows up in the business dashboard.

confirm_booking

Retries without duplicates

With an idempotency key, repeating the same call returns the same booking.

idempotency_key

Errors the bot understands

Every failure comes with a stable code, a message and, when it makes sense, how long to wait before retrying.

{ code, message, retry_after }

A link for the client

Each booking created comes with a link for the client to view, reschedule or cancel on their own.

manage_url

WhatsApp reminder

With 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.

All in the owner's dashboard

The booking shows up in the calendar tagged “bot”, with a notification for the business.

No fine print

What Calendsk doesn't do

Better to know before you integrate.

It doesn't talk to the client

Calendsk doesn't send or answer the service messages. The conversation belongs to your bot; the calendar and the reminder live here.

No double reminders

The Calendsk reminder for bot bookings is optional. If your bot already reminds the client, turn it off in Settings.

120 calls per minute

That's the limit for each API key, MCP and REST API combined.

Counts toward the plan limit

A booking created by the bot counts like any other: 10 a month on the Free plan, unlimited on Professional ($9.90 a month).

Questions

Questions from people about to integrate

Do I need a specific bot?

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.

Does Calendsk send WhatsApp messages on behalf of my bot?

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.

What if two clients ask for the same time?

Only the first one books. The second gets the SLOT_TAKEN error, and the bot fetches the open times again to offer another.

Can the bot cancel at any time?

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.

How much does the API cost?

Nothing extra. Bot bookings count toward your plan limit: 10 a month on Free and unlimited on Professional, for $9.90 a month.

Get your bot booking today

Create the account, generate the API key and connect. The first bookings of the month are on us.