Сервер Clockify MCP

Этот сервер MCP позволяет LLM (таким как Cursor или Claude) взаимодействовать с вашим рабочим пространством Clockify, обеспечивая расширенную автоматизацию отслеживания времени и отчетности. С этим сервером вы можете:

• Перечислите все проекты в вашем рабочем пространстве

• Список всех пользователей в вашем рабочем пространстве

• Добавляйте и просматривайте записи времени для себя или любого пользователя (если у вас есть разрешения)

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

• Создавайте ежемесячные или пользовательские разбивки часов по диапазону дат по пользователям и проектам с помощью API сводных отчетов Clockify

• Интеграция с LLM для автоматизации, обобщения и анализа данных учета рабочего времени

Функции

• listProjects: список всех проектов для аутентифицированного пользователя.

• getTimeEntries: список записей времени для аутентифицированного пользователя (с дополнительными фильтрами по дате)

• addTimeEntry: Добавить записи времени в проект

• listUsers: список всех пользователей в рабочей области

• getUserTimeEntries: список записей времени для любого пользователя (с дополнительными фильтрами по дате)

• getSummaryReport: Получить сводный отчет о часах по пользователю/проекту для диапазона дат (опционально фильтруется по userIds/projectIds). Включает ежемесячную/почасовую разбивку для любого пользователя или проекта.

Related MCP server: @lewinnovation/clockify-mcp-server

Быстрый старт (Docker — предпочтительно)

Конфигурация сервера MCP для Cursor/Claude

Добавьте следующее в ваш Cursor или Claude settings.json (замените YOUR_API_KEY ):

{
  "mcpServers": {
    "clockify-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CLOCKIFY_API_KEY=<YOUR_API_KEY>",
        "ghcr.io/inakianduaga/clockify-mcp:latest"  
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Как получить ключ API Clockify

1. Войдите в свою учетную запись Clockify .

2. Нажмите на значок своего профиля (вверху справа) и выберите Профиль .

3. Прокрутите вниз до раздела API .

4. Нажмите «Сгенерировать», если у вас нет ключа API, или скопируйте существующий ключ.

Содействие и CI/CD

В этом проекте используются действия GitHub для автоматической сборки и публикации образа Docker в реестре контейнеров GitHub (GHCR) при каждой отправке в main .

• URL-адрес изображения: ghcr.io/inakianduaga/clockify-mcp:latest

• Как извлечь изображение:

  docker pull ghcr.io/inakianduaga/clockify-mcp:latest

Вы можете просмотреть опубликованные изображения в разделе «Пакеты» вашего профиля или репозитория GitHub.

Банк памяти и оптимизации

Разработка велась с использованием курсора вместе с оптимизированными правилами. См.: https://github.com/Bhartendu-Kumar/rules\_template

Лицензия

Этот проект лицензирован по лицензии MIT. Подробности см. в файле LICENSE .