helios-calcom-mcp
Provides tools to manage Cal.com bookings: get available slots, create, reschedule, and cancel bookings.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
helios-calcom-mcp
MCP wrapper controlado para conectar Cal.com con Hermes/Helios. Este servicio expone de manera segura y limitada un conjunto de herramientas de Cal.com API v2:
get_available_slotscreate_bookingreschedule_bookingcancel_booking
Variables de Entorno
Debes proveer las siguientes variables de entorno para que el servicio funcione:
NODE_ENV=production
PORT=3000
CALCOM_BASE_URL=https://api.cal.com
CALCOM_API_KEY=tu_api_key_de_calcom
CALCOM_EVENT_TYPE_ID=4494139
CALCOM_TIMEZONE=Europe/Madrid
CALCOM_MCP_TOKEN=token_secreto_para_autorizar_peticionesRelated MCP server: Calendly MCP Server
Ejecución con Docker
docker build -t helios-calcom-mcp .
docker run -p 3000:3000 --env-file .env helios-calcom-mcpEndpoints
GET /health
Comprueba el estado del servicio.
Ejemplo de uso:
curl http://localhost:3000/healthRespuesta:
{
"ok": true
}GET /debug/calcom-slots-test
Ruta de diagnóstico para verificar que la comunicación con Cal.com funciona de manera directa. Requiere autorización del MCP.
Ejemplo de uso:
curl http://localhost:3000/debug/calcom-slots-test -H "Authorization: Bearer tu_token_secreto_mcp"POST /mcp
Punto de entrada unificado para herramientas MCP. Requiere autorización.
Ejemplo de uso (get_available_slots):
curl -X POST http://localhost:3000/mcp \
-H "Authorization: Bearer tu_token_secreto_mcp" \
-H "Content-Type: application/json" \
-d '{
"tool": "get_available_slots",
"arguments": {
"date_from": "2026-08-01",
"date_to": "2026-08-07",
"timezone": "Europe/Madrid",
"event_type_id": "4494139"
}
}'
**Ejemplo de uso (create_booking):**
```bash
curl -X POST http://localhost:3000/mcp \
-H "Authorization: Bearer tu_token_secreto_mcp" \
-H "Content-Type: application/json" \
-d '{
"tool": "create_booking",
"arguments": {
"start_time": "2026-07-16T10:00:00.000+02:00",
"patient_first_name": "Juan",
"patient_last_name": "Perez",
"patient_email": "juan@email.com",
"patient_phone": "+584120000000",
"notes": "Primera visita"
}
}'
**Ejemplo de uso (cancel_booking):**
```bash
curl -X POST http://localhost:3000/mcp \
-H "Authorization: Bearer tu_token_secreto_mcp" \
-H "Content-Type: application/json" \
-d '{
"tool": "cancel_booking",
"arguments": {
"booking_uid": "mxJHrmKRPACaRBm3fMSqoL",
"reason": "Prueba técnica Helios Cal.com MCP"
}
}'
**Ejemplo de uso (reschedule_booking):**
```bash
curl -X POST http://localhost:3000/mcp \
-H "Authorization: Bearer tu_token_secreto_mcp" \
-H "Content-Type: application/json" \
-d '{
"tool": "reschedule_booking",
"arguments": {
"booking_uid": "daRbVeDLxSdS5eGK2KabAD",
"new_start_time": "2026-07-17T11:00:00.000+02:00",
"reason": "Prueba técnica Helios Cal.com MCP"
}
}'Respuestas de error por autenticación: Si falta el token o es incorrecto:
{
"error": "Unauthorized"
}(Status 401)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
WhatsApp® reminders and rescheduling for Calendly. Public read-only MCP endpoint.
Unofficial Calendly MCP Pack — wraps the Calendly API v2 for scheduling data.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables scheduling, updating, deleting, and listing calendar appointments through Cal.com's Calendar API.43MIT
- AlicenseAqualityDmaintenanceEnables interaction with Calendly's scheduling platform via MCP, allowing users to manage events, invitees, and schedule meetings directly using the Calendly API.1284 npm10MIT
- AlicenseNot gradedqualityDmaintenanceMCP server providing a standardized interface for interacting with Calendly's scheduling and event management tools.6MIT
- FlicenseBqualityDmaintenanceMCP server for Cal.com scheduling, providing ~70 tools to manage schedules, event types, bookings, calendars, webhooks, and teams. Enables natural language control of Cal.com from Claude or any MCP-compatible client.68-