Timelog MCP Server

MCP-сервер, который предоставляет API регистрации времени Timelog в виде инструментов для Claude. Он позволяет просматривать, создавать и управлять регистрациями времени, отсутствиями и утверждением табелей через естественный язык.

Возможности

• Просмотр регистраций времени — по неделе или произвольному диапазону дат, включая финансовые/биллинговые данные

• Создание, изменение и удаление регистраций времени по любой задаче, к которой у вас есть доступ

• Управление отсутствиями — поиск кодов отсутствий и регистрация отпуска, больничного и т. д.

• Утверждение табелей — проверка статуса отправки и отправка табелей с фильтрацией по сотруднику, отделу, утверждающему или юридическому лицу

• Организация — поиск юридических лиц и профиля текущего пользователя

• Поиск задач — поиск задач для регистрации времени по имени или номеру

Related MCP server: TimeChimp MCP Server

Инструменты

Пользователь и организация

get_current_user

Получить профиль аутентифицированного пользователя (имя, электронная почта, отдел). Без параметров.

get_legal_entities

Получить все юридические лица в организации. Возвращает ID, имя, статус активности, валюту и страну для каждого юридического лица. Без параметров.

Регистрации времени

get_weekly_registrations

Получить регистрации времени за конкретную неделю, сгруппированные по дням с нормо-часами.

get_registrations_by_date_range

Получить регистрации времени между двумя датами.

get_financial_data

Получить финансовые данные (статус биллинга/выставления счёта) для регистраций времени в диапазоне дат.

search_tasks

Поиск задач, по которым пользователь может регистрировать время. Возвращает ID задач, необходимые для создания регистраций времени.

create_time_registration

Создать новую регистрацию времени по задаче. Сначала используйте search_tasks, чтобы найти TaskID.

update_time_registration

Обновить существующую регистрацию времени. Указывайте только те поля, которые хотите изменить.

delete_time_registration

Удалить регистрацию времени по её GUID.

Отсутствия

search_absence_codes

Поиск кодов отсутствий (например, Ferie, Sygdom). Возвращает AbsenceCodeID, необходимый для create_absence_registration.

create_absence_registration

Создать регистрацию отсутствия (отпуск, больничный и т. д.). Используйте search_absence_codes, чтобы найти AbsenceCodeID. По умолчанию регистрируется полный рабочий день.

Утверждение табелей

get_timesheet_status

Получить еженедельный статус утверждения/отправки табелей. По умолчанию — для аутентифицированного пользователя. Опустите userId, чтобы получить всех сотрудников (вид руководителя).

submit_timesheet

Отправить табель на утверждение за диапазон дат (например, за полную неделю).

Рабочие процессы руководителя

Поиск и закрытие открытых табелей

Используйте get_timesheet_status без userId, чтобы получить статус отправки для всех сотрудников за период. Фильтруйте по departmentId, approverId или legalEntityId, чтобы сузить область поиска.

После того как вы определили сотрудников с открытыми табелями, используйте submit_timesheet с параметром employeeUserId, чтобы отправить их от их имени.

Примеры запросов:

«Покажи всех, кто не отправил свой табель на этой неделе» «Отправь табель за эту неделю для пользователя 1234» «Отправь все открытые табели за эту неделю для отдела 5»

Установка

Через npx (рекомендуется)

Добавьте в ваш .mcp.json Claude Code или конфигурацию Claude Desktop:

{
  "mcpServers": {
    "timelog": {
      "command": "npx",
      "args": ["-y", "timelog-mcp"],
      "env": {
        "TIMELOG_PAT": "<your-personal-access-token>",
        "TIMELOG_BASE_URL": "https://app[X].timelog.com/<your-account>/api"
      }
    }
  }
}

Из исходного кода

git clone git@github.com:Amoeslund/Timelog-MCP-server.git
cd Timelog-MCP-server
npm install
npm run build

Затем укажите в вашей MCP-конфигурации путь к собранному файлу:

{
  "mcpServers": {
    "timelog": {
      "command": "node",
      "args": ["/path/to/Timelog-MCP-server/dist/index.js"],
      "env": {
        "TIMELOG_PAT": "<your-personal-access-token>",
        "TIMELOG_BASE_URL": "https://app[X].timelog.com/<your-account>/api"
      }
    }
  }
}

Конфигурация

Персональный токен доступа

Сгенерируйте PAT на https://login.timelog.com/personaltoken.

Базовый URL

Ваш URL имеет формат https://app[X].timelog.com/<your-account>/api, где [X] — номер сервера (1–10), а <your-account> — имя вашего аккаунта Timelog. Подробнее см. в документации API Timelog.

Переменные окружения

Лицензия

ISC