MCP

caldav-mcp: conecta tus calendarios CalDAV a un asistente de IA

Ideal para quien ya tiene una cuenta en un servidor CalDAV y quiere que un asistente de IA consulte y gestione sus calendarios. Requiere URL del servidor, usuario y contraseña; crear, actualizar y eliminar escriben directamente en el calendario en línea, así que confirma antes de cada acción.

Official source · caldav-mcp

Install

"command": "npx",
      "args": [
        "caldav-mcp"
      ],

Para quién es

  • Para quienes ya tienen una cuenta en un servidor CalDAV (autoalojado o de un proveedor) y quieren que un asistente de IA consulte y gestione sus calendarios directamente. El posicionamiento oficial es exponer las operaciones de calendario como herramientas para asistentes de IA.
  • Las operaciones cubiertas: conectarse a un servidor CalDAV, listar calendarios, listar los eventos de un calendario en un intervalo de tiempo, crear eventos, actualizar eventos y eliminar eventos por UID.
  • Los requisitos son claros: hay que facilitar la URL del servidor CalDAV, el usuario y la contraseña mediante las tres variables de entorno CALDAV_BASE_URL, CALDAV_USERNAME y CALDAV_PASSWORD; las tres son imprescindibles.
  • No es para: quien no tenga un servidor CalDAV o no quiera entregar sus credenciales a un proceso local. La documentación oficial no indica con qué implementaciones concretas de servidores CalDAV es compatible, ni si ofrece un modo de solo lectura; ambos puntos quedan sin confirmar.

Primer intento en 3 minutos

Camino principal recomendado: arrancarlo con npx en la configuración mcpServers del cliente MCP; npx descarga y ejecuta automáticamente el paquete caldav-mcp. Añade este fragmento a la configuración:

"command": "npx",
      "args": [
        "caldav-mcp"
      ],

y aporta las credenciales en la misma configuración mediante variables de entorno:

"CALDAV_BASE_URL": "<CalDAV server URL>",
        "CALDAV_USERNAME": "<CalDAV username>",
        "CALDAV_PASSWORD": "<CalDAV password>"

Tras guardar y reiniciar el cliente, haz primero una llamada de lectura: pide al asistente de IA «lista mis calendarios», lo que corresponde a List calendars en la lista oficial de capacidades. La señal de éxito es que el asistente devuelva la lista de calendarios de esa cuenta. Este paso solo lee la estructura del calendario, sin crear ni modificar eventos, pero se conecta al servidor CalDAV con tus credenciales.

Aviso imprescindible: crear, actualizar y eliminar son escrituras remotas que modifican directamente el calendario en línea. Antes de cualquier escritura, pide al asistente que repita la operación prevista, el evento objetivo y los campos, y ejecuta solo tras tu confirmación.

El proyecto ofrece además una vía orientada al desarrollo: ejecutar el código TypeScript directamente en modo watch y cargar las variables de entorno desde .env automáticamente; sirve para depurar, mientras que el uso diario debe seguir el camino npx de arriba.

Casos de uso

Caso 1: verificar conexión y permisos (List calendars). Situación: acabas de configurar las credenciales y no estás seguro de la URL o la contraseña. Método: pide al asistente «lista mis calendarios», la acción de lectura más barata para validar las credenciales. Resultado esperado: la lista de calendarios de esa cuenta CalDAV; si falla, revisa las tres variables de entorno y reintenta.

Caso 2: cambiar solo los campos necesarios con update-event. Situación: una reunión cambia de hora, pero el título, el lugar y el resto no varían. Método: haz que el asistente localice el evento objetivo y llame a update-event facilitando solo los campos a modificar; la descripción oficial dice: «Actualiza un evento de calendario existente. Solo se modifican los campos facilitados.». Resultado esperado: solo se actualizan los campos que facilites, el resto queda igual. Punto de confirmación: es una escritura remota que impacta directamente en el servidor CalDAV; comprueba sin falta el evento objetivo y los campos a cambiar antes de ejecutar.

Límites de uso

  • Naturaleza lectura/escritura: las capacidades combinan lectura (listar calendarios, listar eventos de un periodo) y escritura (crear, actualizar, eliminar por UID); las herramientas actúan directamente sobre el calendario en línea. El borrado se hace por UID y la documentación oficial no explica si un evento borrado puede recuperarse ni ofrece vía de deshacer, así que sé especialmente estricto en el paso de confirmación.
  • Requisitos de credenciales: URL del servidor, usuario y contraseña deben facilitarse por variables de entorno; no está documentado si se admiten autenticaciones alternativas como OAuth o contraseñas de aplicación — sin confirmar.
  • Efectos secundarios y puntos de confirmación: las escrituras modifican de verdad el calendario del servidor; update-event solo cambia los campos facilitados, los campos no mencionados quedan intactos.
  • Otros puntos sin confirmar: la lista de software de servidor CalDAV compatible y los límites de tasa o concurrencia no están documentados. «No documentado» solo describe el alcance de la documentación y no constituye conclusión de seguridad alguna.