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.

Related MCP server: @lewinnovation/clockify-mcp-server

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 ):

{
  "mcpServers": {
    "clockify-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CLOCKIFY_API_KEY=<YOUR_API_KEY>",
        "ghcr.io/inakianduaga/clockify-mcp:latest"  
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

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.