Skip to main content
Glama
deenesjakoruzh
ficus33

TrackingTime MCP Server

by ficus33
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

MCP-сервер TrackingTime

Сервер MCP (Model Context Protocol), который подключает ИИ-ассистентов, таких как Claude, к API TrackingTime v4. Управляйте проектами, задачами, учетом времени, распределением сотрудников и клиентами с помощью естественного языка.

Быстрый старт

1. Получите учетные данные TrackingTime

  • Пароль приложения (App Password): TrackingTime → Manage → User Settings → Apps & Integrations → создайте новый App Password

  • ID аккаунта (Account ID): Отображается в URL TrackingTime после входа в систему или в настройках аккаунта

2. Добавьте в своего ИИ-ассистента

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"
      }
    }
  }
}

После добавления перезапустите ассистента.

Альтернатива: Установка из исходного кода

Если вы предпочитаете клонировать и собрать проект локально:

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

Затем укажите ассистенту путь к локальной сборке:

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

Related MCP server: Clockify MCP Server

Инструменты

Проекты

Инструмент

Описание

tt_list_projects

Список проектов (фильтр: ACTIVE/ARCHIVED/ALL/FOLLOWING)

tt_list_project_ids

Список только ID проектов (облегченный, для пакетных операций)

tt_search_projects

Поиск проектов и задач по ключевому слову

tt_create_project

Создание нового проекта

tt_update_project

Редактирование названия проекта, клиента или услуги

tt_update_project_preferences

Установка избранного, вида по умолчанию, отображения закрытых задач

tt_get_project

Получение одного проекта с флагами детализации

tt_get_project_times

Получение накопленного времени для нескольких проектов

tt_get_project_users

Просмотр сотрудников, назначенных на проект

tt_archive_project

Архивация проекта (обратимо)

tt_reopen_project

Восстановление архивированного проекта

tt_delete_project

Безвозвратное удаление проекта

tt_merge_projects

Объединение одного проекта с другим

Задачи

Инструмент

Описание

tt_list_tasks

Список задач (фильтр: ACTIVE/ARCHIVED/ALL/TRACKING)

tt_create_task

Создание задачи с исполнителями, сроком выполнения, оценкой

tt_update_task

Редактирование задачи или переназначение сотрудников

tt_get_task

Получение деталей одной задачи

tt_get_task_times

Получение накопленного времени для нескольких задач

tt_search_tasks

Поиск задач по названию внутри проектов

tt_sort_tasks

Изменение порядка задач по индексу сортировки

tt_import_tasks

Массовый импорт задач с режимом предварительного просмотра

tt_close_task

Отметка задачи как выполненной

tt_reopen_task

Восстановление выполненной задачи

tt_delete_task

Удаление задачи

Учет времени

Инструмент

Описание

tt_start_timer

Запуск таймера для задачи

tt_stop_timer

Остановка запущенного таймера

Записи времени

Инструмент

Описание

tt_list_time_entries

Список записей по пользователю/проекту/клиенту/задаче + диапазон дат

tt_list_time_entries_min

Облегченный минимальный список (фильтр по оплате, отгулам)

tt_count_time_entries

Быстрый подсчет записей по фильтру

tt_add_time_entry

Добавление записи времени вручную (длительность в секундах)

tt_get_time_entry

Получение одной записи времени

tt_update_time_entry

Редактирование записи времени

tt_delete_time_entry

Удаление записи времени

tt_get_events_summary

Сводка часов по пользователю за день

tt_export_time_entries

Экспорт в CSV

tt_mark_billed

Отметка записей как оплаченных

tt_mark_not_billed

Снятие отметки об оплате

Теги событий

Инструмент

Описание

tt_list_tags

Список всех определений тегов

tt_get_tag

Получение одного тега

tt_list_tag_values

Список значений, используемых для имени тега

tt_create_tag

Создание определения тега

tt_update_tag

Обновление тега

tt_delete_tag

Удаление определения тега

tt_save_event_tag

Прикрепление/обновление тега к записи времени

tt_delete_event_tag

Удаление тега из записи времени

Пользователи и сотрудники

Инструмент

Описание

tt_list_users

Список всех сотрудников (поиск ID пользователей)

tt_get_user

Получение деталей одного пользователя

tt_create_user

Создание пользователя (заменяет удаленный tt_invite_users)

tt_update_user

Обновление профиля пользователя

tt_update_user_permissions

