Skip to main content
Glama
davidjmb99

helios-calcom-mcp

by davidjmb99

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:

  1. get_available_slots

  2. create_booking

  3. reschedule_booking

  4. cancel_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_peticiones

Related 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-mcp

Endpoints

GET /health

Comprueba el estado del servicio.

Ejemplo de uso:

curl http://localhost:3000/health

Respuesta:

{
  "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)

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

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