ClickUp MCP (Streamable HTTP)

MCP-сервер для REST API ClickUp с поддержкой:

• Поиска задач по всему рабочему пространству (GET /team/{team_id}/task)

• CRUD-операций с задачами (+ подзадачи)

• Базовой навигации (команды, пространства, папки, списки)

• Помощников по недавней активности (через date_updated_gt, а также журналы аудита, если доступны)

• CRUD/поиска документов (v3 API): поиск, получение, создание документов и страниц

• «Запасного выхода»: универсального инструмента для вызова любого эндпоинта API ClickUp (v2 и v3).

Этот сервер предназначен для запуска в качестве Docker-сервиса и использования в OpenWebUI и LibreChat.

Окружение

• CLICKUP_API_TOKEN (обязательно)

• CLICKUP_TEAM_ID (необязательно, если не задано, автоматически определит первую команду)

• CLICKUP_WORKSPACE_ID (необязательно; ClickUp часто называет это "team_id" в v2)

• CLICKUP_API_BASE_URL (необязательно, по умолчанию https://api.clickup.com/api/v2)

• CLICKUP_API_V3_BASE_URL (необязательно, по умолчанию https://api.clickup.com/api/v3)

Запуск (локально)

python -m clickup_mcp --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp

OpenWebUI должен подключаться к: http://clickup-mcp:8000/mcp

Инструменты

Задачи (v2 API)

• search_tasks - Поиск задач по названию/описанию

• filter_tasks - Фильтрация задач по метаданным (статус, исполнитель, даты и т.д.)

• get_task - Получение задачи по ID

• create_task - Создание новой задачи

• create_subtask - Создание подзадачи для существующей задачи

• update_task - Обновление задачи

• delete_task - Удаление задачи

• get_task_comments - Получение комментариев к задаче

• create_task_comment - Создание комментария к задаче

Навигация (v2 API)

• clickup_context - Получение контекста (ID команды/рабочего пространства и текущий пользователь)

• list_teams - Список команд/рабочих пространств ClickUp

• get_team - Получение команды по ID

• list_spaces - Список пространств в команде

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

• list_lists_in_space - Список списков (без папок) в пространстве

• list_lists_in_folder - Список списков в папке

• list_tasks_in_list - Список задач в списке

Документы (v3 API)

• search_docs - Поиск/список всех документов в рабочем пространстве

• get_doc - Получение документа по ID (включает список страниц)

• create_doc - Создание нового документа

Страницы (v3 API)

• list_doc_pages - Список всех страниц в документе

• get_doc_page_listing - Получение иерархической структуры страниц документа

• get_doc_page - Получение конкретной страницы (с содержимым)

• create_doc_page - Создание новой страницы в документе

• update_doc_page - Обновление/редактирование страницы (замена, добавление в конец или начало содержимого)

Утилиты

• recent_activity - Получение недавней активности (журналы аудита или недавно обновленные задачи)

• clickup_api_request - Универсальный «запасной выход» для API v2

• clickup_v3_api_request - Универсальный «запасной выход» для API v3

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