Cal.com MCP

oficial

Conecta clientes de IA con la programación de Cal.com a través del Protocolo de Contexto del Modelo usando el servidor alojado en mcp.cal.com o una instancia local.

Ver en cal.comPrueba este MCPPatrocinado

¿Qué puedes hacer con Cal Com MCP?

Revisa tus reservas — Consulta reservas próximas o pasadas usando get_bookings con filtros de fecha o estado.
Gestiona tipos de eventos — Crea, actualiza o elimina tipos de eventos mediante create_event_type, update_event_type y delete_event_type.
Encuentra espacios disponibles — Recupera franjas horarias libres con get_availability o verifica períodos ocupados con get_busy_times.
Reagenda o cancela reuniones — Modifica reservas existentes usando reschedule_booking o cancel_booking.
Visualiza y edita horarios — Lista, crea o actualiza tus horarios de disponibilidad con get_schedules y herramientas relacionadas.
Gestiona asistentes a reservas — Visualiza asistentes con get_booking_attendees o agrega a alguien mediante add_booking_attendee.

Documentación

Servidor MCP

Conecta clientes de IA a la programación de Cal.com a través del Protocolo de Contexto de Modelo usando el servidor alojado en mcp.cal.com o una instancia local.

El servidor MCP de Cal.com envuelve la API v2 de Cal.com en el Protocolo de Contexto de Modelo, permitiéndote gestionar reservas, tipos de evento, horarios y más mediante lenguaje natural en cualquier cliente compatible con MCP.

Servidor alojado (mcp.cal.com)

La forma más rápida de empezar es conectar tu cliente MCP directamente a mcp.cal.com. El servidor alojado usa transporte HTTP con streaming y autenticación OAuth 2.1 — tu cliente gestiona el flujo de autorización automáticamente.

Conecta tu cliente

Dirige tu cliente MCP a la URL del servidor alojado:

https://mcp.cal.com/mcp

Cuando te conectas por primera vez, tu cliente te guía a través de un flujo de autorización OAuth donde concedes al servidor acceso a tu cuenta de Cal.com. No se necesita clave API.

Añade lo siguiente a tu `claude_desktop_config.json`:

* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

Abre **Configuración → MCP** y añade un nuevo servidor con la URL `https://mcp.cal.com/mcp`, o añádelo a tu `.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

Añade el servidor a tu configuración de MCP de VS Code:

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

Servidor autogestionado (stdio)

Si prefieres ejecutar el servidor localmente, puedes usar el transporte stdio con una clave API. Esto es útil para desarrollo o cuando quieres control total sobre el servidor.

Requisitos previos

Node.js >= 18
Una clave API de Cal.com — genera una en Configuración → Desarrollador → Claves API

Conecta tu cliente

Añade lo siguiente a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "calcom": {
      "command": "npx",
      "args": ["@calcom/cal-mcp@latest"],
      "env": {
        "CAL_API_KEY": "cal_live_xxxx"
      }
    }
  }
}

Reemplaza cal_live_xxxx con tu clave API real.

Nunca compartas ni subas a un repositorio tu clave API. Si se expone, rótala inmediatamente en tu [configuración de Cal.com](https://app.cal.com/settings/developer/api-keys).

Herramientas disponibles

El servidor MCP expone 34 herramientas organizadas por categoría:

Perfil de usuario

Herramienta	Descripción
`get_me`	Obtiene tu perfil de usuario autenticado
`update_me`	Actualiza tu perfil de usuario

Tipos de evento

Herramienta	Descripción
`get_event_types`	Lista todos los tipos de evento
`get_event_type`	Obtiene un tipo de evento específico por ID
`create_event_type`	Crea un nuevo tipo de evento
`update_event_type`	Actualiza un tipo de evento
`delete_event_type`	Elimina un tipo de evento

Reservas

Herramienta	Descripción
`get_bookings`	Lista reservas con filtros opcionales
`get_booking`	Obtiene una reserva específica por UID
`create_booking`	Crea una nueva reserva
`reschedule_booking`	Reprograma una reserva
`cancel_booking`	Cancela una reserva
`confirm_booking`	Confirma una reserva pendiente
`mark_booking_absent`	Marca una ausencia en la reserva
`get_booking_attendees`	Obtiene todos los asistentes de una reserva
`add_booking_attendee`	Añade un asistente a una reserva
`get_booking_attendee`	Obtiene un asistente específico

Horarios

Herramienta	Descripción
`get_schedules`	Lista todos los horarios
`get_schedule`	Obtiene un horario específico por ID
`create_schedule`	Crea un nuevo horario
`update_schedule`	Actualiza un horario
`delete_schedule`	Elimina un horario
`get_default_schedule`	Obtiene tu horario por defecto

Disponibilidad

Herramienta	Descripción
`get_availability`	Obtiene franjas horarias disponibles
`get_busy_times`	Obtiene horas ocupadas de los calendarios

Conferencias

Herramienta	Descripción
`get_conferencing_apps`	Lista aplicaciones de conferencia

Formularios de enrutamiento

Herramienta	Descripción
`calculate_routing_form_slots`	Calcula franjas basadas en la respuesta del formulario de enrutamiento

Organizaciones

Herramienta	Descripción
`get_org_memberships`	Obtiene todas las membresías de la organización
`create_org_membership`	Crea una membresía de organización
`get_org_membership`	Obtiene una membresía de organización
`delete_org_membership`	Elimina una membresía de organización
`get_org_routing_forms`	Obtiene formularios de enrutamiento de la organización
`get_org_routing_form_responses`	Obtiene respuestas del formulario de enrutamiento

Ejemplos de prompts

Una vez conectado, puedes interactuar con Cal.com usando lenguaje natural:

"¿Qué reservas tengo esta semana?"
"Crea un tipo de evento de 30 minutos llamado 'Charla rápida'"
"Cancela mi reunión con Juan mañana"
"Muéstrame mis franjas disponibles para el próximo lunes"
"Reprograma mi reunión de las 2pm para el jueves a las 3pm"
"¿Qué tipos de evento tengo?"

Recursos relacionados

Guía de agentes de IA — construye agentes de IA usando la API de Cal.com directamente
Referencia de API v2 — documentación completa de los endpoints de la API
Repositorio de GitHub — código fuente