Clockify Timer MCP Server

Servidor MCP mínimo para gestionar temporizadores de Clockify. Inicia/detiene temporizadores, comprueba qué está en ejecución y consulta las entradas recientes, todo a través de Claude.

Herramientas

Configuración

1. Obtén tu token de API de Clockify

Ve a Configuración del perfil de Clockify → desplázate hasta "API" → genera o copia tu clave de API.

2. Configura Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "clockify": {
      "command": "npx",
      "args": ["tsx", "/ABSOLUTE/PATH/TO/clockify-mcp/src/index.ts"],
      "env": {
        "CLOCKIFY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

3. Úsalo

• "Inicia un temporizador para el trabajo de refactorización de API"

• "¿Qué temporizador está en ejecución ahora mismo?"

• "Detén el temporizador"

• "Muestra mis últimas 5 entradas de tiempo"

• "Empieza a registrar la preparación de la reunión, facturable, en el proyecto Acme"

Notas de seguridad

• Sin estado mutable compartido — la configuración del cliente es inmutable, sin singletons globales

• Todos los IDs de Clockify validados contra el patrón hexadecimal de 24 caracteres antes de la interpolación de URL (evita el recorrido de rutas)

• Sin axios — usa fetch nativo, cero vulnerabilidades de dependencias HTTP

• Saneamiento de errores — los errores de API se truncan y nunca filtran cabeceras de autenticación

• Fallo rápido — sale inmediatamente si falta el token de API

• 0 vulnerabilidades de npm audit en el momento de la creación