tracegazer/clockify-mcp

tracegazer/clockify-mcp

от tracegazer
MCP-сервер для Clockify — даёт AI-ассистенту доступ к отслеживанию времени: проекты, задачи, отчёты, управление клиентами и инвойсами. 112 инструментов, по умолчанию только чтение, с опцией полного...

clockify-mcp

CI PyPI Python License: MIT MCP Registry Smithery

A Model Context Protocol server for the Clockify time-tracking API.

Give your AI assistant access to your Clockify data — query workspaces, projects, and time entries, generate reports, log hours, and manage clients, invoices, and more — all through natural language.

112 tools across 18 domains. Read-only by default, with optional write operations behind explicit opt-in.

Install in one click

The easiest way to use this server with Claude Desktop (and other MCPB-compatible clients) is the prebuilt bundle:

➡️ Download clockify-mcp.mcpb — then double-click it. Claude Desktop opens the installer, prompts for your Clockify API key, and you're done. No Python, no npx/uvx, no config files.

The .mcpb is attached to every GitHub Release and mirrored on Smithery. Prefer a package manager or container? See Quick start below.

What can it do?

48 read-only tools are available today (Phase 0–8b — 18 domains). 64 write tools (create/update/delete across clients, projects, tasks, tags, time entries, holidays, expenses, and expense categories, plus time-off policy/request management, approval submit/resubmit/update, custom-field create/update/delete and project assignment, scheduling assignment management, invoice and payment management, shared-report management, and webhook create/update/delete/token) register when you set CLOCKIFY_ACCESS_MODE=full (or the back-compat CLOCKIFY_ENABLE_WRITES=true). A middle time-tracking mode exposes only the time-entry writes for logging hours — see Access modes.

Инструменты были проиндексированы:
download_expense_receipt

Скачать файл квитанции расхода в локальную директорию.

Параметры
  • expense_idstringобязательный
  • file_idstringобязательный
  • save_pathstringобязательный
  • workspace_idstring | null
export_report

Экспортировать отчет в файл (PDF/CSV/XLSX). report_type: detailed/summary/weekly/attendance/expenses; fmt: PDF/CSV/XLSX; байты записываются в save_path.

Параметры
  • date_range_endstringобязательный
  • date_range_startstringобязательный
  • fmtstringобязательный
  • report_typestringобязательный
  • save_pathstringобязательный
  • workspace_idstring | null
find_user_team_manager

Найти менеджера(ов) команды пользователя.

Параметры
  • user_idstringобязательный
  • workspace_idstring | null
generate_attendance_report

Сгенерировать отчёт о посещаемости (на пользователя/день: работа, перерывы, загрузка, сверхурочные, отгулы) за указанный период. Требуется дополнение для учёта посещаемости/отслеживания времени.

Параметры
  • date_range_endstringобязательный
  • date_range_startstringобязательный
  • has_time_offboolean | null
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • workspace_idstring | null
generate_detailed_report

Сформировать подробный отчёт (одна строка на каждую временную запись) за указанный диапазон дат.

Параметры
  • date_range_endstringобязательный
  • date_range_startstringобязательный
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • workspace_idstring | null
generate_expense_report

Создаёт подробный отчёт о расходах ({"expenses": [...], "totals": {...}}) за указанный период. Требуется дополнение Expenses.

Параметры
  • billableboolean | null
  • date_range_endstringобязательный
  • date_range_startstringобязательный
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • workspace_idstring | null
generate_summary_report

Создать сводный отчет (итоги, сгруппированные по одному или нескольким ключам) за диапазон дат.

Параметры
  • date_range_endstringобязательный
  • date_range_startstringобязательный
  • groupsstring[] | null
  • sort_columnstring | null
  • workspace_idstring | null
generate_weekly_report

Создать еженедельный отчёт за диапазон дат.

Параметры
  • date_range_endstringобязательный
  • date_range_startstringобязательный
  • groupstring | null
  • subgroupstring | null
  • workspace_idstring | null
get_client

Получить одного клиента по идентификатору.

Параметры
  • client_idstringобязательный
  • workspace_idstring | null
get_current_user

Получить информацию о текущем вошедшем пользователе (id, email, рабочее пространство по умолчанию).

Параметры

Без параметров.

get_expense

Получить один расход по ID.

Параметры
  • expense_idstringобязательный
  • workspace_idstring | null
get_invoice

Получить один счет по id.

Параметры
  • invoice_idstringобязательный
  • workspace_idstring | null
get_invoice_payments

Вывести платежи счета (постранично).

