Integración con Claude Code

Claude Code es el agente de programación de Anthropic para el terminal. Con el plugin de Timesheet instalado puede iniciar y detener temporizadores, registrar el trabajo que acabas de terminar y responder preguntas sobre en qué se han ido tus horas, sin que cambies de ventana.

Qué puedes pedirle

• «Inicia el temporizador del proyecto de la API»
• «Detén el temporizador y añade una nota: corregido el error de inicio de sesión»
• «¿En qué trabajé ayer?»
• «Registra 2 horas del lunes en el proyecto de la app móvil»
• «Exporta el mes pasado en Excel y mándaselo a mi gestor»

Antes de empezar

• Un plan Timesheet Pro o superior. Consulta planes y precios.
• Una clave de API de Timesheet, creada en la aplicación web en Integraciones > Claves de API.
• Node.js 18 o superior.

Instalar el plugin

Ejecuta estos dos comandos dentro de una sesión de Claude Code:

/plugin marketplace add timesheetIO/timesheet-plugin
/plugin install timesheet@timesheet

El plugin incluye una skill que documenta todos los grupos de comandos de @timesheet/cli, así que Claude Code conoce los flags y los flujos exactos en lugar de tener que adivinarlos.

Después instala la CLI que usa el plugin e inicia sesión una vez:

npm install -g @timesheet/cli
timesheet auth login

timesheet auth login usa OAuth 2.1 con PKCE y abre el navegador. Para automatizaciones y CI, configura mejor una clave de API:

export TIMESHEET_API_KEY=ts_your.apikey
timesheet auth status --json

O conéctalo mediante MCP

Si prefieres que Claude Code llame a herramientas tipadas en lugar de ejecutar comandos de shell, añade el servidor MCP de Timesheet a ~/.claude/settings.json:

{
  "mcpServers": {
    "timesheet": {
      "command": "npx",
      "args": ["@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Ambas vías llegan a la misma cuenta. El plugin encaja con flujos de shell y salida para scripts; el servidor MCP encaja con asistentes que prefieren llamadas estructuradas a herramientas.

Usar la skill sin el plugin

La CLI incluye el mismo archivo de skill, así que cualquier agente compatible con skills puede cargarlo:

timesheet skill path      # comprueba dónde se escribiría
timesheet skill install   # lo escribe en el directorio de skills del agente

Conviene saber

• Todos los comandos de lectura aceptan --json, así que la salida sigue siendo procesable por máquina. Si la rediriges a otro comando, cambia a TSV automáticamente.
• El código de salida 3 significa que la sesión tiene que volver a autenticarse.
• Tu clave de API da acceso completo a tu cuenta. No la subas nunca al control de versiones. Para revocar el acceso, elimina la clave en Integraciones > Claves de API.