clickup-mcp

Легковесный MCP-сервер ClickUp, ориентированный на управление задачами. 39 инструментов с оптимизированными по токенам ответами — ответы API автоматически сокращаются с тысяч символов до самого необходимого.

Почему этот сервер?

API ClickUp возвращает чрезвычайно многословный JSON. Этот сервер урезает его:

Меньше токенов = быстрее ответы, ниже затраты, больше контекста для вашего ИИ.

Related MCP server: ClickUp MCP Server

Установка

npm install -g @cavort-it-systems/clickup-mcp

Или запустите напрямую:

npx @cavort-it-systems/clickup-mcp

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

Claude Code CLI

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp

Claude Desktop / Вручную

Добавьте в ваш MCP-конфиг (~/.claude.json или настройки Claude Desktop):

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@cavort-it-systems/clickup-mcp"],
      "env": {
        "CLICKUP_API_TOKEN": "your-token"
      }
    }
  }
}

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

git clone https://github.com/cvrt-jh/clickup-mcp.git
cd clickup-mcp
npm install && npm run build

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

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- node /path/to/clickup-mcp/build/index.js

Получите свой API-токен

1. Перейдите в ClickUp: Настройки > Приложения

2. Сгенерируйте персональный API-токен

3. Установите его как CLICKUP_API_TOKEN

Сокращение ответов

Все ответы автоматически сокращаются для экономии токенов. API ClickUp возвращает чрезвычайно многословный JSON — этот сервер урезает его до сути.

clickup_whoami - с ~3,500 символов до ~160:

// Before (ClickUp API raw)
{"user":{"id":12345678,"username":"Jane Doe","email":"jane@example.com","color":"#0388d1",
"profilePicture":"https://attachments.clickup.com/...","initials":"JD",
"week_start_day":1,"global_font_support":true,"timezone":"Europe/Berlin"},
"teams":{"teams":[{"id":"99999999","name":"My Workspace","color":"#40BC86",
"avatar":"https://attachments2.clickup.com/...?Expires=...&Key-Pair-Id=...&Signature=...",
"members":[{"user":{"id":11111111,"username":"Bob Smith","email":"bob@example.com",
"color":"#aa2fff","profilePicture":null,"initials":"BS","role":4,"role_subtype":2,
"role_key":"guest","custom_role":null,"last_active":"...","date_joined":"...",
"date_invited":"..."},"invited_by":{"id":22222222,...},
"can_see_time_spent":true,...}, ...]}]}}

// After (slimmed)
{"id":12345678,"username":"Jane Doe","email":"jane@example.com",
"timezone":"Europe/Berlin","workspaces":[{"id":"99999999",
"name":"My Workspace","member_count":4}]}

clickup_create_comment - с ~1,500 символов до 38:

// Before
{"id":90150191300876,"hist_id":"...","date":1770053982842,
"version":{"object_type":"comment","object_id":"...","workspace_id":99999999,
"operation":"c","data":{"context":{"root_parent_type":1,"is_chat":false,
"audit_context":{"userid":12345678,"current_time":...,"route":"*"},...},...},...}}

// After
{"id":90150191300876,"date":1770053982842}

Что удаляется:

Инструменты (37)

Навигация (7)

• clickup_whoami - Текущий пользователь + рабочие пространства

• clickup_get_spaces - Пространства в рабочем пространстве

• clickup_get_folders - Папки в пространстве

• clickup_get_lists - Списки в папке или пространстве

• clickup_get_list - Детали одного списка

• clickup_create_list - Создать список в папке или пространстве

• clickup_delete_list - Удалить список (безвозвратно)

CRUD задач (5)

• clickup_get_task - Получить задачу по ID

• clickup_create_task - Создать задачу со всеми полями

• clickup_update_task - Обновить любое поле задачи

• clickup_get_tasks - Получить задачи в списке

• clickup_search_tasks - Поиск задач по всему рабочему пространству

Пользовательские поля (1)

• clickup_set_custom_field - Установить значение пользовательского поля

Теги (6)

• clickup_get_space_tags - Список тегов пространства

• clickup_create_space_tag - Создать тег

• clickup_edit_space_tag - Изменить тег

• clickup_delete_space_tag - Удалить тег

• clickup_add_tag_to_task - Добавить тег задаче

• clickup_remove_tag_from_task - Убрать тег с задачи

Чек-листы (6)

• clickup_create_checklist - Создать чек-лист

• clickup_edit_checklist - Изменить чек-лист

• clickup_delete_checklist - Удалить чек-лист

• clickup_create_checklist_item - Добавить пункт

• clickup_edit_checklist_item - Изменить пункт

• clickup_delete_checklist_item - Удалить пункт

Зависимости (4)

• clickup_add_dependency - Добавить зависимость

• clickup_delete_dependency - Удалить зависимость

• clickup_add_task_link - Связать задачи

• clickup_delete_task_link - Разорвать связь задач

Комментарии (5)

• clickup_create_comment - Добавить комментарий

• clickup_get_comments - Получить комментарии

• clickup_update_comment - Изменить/закрыть комментарий

• clickup_create_reply - Ответ в ветке

• clickup_get_replies - Получить ответы

Удаление задачи (1)

• clickup_delete_task - Удалить задачу

Принадлежность к нескольким спискам (2)

• clickup_add_task_to_list - Добавить задачу в дополнительный список (мультихоминг)

• clickup_remove_task_from_list - Удалить задачу из дополнительного списка

Эти операции не перемещают задачу. В ClickUp v2 API нет конечной точки для перемещения между списками. Проверено на живом API 2026-08-12: POST /list/{list}/task/{task} добавляет вторичное расположение и оставляет домашний список без изменений, а list_id в PUT /task/{id} возвращает HTTP 200 и молча игнорируется. Чтобы действительно переместить задачу и сохранить её пользовательский ID и историю, используйте веб-интерфейс ClickUp (правый клик -> Переместить). Нахождение в нескольких списках также требует платной функции Tasks-in-Multiple-Lists.

Участники рабочего пространства (2)

• clickup_get_workspace_members - Все участники рабочего пространства

• clickup_get_list_members - Участники конкретного списка

Архитектура

src/
  index.ts          # Entry: McpServer + StdioServerTransport
  client.ts         # ClickUp API v2 fetch wrapper
  types.ts          # Shared Zod schemas + jsonResult helper
  slim.ts           # Response slimming transformers
  tools/
    navigation.ts   # 7 tools
    tasks.ts        # 9 tools (CRUD + custom fields + delete + multi-list)
    tags.ts         # 6 tools
    checklists.ts   # 6 tools
    dependencies.ts # 4 tools
    comments.ts     # 5 tools
    members.ts      # 2 tools

Лицензия

MIT