Servidor MCP de Clockify

Este servidor MCP permite que los LLM (como Cursor o Claude) interactúen con su espacio de trabajo de Clockify, lo que permite la automatización avanzada del seguimiento del tiempo y la generación de informes. Con este servidor, puede:

• Enumere todos los proyectos en su espacio de trabajo

• Enumere todos los usuarios en su espacio de trabajo

• Agregue y busque entradas de tiempo para usted o cualquier usuario (si tiene permisos)

• Extraer hojas de horas de cualquier usuario en todos los proyectos

• Genere desgloses de fechas mensuales o personalizados de horas por usuario y proyecto utilizando la API de informes de resumen de Clockify

• Integre con LLM para automatizar, resumir o analizar sus datos de seguimiento de tiempo

Características

• listProjects: enumera todos los proyectos del usuario autenticado

• getTimeEntries: enumera las entradas de tiempo del usuario autenticado (con filtros de fecha opcionales)

• addTimeEntry: Agregar entradas de tiempo a un proyecto

• listUsers: enumera todos los usuarios en el espacio de trabajo

• getUserTimeEntries: enumera las entradas de tiempo de cualquier usuario (con filtros de fecha opcionales)

• getSummaryReport: Obtiene un informe resumido de horas por usuario/proyecto para un rango de fechas (opcionalmente, se puede filtrar por ID de usuario/ID de proyecto). Permite desgloses mensuales/por hora para cualquier usuario o proyecto.

Inicio rápido (Docker: Preferible)

Configuración del servidor MCP para Cursor/Claude

Agregue lo siguiente a su archivo Cursor o Claude settings.json (reemplace YOUR_API_KEY ):

Cómo obtener una clave API de Clockify

1. Inicie sesión en su cuenta de Clockify .

2. Haz clic en el icono de tu perfil (arriba a la derecha) y selecciona Perfil .

3. Desplácese hacia abajo hasta la sección API .

4. Haga clic en Generar si no tiene una clave API o copie su clave existente.

Contribución y CI/CD

Este proyecto utiliza GitHub Actions para crear y publicar automáticamente la imagen de Docker en GitHub Container Registry (GHCR) en cada envío a main .

• URL de la imagen: ghcr.io/inakianduaga/clockify-mcp:latest

• Cómo extraer la imagen:

  docker pull ghcr.io/inakianduaga/clockify-mcp:latest

Puedes ver las imágenes publicadas en la sección "Paquetes" de tu perfil o repositorio de GitHub.

Banco de memoria y optimizaciones

El desarrollo se realizó con cursor y reglas optimizadas. Véase: https://github.com/Bhartendu-Kumar/rules\_template

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.