CalioLaat je AI-assistent afspraken plannen
Calio heeft een ingebouwde MCP-server en een REST-API. Koppel Claude of een andere AI-assistent en zeg voortaan gewoon: “plan volgende week een kennismaking met Jansen” — de assistent checkt je beschikbaarheid en boekt het slot.
MCP: de AI-koppeling in 3 stappen
Voeg de connector toe
Geef je MCP-client (zoals Claude) het endpoint https://calio.nl/api/mcp. Een sleutel invullen hoeft niet.
Geef toestemming
Je client stuurt je naar Calio; je logt in en ziet wát je toestaat. Eén klik en de koppeling staat. Intrekken kan altijd bij Integraties.
Plan in gewone taal
"Wat kan ik donderdag?" of "Boek 30 min met piet@bedrijf.nl" — de assistent gebruikt de tools hieronder.
Beschikbare MCP-tools
list_event_types | Alle boekbare afspraaktypes, met duur, host en boekingslink (met language ook in de taal van je gast) |
get_available_slots | Vrije tijdsloten voor een afspraaktype binnen een periode |
create_booking | Een afspraak boeken op een vrij slot (gast krijgt automatisch mail) |
list_bookings | Boekingen binnen een periode, optioneel per status |
cancel_booking | Een bevestigde boeking annuleren (agenda wordt bijgewerkt) |
Liever zelf bouwen? De REST-API
Dezelfde mogelijkheden als de MCP-tools, als gewone JSON-API. Hier zijn API-sleutels wél de weg: een script heeft geen browser om toestemming in te geven. Authenticatie met Authorization: Bearer calio_sk_...
| GET | /api/v1/event-types?locale= | Afspraaktypes van je organisatie |
| GET | /api/v1/event-types/{slug}/slots?from=&to= | Vrije tijdsloten (UTC) |
| GET | /api/v1/bookings?from=&to=&status= | Boekingen opvragen |
| POST | /api/v1/bookings | Afspraak boeken |
| POST | /api/v1/bookings/{id}/cancel | Boeking annuleren |
curl -X POST https://calio.nl/api/v1/bookings \
-H "Authorization: Bearer calio_sk_..." \
-H "Content-Type: application/json" \
-d '{
"eventType": "kennismaking",
"startUtc": "2026-08-03T09:00:00Z",
"name": "Piet Jansen",
"email": "piet@bedrijf.nl"
}'Veelgestelde vragen
Hoe koppel ik Claude aan Calio?
Voeg in Claude (of een andere MCP-client) een connector toe met URL https://calio.nl/api/mcp. De client stuurt je naar Calio, je logt in, je ziet op één scherm wat de assistent mag, en je klikt op toestaan — een sleutel kopiëren hoeft niet. Vanaf dat moment kan de assistent je beschikbaarheid zien en afspraken boeken of annuleren. Intrekken doe je bij Integraties; de koppeling stopt dan direct.
Wat kan de AI-assistent precies — en wat niet?
De assistent kan afspraaktypes en vrije sloten opvragen, boeken, boekingen inzien en annuleren. Hij kan niet bij de inhoud van je agenda of je accountinstellingen: de API geeft alleen boekingsdata vrij, binnen jouw organisatie.
Hoe werkt de OAuth-koppeling precies?
Calio volgt de autorisatiespec van MCP: OAuth 2.1 met verplichte PKCE (S256) en dynamische clientregistratie (RFC 7591), zodat een connector zich zonder tussenkomst kan aanmelden. De metadata staat op /.well-known/oauth-protected-resource en /.well-known/oauth-authorization-server. Een access-token is een uur geldig en wordt met een refresh-token vernieuwd, dat bij elk gebruik roteert. De toestemming hangt aan de persoon die hem gaf, binnen zijn organisatie: gaat die persoon weg, dan vervalt de koppeling mee. Wij geven geen client secrets uit — een MCP-client draait op de machine van de gebruiker en kan daar niets geheim houden; PKCE doet dat werk.
Werkt de API ook meertalig?
Ja. Vraag je afspraaktypes op met ?locale=nl, en of de (in MCP: de parameter language), dan krijg je titel, omschrijving en de eigen vragen in die taal terug — waar de host een vertaling heeft ingevuld; anders zijn eigen tekst. Bij het boeken bepaalt hetzelfde veld in welke taal je gast zijn bevestigings- en herinneringsmails krijgt. Bij een keuzevraag stuur je altijd de waarde uit options terug, niet de vertaalde weergave: zo blijven antwoorden van gasten in verschillende talen vergelijkbaar.
Is dit veilig?
Elke sleutel en elke koppeling is aan jouw organisatie gebonden en op elk moment intrekbaar; van sleutels en tokens bewaren we alleen een hash. Alle data blijft op Europese infrastructuur. Trek een sleutel of een koppeling in en de toegang stopt direct — ook de refresh-tokens die eronder hangen. Wie wat gekoppeld en ontkoppeld heeft, staat in het audit log.
Wat kost de API?
De API en MCP-server zijn tijdens de beta voor alle accounts beschikbaar zonder extra kosten. Fair-use geldt; limieten per plan volgen bij de betaalde plannen.
Jouw agenda, met een AI-assistent erop
Gratis plan, API-sleutel in één klik, data in Europa.
Start gratis