Параметры
  • invoice_idstringобязательный
  • pageinteger | null
  • page_sizeinteger | null
  • workspace_idstring | null
get_project

Получить один проект по идентификатору.

Параметры
  • hydratedboolean | null
  • project_idstringобязательный
  • workspace_idstring | null
get_project_scheduling_totals

Получить итоговые значения запланированных назначений по проектам (тело POST-запроса с фильтром). start/end обязательны. status_filter: PUBLISHED/UNPUBLISHED/ALL.

Параметры
  • endstringобязательный
  • pageinteger | null
  • page_sizeinteger | null
  • searchstring | null
  • startstringобязательный
  • status_filterstring | null
  • workspace_idstring | null
get_shared_report

Сгенерировать (получить данные) общего отчёта по идентификатору. Необязательные параметры переопределяют сохранённый диапазон/сортировку/формат; export_type: JSON/PDF/CSV/XLSX/ZIP.

Параметры
  • date_range_endstring | null
  • date_range_startstring | null
  • export_typestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • shared_report_idstringобязательный
  • sort_columnstring | null
  • sort_orderstring | null
get_tag

Получить один тег по id.

Параметры
  • tag_idstringобязательный
  • workspace_idstring | null
get_task

Получить одну задачу по id (в рамках её проекта).

Параметры
  • project_idstringобязательный
  • task_idstringобязательный
  • workspace_idstring | null
get_time_entry

Получить одну запись времени по ID.

Параметры
  • hydratedboolean | null
  • time_entry_idstringобязательный
  • workspace_idstring | null
get_time_off_policy

Получить одну политику отпуска по ID.

Параметры
  • policy_idstringобязательный
  • workspace_idstring | null
get_user_member_profile

Получить профиль участника в рабочем пространстве.

Параметры
  • user_idstringобязательный
  • workspace_idstring | null
get_user_scheduling_totals

Получить итоговые значения ёмкости расписания пользователей (тело POST фильтра). start/end обязательны. status_filter принимает PUBLISHED/UNPUBLISHED/ALL.

Параметры
  • endstringобязательный
  • pageinteger | null
  • page_sizeinteger | null
  • searchstring | null
  • startstringобязательный
  • status_filterstring | null
  • workspace_idstring | null
get_webhook

Получить один webhook по id.

Параметры
  • webhook_idstringобязательный
  • workspace_idstring | null
get_webhook_logs

Получить логи доставки вебхука (тело фильтра POST; page/size - параметры запроса). from_/to - ISO-8601. status фильтрует по ALL/SUCCEEDED/FAILED.

Параметры
  • from_string | null
  • pageinteger | null
  • sizeinteger | null
  • sort_by_newestboolean | null
  • statusstring | null
  • tostring | null
  • webhook_idstringобязательный
  • workspace_idstring | null
get_workspace

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

Параметры
  • workspace_idstring | null
list_approval_requests

Список запросов на утверждение (с пагинацией).

Параметры
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • sort_orderstring | null
  • statusstring | null
  • workspace_idstring | null
list_clients

Список клиентов в рабочем пространстве, опционально отфильтрованных по имени (с пагинацией).fetch_all=True обрабатывает пагинацию и возвращает все страницы, объединённые в один результат.

Параметры
  • archivedboolean | null
  • fetch_allboolean
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • sort_orderstring | null
  • workspace_idstring | null
list_expense_categories

Список категорий расходов (с пагинацией).

Параметры
  • archivedboolean | null
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • sort_orderstring | null
  • workspace_idstring | null
list_expenses

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

Параметры
  • pageinteger | null
  • page_sizeinteger | null
  • user_idstring | null
  • workspace_idstring | null
list_holidays

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

Параметры
  • assigned_tostring | null
  • workspace_idstring | null
list_holidays_in_period

Выводит список праздников, попадающих в диапазон дат для пользователя.

Параметры
  • assigned_tostringобязательный
  • endstringобязательный
  • startstringобязательный
  • workspace_idstring | null
list_invoices

Список счетов (постранично)

Параметры
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • sort_orderstring | null
  • statusesstring | null
  • workspace_idstring | null
list_project_custom_fields

Перечислить пользовательские поля проекта (статус INACTIVE/VISIBLE/INVISIBLE).

Параметры
  • entity_typestring | null
  • project_idstringобязательный
  • statusstring | null
  • workspace_idstring | null
list_projects

Выводит список проектов в рабочем пространстве с необязательными фильтрами (с постраничной навигацией). fetch_all=True проходит по страницам и возвращает каждую страницу, объединённую в один результат.