Установка детальных прав редактирования/просмотра

tt_update_employee

Обновление HR-полей (должность, отдел, даты...)

tt_resend_invite

Повторная отправка письма активации пользователю

tt_reset_icalendar_token

Обновление токена экспорта iCal пользователя

tt_get_user_tasks

Список задач пользователя, сгруппированных по проектам

tt_get_user_tracking

Просмотр того, что пользователь отслеживает в данный момент

tt_get_user_trackables

Все проекты и задачи, назначенные пользователю

tt_get_user_projects

Список проектов, назначенных пользователю

tt_assign_user_projects

Назначение сотрудников на проекты

tt_remove_user_projects

Удаление сотрудников из проектов

tt_archive_user

Деактивация пользователя (только для администратора)

tt_reactivate_user

Реактивация архивированного пользователя

Группы пользователей

Инструмент

Описание

tt_list_user_groups

Список групп (фильтр: ACTIVE/ARCHIVED/ALL)

tt_get_user_group

Получение одной группы

tt_create_user_group

Создание группы (требуются руководитель + участники)

tt_update_user_group

Обновление группы (архивация через status: "ARCHIVED")

tt_delete_user_group

Безвозвратное удаление группы

Клиенты

Инструмент

Описание

tt_list_customers

Список клиентов (фильтр: ACTIVE/ARCHIVED/ALL)

tt_get_customer

Получение деталей одного клиента

tt_create_customer

Создание нового клиента

tt_update_customer

Редактирование деталей клиента

tt_delete_customer

Безвозвратное удаление клиента

tt_archive_customer

Архивация клиента (обратимо)

tt_reactivate_customer

Реактивация архивированного клиента

Услуги

Инструмент

Описание

tt_list_services

Список услуг (категорий работ)

tt_get_service

Получение услуги

tt_create_service

Создание новой услуги

tt_update_service

Обновление услуги

tt_archive_service

Архивация услуги (обратимо)

tt_reactivate_service

Реактивация архивированной услуги

tt_delete_service

Безвозвратное удаление услуги

Команды (Рабочие пространства)

Инструмент

Описание

tt_list_teams

Список всех рабочих пространств, к которым принадлежит пользователь

tt_switch_team

Переключение активного рабочего пространства для сессии

tt_update_team_permissions

Обновление прав участников по умолчанию

Отчеты

Инструмент

Описание

tt_get_user_report

Аналитический отчет по пользователю с графиками и разбивкой

Уведомления

Инструмент

Описание

tt_list_notifications

Список уведомлений (область USER или PROJECT)

tt_mark_notification_read

Отметка одного уведомления как прочитанного

tt_mark_notifications_read

Отметка многих уведомлений как прочитанных

Вебхуки

Инструмент

Описание

tt_list_webhooks

Список настроенных вебхуков

tt_get_webhook

Получение вебхука

tt_enable_webhook

Включение вебхука

tt_disable_webhook

Отключение вебхука

tt_reset_webhook_token

Обновление токена подписи вебхука

tt_delete_webhook

Удаление вебхука

Уменьшение количества инструментов

Все 93 инструмента активны по умолчанию. Если вы считаете, что это создает слишком много контекста для вашего ИИ-ассистента, вы можете клонировать репозиторий, закомментировать ненужные инструменты в src/tools.ts с помощью /* */ и выполнить npm run build для создания более компактной сборки.

Тестирование

Используйте MCP Inspector для интерактивного тестирования инструментов:

npx @modelcontextprotocol/inspector npx trackingtime-mcp

Примечания к API

Несколько особенностей API TrackingTime, о которых стоит знать:

  • duration и accumulated_time указаны в секундах

  • estimated_time и worked_hours указаны в часах

  • Записи времени в API называются "events" (события)

  • Запуск таймера, когда другой уже запущен, возвращает ошибку 502 — используйте stop_running_task=true для автоматической остановки текущего таймера

  • Даты используют формат YYYY-MM-DD, дата-время — yyyy-MM-dd HH:mm:ss

Аутентификация

Этот сервер использует аутентификацию через App Password (пароль приложения) TrackingTime. Ваш основной пароль никогда не сохраняется. Пароль приложения отправляется как HTTP Basic auth (API_TOKEN:<app_password>) через SSL.

Если пароль приложения скомпрометирован, аннулируйте его в TrackingTime и создайте новый — менять пароль от аккаунта не нужно.

Лицензия

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