Clockify MCP

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