mcp-server-toggl

jgraue-fortinet/mcp-server-toggl

3.2

If you are the rightful owner of mcp-server-toggl and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Toggl MCP Server v2.0 is designed for advanced reporting, time analysis, and automatic rounding of hours, making it ideal for billing and productivity evaluation.

Tools
4
Resources
0
Prompts
0

Toggl MCP Server v2.0 - Reportes y Análisis

Un servidor MCP (Model Context Protocol) para Toggl Track con enfoque en reportes, análisis de tiempo y redondeo automático de horas. Perfecto para facturación y evaluación de productividad.

🎯 Características Principales

📊 Reportes Avanzados

  • Reportes Resumen: Agregación de tiempo por proyectos, clientes, usuarios o tags
  • Reportes Detallados: Vista completa de cada entrada individual
  • Reportes Semanales: Análisis en períodos de 7 días
  • Reportes por Proyecto: Análisis específico de proyectos seleccionados

⏱️ Redondeo Inteligente de Tiempo

  • Redondea tiempos a 15, 30 o 60 minutos
  • Tres métodos de redondeo:
    • Hacia arriba (ceiling): 1:40 → 2:00
    • Hacia abajo (floor): 1:40 → 1:30
    • Al más cercano (nearest): 1:40 → 2:00, 1:20 → 1:30
  • Calcula automáticamente las diferencias totales

📈 Análisis de Utilización

  • Distribución de tiempo por proyecto (con porcentajes)
  • Distribución por tags
  • Estadísticas de entradas
  • Visualización clara de cómo se usa el tiempo

📄 Exportación

  • Exporta reportes a formato CSV
  • Listo para importar en hojas de cálculo

🚀 Instalación Rápida

# Crear proyecto
mkdir toggl-mcp-server
cd toggl-mcp-server

# Crear estructura
mkdir src

# Copiar los archivos:
# - src/index.ts (código del servidor)
# - package.json
# - tsconfig.json

# Instalar dependencias
npm install

# Compilar
npm run build

🔑 Configuración

1. Obtener API Token

  1. Ve a Toggl Track
  2. Profile settings → API Token
  3. Copia tu token

2. Configurar Claude Desktop

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

{
  "mcpServers": {
    "toggl": {
      "command": "node",
      "args": ["/ruta/completa/a/toggl-mcp-server/dist/index.js"],
      "env": {
        "TOGGL_API_TOKEN": "tu_api_token_aqui"
      }
    }
  }
}

Reinicia Claude Desktop.

📚 Herramientas Disponibles

📊 Reportes

get_summary_report

Reporte agregado con totales por proyecto, cliente o usuario.

Parámetros:
- workspace_id: ID del workspace
- start_date: Fecha inicio (YYYY-MM-DD)
- end_date: Fecha fin (YYYY-MM-DD)
- grouping: "projects" | "clients" | "users" | "time_entries"
get_detailed_report

Listado completo de todas las entradas de tiempo.

Parámetros:
- workspace_id: ID del workspace
- start_date: Fecha inicio (YYYY-MM-DD)
- end_date: Fecha fin (YYYY-MM-DD)
get_weekly_report

Reporte agregado en períodos de 7 días.

Parámetros:
- workspace_id: ID del workspace
- start_date: Fecha inicio (YYYY-MM-DD)
- end_date: Fecha fin (YYYY-MM-DD)
get_project_report

Análisis detallado de proyectos específicos.

Parámetros:
- workspace_id: ID del workspace
- project