Skip to main content
Glama
deenesjakoruzh
ficus33

TrackingTime MCP Server

by ficus33
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Servidor MCP de TrackingTime

Un servidor MCP (Model Context Protocol) que conecta asistentes de IA como Claude a la API v4 de TrackingTime. Gestiona proyectos, tareas, seguimiento de tiempo, asignaciones de personal y clientes mediante lenguaje natural.

Inicio rápido

1. Obtén tus credenciales de TrackingTime

  • App Password: TrackingTime → Manage → User Settings → Apps & Integrations → crea una nueva App Password

  • Account ID: Visible en tu URL de TrackingTime cuando inicias sesión, o en la configuración de la cuenta

2. Añádelo a tu asistente de IA

Claude Code:

claude mcp add trackingtime -e TT_APP_PASSWORD=your-app-password -e TT_ACCOUNT_ID=your-account-id -- npx trackingtime-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "trackingtime": {
      "command": "npx",
      "args": ["trackingtime-mcp"],
      "env": {
        "TT_APP_PASSWORD": "your-app-password",
        "TT_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

Reinicia tu asistente después de añadirlo.

Alternativa: Instalar desde el código fuente

Si prefieres clonar y compilar localmente:

git clone https://github.com/ficus33/trackingtime-mcp.git
cd trackingtime-mcp
npm install
npm run build
cp .env.example .env   # then edit .env with your credentials

Luego apunta tu asistente a la compilación local:

claude mcp add trackingtime -- node /path/to/trackingtime-mcp/dist/index.js

Related MCP server: Clockify MCP Server

Herramientas

Proyectos

Herramienta

Descripción

tt_list_projects

Listar proyectos (filtro: ACTIVE/ARCHIVED/ALL/FOLLOWING)

tt_list_project_ids

Listar solo IDs de proyectos (ligero, para operaciones por lotes)

tt_search_projects

Buscar proyectos y tareas por palabra clave

tt_create_project

Crear un nuevo proyecto

tt_update_project

Editar nombre del proyecto, cliente o servicio

tt_update_project_preferences

Establecer favorito, vista predeterminada, mostrar tareas cerradas

tt_get_project

Obtener un solo proyecto con indicadores de detalle

tt_get_project_times

Obtener tiempo acumulado para múltiples proyectos

tt_get_project_users

Ver qué personal está en un proyecto

tt_archive_project

Archivar un proyecto (reversible)

tt_reopen_project

Reabrir un proyecto archivado

tt_delete_project

Eliminar permanentemente un proyecto

tt_merge_projects

Fusionar un proyecto en otro

Tareas

Herramienta

Descripción

tt_list_tasks

Listar tareas (filtro: ACTIVE/ARCHIVED/ALL/TRACKING)

tt_create_task

Crear una tarea con asignados, fecha de vencimiento, estimación

tt_update_task

Editar tarea o reasignar personal

tt_get_task

Obtener detalles de una sola tarea

tt_get_task_times

Obtener tiempos acumulados para múltiples tareas

tt_search_tasks

Buscar tareas por nombre dentro de proyectos

tt_sort_tasks

Reordenar tareas por índice de orden

tt_import_tasks

Importación masiva de tareas con modo de vista previa

tt_close_task

Marcar una tarea como completa

tt_reopen_task

Reabrir una tarea completada

tt_delete_task

Eliminar una tarea

Seguimiento de tiempo

Herramienta

Descripción

tt_start_timer

Iniciar un temporizador en una tarea

tt_stop_timer

Detener un temporizador en ejecución

Entradas de tiempo

Herramienta

Descripción

tt_list_time_entries

Listar entradas por usuario/proyecto/cliente/tarea + rango de fechas

tt_list_time_entries_min

Lista mínima más ligera (filtro de facturación, tiempo libre)

tt_count_time_entries

Conteo rápido de entradas para un filtro

tt_add_time_entry

Añadir una entrada de tiempo manual (duración en segundos)

tt_get_time_entry

Obtener una sola entrada de tiempo

tt_update_time_entry

Editar una entrada de tiempo

tt_delete_time_entry

Eliminar una entrada de tiempo

tt_get_events_summary

Resumen de horas por usuario por día

tt_export_time_entries

Exportar como CSV

tt_mark_billed

Marcar entradas como facturadas

tt_mark_not_billed

Desmarcar entradas facturadas

Etiquetas de eventos

Herramienta

Descripción

tt_list_tags

Listar todas las definiciones de etiquetas

tt_get_tag

Obtener una sola etiqueta

tt_list_tag_values

Listar valores usados para un nombre de etiqueta

tt_create_tag

Crear una definición de etiqueta

tt_update_tag

Actualizar una etiqueta

tt_delete_tag

Eliminar una definición de etiqueta

tt_save_event_tag

Adjuntar/actualizar una etiqueta en una entrada de tiempo

tt_delete_event_tag

Eliminar una etiqueta de una entrada de tiempo

Usuarios y personal

Herramienta

Descripción

tt_list_users

Listar todo el personal (encontrar IDs de usuario)

tt_get_user

Obtener detalles de un solo usuario

tt_create_user

Crear un usuario (reemplaza el eliminado tt_invite_users)

tt_update_user

Actualizar perfil de usuario

tt_update_user_permissions

Establecer permisos granulares de edición/visualización

tt_update_employee

Actualizar campos de RRHH (puesto, departamento, fechas…)

tt_resend_invite

Reenviar correo de activación a usuario pendiente

tt_reset_icalendar_token

Rotar el token de exportación iCal del usuario

tt_get_user_tasks

Listar tareas de un usuario agrupadas por proyecto

tt_get_user_tracking

Ver qué está rastreando un usuario actualmente

tt_get_user_trackables

Todos los proyectos y tareas asignados a un usuario

tt_get_user_projects

Listar proyectos asignados a un usuario

tt_assign_user_projects

Asignar personal a proyectos

tt_remove_user_projects

Eliminar personal de proyectos

tt_archive_user

Desactivar un usuario (solo administrador)

tt_reactivate_user

Reactivar un usuario archivado

Grupos de usuarios

Herramienta

Descripción

tt_list_user_groups

Listar grupos (filtro: ACTIVE/ARCHIVED/ALL)

tt_get_user_group

Obtener un solo grupo

tt_create_user_group

Crear un grupo (se requiere supervisor + miembros)

tt_update_user_group

Actualizar un grupo (archivar mediante status: "ARCHIVED")

tt_delete_user_group

Eliminar permanentemente un grupo

Clientes

Herramienta

Descripción

tt_list_customers

Listar clientes (filtro: ACTIVE/ARCHIVED/ALL)

tt_get_customer

Obtener detalles de un solo cliente

tt_create_customer

Crear un nuevo cliente

tt_update_customer

Editar detalles del cliente

tt_delete_customer

Eliminar permanentemente un cliente

tt_archive_customer

Archivar un cliente (reversible)

tt_reactivate_customer

Reactivar un cliente archivado

Servicios

Herramienta

Descripción

tt_list_services

Listar servicios (categorías de trabajo)

tt_get_service

Obtener un servicio

tt_create_service

Crear un nuevo servicio

tt_update_service

Actualizar un servicio

tt_archive_service

Archivar un servicio (reversible)

tt_reactivate_service

Reactivar un servicio archivado

tt_delete_service

Eliminar permanentemente un servicio

Equipos (Espacios de trabajo)

Herramienta

Descripción

tt_list_teams

Listar todos los espacios de trabajo a los que pertenece el usuario

tt_switch_team

Cambiar el espacio de trabajo activo para la sesión

tt_update_team_permissions

Actualizar permisos predeterminados de los miembros

Informes

Herramienta

Descripción

tt_get_user_report

Informe de análisis por usuario con gráficos y desgloses

Notificaciones

Herramienta

Descripción

tt_list_notifications

Listar notificaciones (ámbito USER o PROJECT)

tt_mark_notification_read

Marcar una notificación como leída

tt_mark_notifications_read

Marcar muchas notificaciones como leídas

Webhooks

Herramienta

Descripción

tt_list_webhooks

Listar webhooks configurados

tt_get_webhook

Obtener un webhook

tt_enable_webhook

Habilitar un webhook

tt_disable_webhook

Deshabilitar un webhook

tt_reset_webhook_token

Rotar el token de firma de un webhook

tt_delete_webhook

Eliminar un webhook

Reducción del número de herramientas

Las 93 herramientas están activas por defecto. Si consideras que esto añade demasiado contexto para tu asistente de IA, puedes clonar el repositorio, comentar las herramientas que no necesites en src/tools.ts con /* */, y ejecutar npm run build para crear una compilación más ligera.

Pruebas

Usa MCP Inspector para probar las herramientas de forma interactiva:

npx @modelcontextprotocol/inspector npx trackingtime-mcp

Notas de la API

Algunas peculiaridades de la API de TrackingTime a tener en cuenta:

  • duration y accumulated_time están en segundos

  • estimated_time y worked_hours están en horas

  • Las entradas de tiempo se llaman "eventos" en la API

  • Iniciar un temporizador cuando ya hay uno en ejecución devuelve el error 502 — usa stop_running_task=true para detener automáticamente el temporizador actual

  • Las fechas usan YYYY-MM-DD, las fechas y horas usan yyyy-MM-dd HH:mm:ss

Autenticación

Este servidor utiliza la autenticación mediante App Password de TrackingTime. Tu contraseña real nunca se almacena. La App Password se envía como autenticación HTTP Basic (API_TOKEN:<app_password>) a través de SSL.

Si una App Password se ve comprometida, revócala en TrackingTime y crea una nueva; no es necesario cambiar la contraseña de tu cuenta.

Licencia

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers