toggl-mcp

MCP server para Toggl Track. Permite gestionar entradas de tiempo, proyectos, tags y reportes directamente desde Claude.

Requisitos

• Node.js 18 o superior
• Claude Desktop o Claude Code

1. Obtener tu Toggl API Token

1. Ve a toggl.com → Profile (esquina inferior izquierda)
2. Profile settings → API Token (al fondo de la página)
3. Copia el token

2. Configurar Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "toggl": {
      "command": "npx",
      "args": ["-y", "@tonyakitori/toggl-mcp@latest"],
      "env": {
        "TOGGL_API_TOKEN": "TU_API_TOKEN_AQUI"
      }
    }
  }
}

Reinicia Claude Desktop (Cmd+Q y vuelve a abrir).

3. Configurar Claude Code

claude mcp add toggl \
  -e TOGGL_API_TOKEN=TU_API_TOKEN_AQUI \
  -- npx -y @tonyakitori/toggl-mcp

4. Herramientas disponibles

Entradas de tiempo

| Tool | Descripción | |------|-------------| | get_running_timer | Ver si hay un timer activo | | start_timer | Iniciar un timer ahora | | stop_timer | Detener el timer activo | | create_time_entry | Crear entrada con fecha/hora específica | | update_time_entry | Editar descripción, fechas, proyecto, tags o billable | | delete_time_entry | Eliminar una entrada | | list_time_entries | Listar entradas por rango de fechas |

Proyectos

| Tool | Descripción | |------|-------------| | list_projects | Ver todos los proyectos | | update_project | Editar nombre, color, tarifa o estado |

Tags

| Tool | Descripción | |------|-------------| | list_tags | Ver todos los tags | | create_tag | Crear un tag | | update_tag | Renombrar un tag | | delete_tag | Eliminar un tag |

Reportes

| Tool | Descripción | |------|-------------| | list_saved_reports | Listar todos los reportes guardados en el workspace | | date_range_report | Resumen de horas por proyecto en un rango (plan Starter o superior) | | billing_report | Revenue por proyecto en un rango (plan Starter o superior) | | run_saved_report | Ejecutar un reporte guardado por ID (plan Starter o superior) |

5. Ejemplos de uso en Claude

¿Tengo algún timer corriendo ahora?
Inicia un timer para "Revisión de PR en proyecto Alpha"
Crea una entrada de ayer de 10:00 a 12:30 para "Reunión de sprint"
¿Cuántas horas trabajé esta semana?
Dame el reporte de junio por proyecto
¿Cuánto voy a cobrar este mes?
¿Cuáles reportes tengo guardados en Toggl?
Ejecuta mi reporte guardado de facturación mensual

Variables de entorno opcionales

| Variable | Descripción | |----------|-------------| | TOGGL_API_TOKEN | Requerido. Tu API token de Toggl | | TOGGL_WORKSPACE_ID | Opcional. Si tienes múltiples workspaces |