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"
}
}'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.
Latest Blog Posts
- 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