Cal.com Calendar

Servidor MCP de Cal.com Calendar

Una implementación de servidor MCP que se integra con la API de Cal.com Calendar, proporcionando capacidades de programación de citas.

Características

• Agregar citas: Programe nuevas citas de calendario con detalles de los asistentes
• Actualizar citas: Modifique detalles de citas existentes, como hora y notas
• Eliminar citas: Cancele y elimine citas existentes
• Listar citas: Vea las citas programadas para rangos de fechas específicos

Herramientas

• calcom_add_appointment

  • Crear nuevas citas de calendario
  • Entradas:
    • eventTypeId (número): El ID del tipo de evento de Cal.com
    • startTime (cadena): Hora de inicio en formato ISO (YYYY-MM-DDTHH:mm:ss.sssZ)
    • endTime (cadena): Hora de finalización en formato ISO (YYYY-MM-DDTHH:mm:ss.sssZ)
    • name (cadena): Nombre del asistente
    • email (cadena): Correo electrónico del asistente
    • notes (cadena, opcional): Notas adicionales para la cita

• calcom_update_appointment

  • Actualizar citas de calendario existentes
  • Entradas:
    • bookingId (número): El ID de reserva de Cal.com a actualizar
    • startTime (cadena, opcional): Nueva hora de inicio en formato ISO
    • endTime (cadena, opcional): Nueva hora de finalización en formato ISO
    • notes (cadena, opcional): Nuevas notas para la cita

• calcom_delete_appointment

  • Eliminar citas de calendario existentes
  • Entradas:
    • bookingId (número): El ID de reserva de Cal.com a eliminar
    • reason (cadena, opcional): Motivo de la cancelación

• calcom_list_appointments

  • Listar citas de calendario en un rango de fechas
  • Entradas:
    • startDate (cadena): Fecha de inicio en formato YYYY-MM-DD
    • endDate (cadena): Fecha de finalización en formato YYYY-MM-DD

Configuración

Cómo obtener una clave de API

1. Regístrese para obtener una cuenta de Cal.com
2. Navegue a Configuración > Desarrollador > Claves de API
3. Genere una nueva clave de API con los permisos adecuados

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CALCOM_API_KEY",
        "mcp/calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "calcom-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-calcom-calendar"
      ],
      "env": {
        "CALCOM_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Compilación

Compilación de Docker:

docker build -t mcp/calcom-calendar:latest -f Dockerfile .

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.