Cómo conectar Cal.com a Claude vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Cal.com, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Cal.com + Claude

Lee una cuenta de agenda de Cal.com desde Claude, ChatGPT o Copilot: tipos de evento, reservas con asistentes, grabaciones y transcripciones de Cal Video, huecos libres, horarios de disponibilidad y calendarios conectados. Reservar, reprogramar y cancelar están incluidos pero se instalan desactivados.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

CALCOM_API_HOST, CALCOM_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Cal.com (cualquier plan) para crear una clave de API personal. La clave actúa como el usuario que la creó.

1. Inicia sesión en Cal.com y abre Settings → Developer → API Keys (en app.cal.com, o en app.cal.eu si tu cuenta está en la región UE de Cal.com).
2. Haz clic en New, ponle un nombre a la clave (por ejemplo AnythingMCP) y una caducidad, y cópiala. Empieza por cal_live_ (o cal_test_ en modo de prueba) y solo se muestra una vez.
3. Pega solo la clave, sin la palabra Bearer, en CALCOM_API_KEY.
4. Pon en CALCOM_API_HOST el valor https://api.cal.com si entras por app.cal.com, o https://api.cal.eu si entras por app.cal.eu. Escríbelo sin /v2, sin ruta y sin barra final: el conector añade /v2 por su cuenta. Una clave solo funciona en su propia región.
5. Instala el conector y ejecuta calcom_get_me: muestra el usuario al que pertenece la clave, con su zona horaria y su horario predeterminado, y confirma que clave y host encajan.

De quién son los datos: los tipos de evento, reservas y horarios del dueño de la clave, más las reservas de equipo en las que ese usuario es anfitrión o admin. Todos los que usan el conector trabajan con esa única cuenta, así que usa la clave de la persona (o del admin del equipo) cuyas reuniones debe ver la IA.

Qué lee: tus tipos de evento (las plantillas de reunión reservables) con duración, ubicaciones, campos de reserva, tiempos de margen, antelación mínima y enlace de reserva; reservas con estado, horas, enlace de la reunión, anfitriones, asistentes con email y zona horaria, invitados y respuestas a las preguntas de reserva; las grabaciones y transcripciones de Cal Video de una reserva; los huecos libres de un tipo de evento; tus horarios de disponibilidad con horas semanales y excepciones por fecha; y los calendarios conectados (Google, Outlook, Apple, CalDAV), incluidos los que se revisan para detectar conflictos y aquel en el que se escriben las reservas nuevas.

La uid de la reserva, no el id: las herramientas de reservas usan la uid, una cadena que la IA obtiene de calcom_list_bookings, no el id numérico. La uid de una reserva recurrente devuelve todas sus repeticiones. Las reservas se filtran por estado (upcoming, past, cancelled, unconfirmed), asistente, tipo de evento, equipo o fechas, y llegan por páginas.

Zonas horarias: los huecos libres vuelven en la zona horaria en la que piensas tú, que la IA pasa a calcom_get_available_slots, mientras que las horas de inicio de las reservas se envían a Cal.com en UTC. Los huecos ya tienen en cuenta tus calendarios, márgenes, antelación mínima y límites.

Grabaciones y transcripciones: solo existen en reuniones de Cal Video, y solo el organizador, un admin del equipo o un admin de la organización puede leerlas. Las reuniones en Zoom, Google Meet o Teams no tienen aquí. Hay transcripción cuando alguien pulsó Transcribe durante la llamada, y su enlace de descarga dura una hora, así que la IA pide uno nuevo cuando hace falta.

Desactivadas al instalar: calcom_create_booking, calcom_reschedule_booking y calcom_cancel_booking. Envían emails a asistentes reales y cambian calendarios reales: una reserva nueva manda confirmaciones e invitaciones (los tipos de evento de pago pueden pedir al asistente que pague), reprogramar cancela la reserva antigua y crea una nueva con otra uid, y una cancelación no se puede deshacer (en una reserva recurrente cancela todas las repeticiones). Un administrador puede activarlas una a una.

Pregunta antes de cada cambio: con una herramienta de escritura activada, la IA primero comprueba la hora con calcom_get_available_slots, después te muestra el tipo de evento, la hora en tu zona, el asistente y los invitados o el motivo, y espera tu sí.

Límites: Cal.com permite unas 120 peticiones por minuto por clave de API. Tras un 429 la IA espera un minuto antes de reintentar.

Errores comunes: 401 Invalid API Key significa que la clave es incorrecta, ha caducado o se borró, o que pertenece a la otra región. 403 indica que la clave funciona pero este usuario no ve esa reserva, ese tipo de evento o ese equipo: usa la clave del organizador o de un admin del equipo. 404 suele indicar que se usó un id numérico donde hacía falta la uid de la reserva. Con 400 Cal.com nombra el campo que no aceptó, a menudo una hora de inicio que no es un hueco libre.

El conector no cambia tipos de evento, horarios de disponibilidad ni calendarios conectados, y no cobra ni reembolsa pagos.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Claude

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Cal.com, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué reuniones tengo mañana y quién asiste a cada una?"
• "Búscame tres huecos libres la semana que viene para mi tipo de evento Llamada de presentación, en hora de Madrid, para ofrecérselos a un cliente."
• "Saca la transcripción de la llamada de ayer con García y Asociados y haz una lista de las tareas que acordamos."
• "¿Qué reservas se cancelaron o reprogramaron este mes y qué motivos dio la gente?"
• "¿Cuál es mi horario de trabajo en el horario predeterminado y qué calendarios revisa Cal.com para evitar conflictos?"

FAQ

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

• Página del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse