Kalendrio MCP Server

The agent-native scheduling layer for Kalendrio.

Give agents a clean way to access availability, book meetings, inspect connected calendars, and manage scheduling workflows without scraping the UI or guessing how your API works.

Public booking

Inspect event types, dates, and slots

Bearer auth

Use agent tokens instead of browser cookies

Remote ready

Run over stdio or hosted Streamable HTTP

Agent Flow

From intent to booked meeting

1

Inspect event type

Load booking rules, host info, duration, and custom questions.

2

Find availability

List viable dates, then fetch exact bookable time slots.

3

Create booking

Book the selected slot with invitee details and source metadata.

4

Manage follow-through

Inspect, cancel, or reschedule bookings using authenticated tools.

Agent-native, not API-native

Kalendrio MCP is shaped around tasks like finding slots and booking meetings, not around raw tables or undocumented request bodies.

Safe by design

Public scheduling tools remain lightweight, while host tools are explicitly authenticated and easy to permission later.

Built for workflows

A single agent can inspect an event type, find a valid slot, and complete a booking without leaving the MCP surface.

Easy to ship

The server starts with stdio transport and wraps existing Kalendrio routes, which keeps V1 fast to implement and test.

Tooling

A task API for agents

Kalendrio MCP should feel like a scheduling teammate. That means verbs, outcomes, and safe schemas instead of raw infrastructure. Agents should call tools that match their job to be done.

Public tools support lead booking flows without a host login.
Host tools let agents inspect calendars, bookings, and event types with explicit authentication.
Agent tokens let MCP clients authenticate with `Authorization: Bearer ...` instead of UI cookies.
The same tool surface now runs over stdio and hosted Streamable HTTP without changing the mental model.
get_public_event_type

Load the public booking page definition for a host and slug.

list_available_dates

Find dates that still have booking capacity in a target timezone.

list_time_slots

Return actual bookable slots for a specific date.

create_booking

Book a meeting once the invitee details are known.

explain_availability

Tell an agent why a date is or is not workable, and what to do next.

list_bookings

Give an authenticated host a clean view of upcoming or past bookings.

What agents unlock

Sales agents can qualify inbound leads and book the right demo instantly.

Executive assistant agents can reschedule founder calls without UI scraping.

Support agents can inspect bookings and calendar health during troubleshooting.

Ops agents can create event types and orchestrate routing workflows.

V1 Shape

Initial MCP package

mcp/kalendrio-mcp/

src/server.ts

src/tools/public-tools.ts

src/tools/host-tools.ts

src/lib/kalendrio-client.ts

README.md

Start with stdio for local agent runtimes or run the same server over hosted Streamable HTTP for remote clients and automation platforms.

Pitch Summary

Kalendrio MCP is the scheduling control plane that makes calendars and booking flows usable by agents.

It turns Kalendrio from a web product with routes into a tool surface agents can safely understand: availability lookup, booking creation, booking management, calendar visibility, and workflow-ready scheduling automation.