Параметры
  • archivedboolean | null
  • billableboolean | null
  • clientsstring[] | null
  • fetch_allboolean
  • hydratedboolean | null
  • is_templateboolean | null
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • sort_orderstring | null
  • strict_name_searchboolean | null
  • usersstring[] | null
  • workspace_idstring | null
list_scheduled_assignments

Вывести список запланированных назначений в диапазоне дат (начало/конец ISO-8601, обязательно). sort_column: PROJECT/USER/ID; sort_order: ASCENDING/DESCENDING.

Параметры
  • endstringобязательный
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • sort_orderstring | null
  • startstringобязательный
  • workspace_idstring | null
list_shared_reports

Вывести общие отчёты рабочего пространства. Параметр shared_reports_filter принимает значения ALL (по умолчанию), CREATED_BY_ME или SHARED_WITH_ME.

Параметры
  • pageinteger | null
  • page_sizeinteger | null
  • shared_reports_filterstring | null
  • workspace_idstring | null
list_tags

Возвращает список тегов в рабочем пространстве, опционально отфильтрованных по имени (с постраничной разбивкой).Параметр fetch_all=True обходит все страницы и возвращает объединённый результат.

Параметры
  • archivedboolean | null
  • excluded_idsstring | null
  • fetch_allboolean
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • sort_orderstring | null
  • strict_name_searchboolean | null
  • workspace_idstring | null
list_tasks

Выводит список задач в проекте, с возможностью фильтрации по имени или состоянию активности (с постраничной навигацией). Если fetch_all=True, то инструмент автоматически проходит по всем страницам и возвращает их объединённый результат.

Параметры
  • fetch_allboolean
  • is_activeboolean | null
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • project_idstringобязательный
  • sort_columnstring | null
  • sort_orderstring | null
  • strict_name_searchboolean | null
  • workspace_idstring | null
list_time_entries

Выводит записи времени пользователя в рабочем пространстве (постранично).fetch_all=True проходит по страницам и возвращает все страницы, объединённые в один результат.

Параметры
  • descriptionstring | null
  • endstring | null
  • fetch_allboolean
  • get_week_beforestring | null
  • hydratedboolean | null
  • in_progressboolean | null
  • pageinteger | null
  • page_sizeinteger | null
  • projectstring | null
  • project_requiredboolean | null
  • startstring | null
  • tagsstring[] | null
  • taskstring | null
  • task_requiredboolean | null
  • user_idstringобязательный
  • workspace_idstring | null
list_time_off_balances_by_policy

Вывести балансы отпусков для каждого пользователя по политике (с пагинацией).

Параметры
  • pageinteger | null
  • page_sizeinteger | null
  • policy_idstringобязательный
  • sortstring | null
  • sort_orderstring | null
  • workspace_idstring | null
list_time_off_balances_by_user

Выводит список остатков отпусков пользователя по всем политикам (с разбивкой на страницы).

Параметры
  • pageinteger | null
  • page_sizeinteger | null
  • sortstring | null
  • sort_orderstring | null
  • user_idstringобязательный
  • workspace_idstring | null
list_time_off_policies

Список политик отпусков в рабочем пространстве (постранично).

Параметры
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • sort_columnstring | null
  • sort_orderstring | null
  • statusstring | null
  • workspace_idstring | null
list_time_off_requests

Список/фильтрация запросов на отпуск (фильтр передаётся в теле POST-запроса).

Параметры
  • endstring | null
  • pageinteger | null
  • page_sizeinteger | null
  • startstring | null
  • statusesstring[] | null
  • user_groupsstring[] | null
  • usersstring[] | null
  • workspace_idstring | null
list_user_groups

Список групп пользователей в рабочем пространстве, опционально отфильтрованных по имени (постранично).

Параметры
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • workspace_idstring | null
list_users

Список пользователей рабочего пространства, с опциональной фильтрацией по имени/email/статусу (постранично).fetch_all=True перебирает все страницы и возвращает их объединёнными.

Параметры
  • emailstring | null
  • fetch_allboolean
  • namestring | null
  • pageinteger | null
  • page_sizeinteger | null
  • statusstring | null
  • workspace_idstring | null
list_webhooks

Перечислить вебхуки. Фильтры по типу: USER_CREATED, SYSTEM или ADDON.

Параметры
  • typestring | null
  • workspace_idstring | null
list_workspace_custom_fields

Список пользовательских полей рабочего пространства (статус INACTIVE/VISIBLE/INVISIBLE).

