Cal.com MCP

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.

Conectar 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 **Ajustes → 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 tus ajustes de MCP de VS Code:

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

Servidor autoalojado (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 Ajustes → Desarrollador → Claves API

Conectar 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 queda expuesta, rótala inmediatamente en tus [ajustes 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	Obtener tu perfil de usuario autenticado
update_me	Actualizar tu perfil de usuario

Tipos de evento

Herramienta	Descripción
get_event_types	Listar todos los tipos de evento
get_event_type	Obtener un tipo de evento específico por ID
create_event_type	Crear un nuevo tipo de evento
update_event_type	Actualizar un tipo de evento
delete_event_type	Eliminar un tipo de evento

Reservas

Herramienta	Descripción
get_bookings	Listar reservas con filtros opcionales
get_booking	Obtener una reserva específica por UID
create_booking	Crear una nueva reserva
reschedule_booking	Reprogramar una reserva
cancel_booking	Cancelar una reserva
confirm_booking	Confirmar una reserva pendiente
mark_booking_absent	Marcar una ausencia en la reserva
get_booking_attendees	Obtener todos los asistentes de una reserva
add_booking_attendee	Añadir un asistente a una reserva
get_booking_attendee	Obtener un asistente específico

Horarios

Herramienta	Descripción
get_schedules	Listar todos los horarios
get_schedule	Obtener un horario específico por ID
create_schedule	Crear un nuevo horario
update_schedule	Actualizar un horario
delete_schedule	Eliminar un horario
get_default_schedule	Obtener tu horario por defecto

Disponibilidad

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

Conferencias

Herramienta	Descripción
get_conferencing_apps	Listar aplicaciones de conferencia

Formularios de enrutamiento

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

Organizaciones

Herramienta	Descripción
get_org_memberships	Obtener todas las membresías de organización
create_org_membership	Crear una membresía de organización
get_org_membership	Obtener una membresía de organización
delete_org_membership	Eliminar una membresía de organización
get_org_routing_forms	Obtener formularios de enrutamiento de la organización
get_org_routing_form_responses	Obtener respuestas de formularios 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 'Chat rápido'"
• "Cancela mi reunión con John 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