@anghelo-alva/timer-mcp

MCP server para Timer — time tracking para desarrolladores, conectado directamente a Claude Code.

Permite que Claude Code arranque, pare y registre tiempo en tus tareas automáticamente durante una sesión de desarrollo. En vez de cambiar de ventana para tocar un cronómetro, le decís a Claude "arrancá el timer en la tarea X" y listo.

Requisitos

• Node.js >= 20
• Una cuenta en Timer y una API key generada desde la web

Instalación

claude mcp add timer --scope user -e TIMER_API_KEY=<tu-api-key> -- npx -y @anghelo-alva/timer-mcp

Reemplazá <tu-api-key> por la key que generaste desde Timer web.

Verificá que quedó conectado:

claude mcp list

Deberías ver timer: ... - ✓ Connected.

Configuración manual (alternativa)

Si preferís editar tu ~/.claude.json a mano:

{
  "mcpServers": {
    "timer": {
      "command": "npx",
      "args": ["-y", "@anghelo-alva/timer-mcp"],
      "env": {
        "TIMER_API_KEY": "<tu-api-key>"
      }
    }
  }
}

Tools disponibles

| Tool | Qué hace | | --------------- | ----------------------------------------------------------------- | | start_timer | Arranca un cronómetro en una tarea | | stop_timer | Detiene el cronómetro activo y crea una entry | | active_timer | Devuelve el timer corriendo ahora (si hay alguno) | | switch_task | Cambia el timer activo a otra tarea (para y arranca atómicamente) | | log_time | Registra tiempo manualmente (inicio y fin explícitos) | | list_projects | Lista los proyectos del usuario | | list_tasks | Lista tareas, filtrable por proyecto o status | | create_task | Crea una tarea nueva dentro de un proyecto | | get_summary | Reporte agregado de tiempo por tarea o proyecto |

Resources

| Resource URI | Contenido | | ---------------------- | ----------------------- | | timer://active-timer | Estado del timer activo | | timer://today | Reporte de hoy | | timer://projects | Lista de proyectos |

Seguridad

Tu API key queda en texto plano en ~/.claude.json. Si la filtrás, revocala desde la web de Timer y generá una nueva. El paquete nunca loggea la API key.

Licencia

MIT