helios-calcom-mcp
Provides tools to manage Cal.com bookings: get available slots, create, reschedule, and cancel bookings.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@helios-calcom-mcpget available slots for next Monday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseAqualityDmaintenanceAn MCP server that enables scheduling, updating, deleting, and listing calendar appointments through Cal.com's Calendar API.43
- AlicenseAqualityCmaintenanceEnables interaction with Calendly's scheduling platform via MCP, allowing users to manage events, invitees, and schedule meetings directly using the Calendly API.121159MIT
- Alicense-qualityDmaintenanceMCP server providing a standardized interface for interacting with Calendly's scheduling and event management tools.6MIT
- Flicense-qualityDmaintenanceMCP 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.
Related MCP Connectors
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.
AI-native scheduling: check availability, book meetings, cancel and reschedule via MCP
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/davidjmb99/helios-calcom-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server