Параметры
  • entity_typestring | null
  • namestring | null
  • statusstring | null
  • workspace_idstring | null
list_workspaces

Выведи список всех рабочих пространств, в которых состоит аутентифицированный пользователь.

Параметры

Без параметров.

0.3.2основная
0.3.1
0.3.0
0.2.2
0.2.1
0.2.0

Выберите клиент, чтобы установить tracegazer/clockify-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "tracegazer-clockify-mcp-0qhduhcift": {
      "command": "uvx",
      "args": [
        "clockify-mcp"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "tracegazer-clockify-mcp-0qhduhcift": {
      "command": "uvx",
      "args": [
        "clockify-mcp"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "tracegazer-clockify-mcp-0qhduhcift": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "clockify-mcp"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"tracegazer-clockify-mcp-0qhduhcift\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"clockify-mcp\"],\"env\":{\"CLOCKIFY_API_KEY\":\"your-api-key\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "tracegazer-clockify-mcp-0qhduhcift": {
      "command": "uvx",
      "args": [
        "clockify-mcp"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add tracegazer-clockify-mcp-0qhduhcift --env CLOCKIFY_API_KEY=your-api-key -- uvx clockify-mcp

Либо через JSON-конфиг:

claude mcp add-json tracegazer-clockify-mcp-0qhduhcift "{\"command\":\"uvx\",\"args\":[\"clockify-mcp\"],\"env\":{\"CLOCKIFY_API_KEY\":\"your-api-key\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add tracegazer-clockify-mcp-0qhduhcift --env CLOCKIFY_API_KEY=your-api-key -- uvx clockify-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.tracegazer-clockify-mcp-0qhduhcift]
command = "uvx"
args = ["clockify-mcp"]

[mcp_servers.tracegazer-clockify-mcp-0qhduhcift.env]
CLOCKIFY_API_KEY = "your-api-key"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите tracegazer/clockify-mcp, а в поле команды запуска — строку ниже:
uvx clockify-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "tracegazer-clockify-mcp-0qhduhcift": {
      "command": "uvx",
      "args": [
        "clockify-mcp"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "tracegazer-clockify-mcp-0qhduhcift": {
      "command": "uvx",
      "args": [
        "clockify-mcp"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например tracegazer-clockify-mcp-0qhduhcift.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: tracegazer-clockify-mcp-0qhduhcift
    command: uvx
    args:
      - "clockify-mcp"
    env:
      CLOCKIFY_API_KEY: your-api-key
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "tracegazer-clockify-mcp-0qhduhcift": {
      "command": "uvx",
      "args": [
        "clockify-mcp"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key"
      }
    }
  }
}

Похожие MCP-сервера

henilcalagiya/google-sheets-mcp

henilcalagiya/google-sheets-mcp

от henilcalagiya

MCP-сервер для автоматизации Google Sheets: создание, чтение, обновление и удаление таблиц через MCP-клиенты. Использует сервисный аккаунт Google для безопасной интеграции. Полезен разработчикам, а...

Python⭐ 13
louis030195/toggl-mcp

louis030195/toggl-mcp

от louis030195

MCP сервер для управления временем в Toggl прямо из чата с ИИ-ассистентом: запускай и останавливай таймер, просматривай записи за день, проекты и удаляй пометки — всё через естественный язык. Идеально для разработчиков и фрилансеров, ведущих трекинг времени.

JavaScript⭐ 3
Miro MCP

Miro MCP

официальный

Официальный MCP-сервер Miro: даёт AI-ассистенту доступ к вашим доскам — читать их содержимое и создавать на них диаграммы, стикеры и документы.

conorbronsdon/gws-mcp-server

conorbronsdon/gws-mcp-server

от conorbronsdon

MCP сервер для безопасной интеграции Google Workspace с AI агентами. 41 тщательно отобранный инструмент для Gmail, Calendar, Drive, Sheets, Docs и Tasks — без раздувания контекста. Требуется gws CLI. Идеально для автоматизации офисных задач.

TypeScript⭐ 11
ayo-nci/bulkrender-mcp

ayo-nci/bulkrender-mcp

от ayo-nci

BulkRender MCP сервер для создания DOCX и PDF документов прямо из Claude, Cursor и других AI-ассистентов. Работает по шаблонам, поддерживает пакетную генерацию до 500 документов и не требует устано...

JavaScript⭐ 1
SecurityRonin/docx-mcp

SecurityRonin/docx-mcp

от securityronin

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

Python⭐ 65
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин