ClickUp MCP-сервер

Всего сторонников Звезды GitHub Обслуживание

Сервер Model Context Protocol (MCP) для интеграции задач ClickUp с приложениями AI. Этот сервер позволяет агентам AI взаимодействовать с задачами ClickUp, пространствами, списками и папками через стандартизированный протокол.

🚀 Обновление статуса: теперь доступна версия v0.7.2 с полной поддержкой функций учета рабочего времени и управления документами.

Настраивать

Получите ваши учетные данные:
- Ключ API ClickUp из настроек ClickUp
- Идентификатор команды из URL-адреса вашего рабочего пространства ClickUp
Выберите либо размещенную установку (отправляет веб-хуки), либо установку NPX (загружает по локальному пути и устанавливает зависимости)
Используйте естественный язык для управления своим рабочим пространством!

Related MCP server: ClickUp MCP Server

Монтаж кузнечных изделий (быстрый старт)

значок кузнеца

Сервер размещен на Smithery . Там вы можете просмотреть доступные инструменты или скопировать команды для запуска в вашем конкретном клиентском приложении.

Установка NPX

Версия НПМ Статус зависимости Загрузки НПМ

Добавьте эту запись в JSON-файл настроек MCP вашего клиента:

{ "mcpServers": { "ClickUp": { "command": "npx", "args": [ "-y", "@taazkareem/clickup-mcp-server@latest" ], "env": { "CLICKUP_API_KEY": "your-api-key", "CLICKUP_TEAM_ID": "your-team-id", "DOCUMENT_SUPPORT": "true" } } } }

Или используйте эту команду npx:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

Примечание: если не передать "DOCUMENT_SUPPORT": "true", значение по умолчанию будет false и поддержка документов не будет активна.

Кроме того, вы можете использовать переменную окружения DISABLED_TOOLS или аргумент --env DISABLED_TOOLS для отключения определенных инструментов. Укажите разделенный запятыми список имен инструментов для отключения (например, create_task,delete_task ).

Пожалуйста, отключите ненужные вам инструменты, если у вас возникли проблемы с количеством инструментов или ограничениями контекста.

Работает с поддержкой SSE

Сервер можно запустить в режиме SSE (Server-Sent Events), установив следующие переменные среды:

Или через командную строку:

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=8000

Пример Docker-compose

version: '3.8' services: clickup-mcp-server: build: context: . dockerfile: Dockerfile ports: - '3231:8000' environment: - CLICKUP_API_KEY=${CLICKUP_API_KEY} - CLICKUP_TEAM_ID=${CLICKUP_TEAM_ID} - ENABLE_SSE=true - LOG_LEVEL=info - DOCUMENT_SUPPORT=true volumes: - ./src:/app/src restart: unless-stopped healthcheck: test: ["CMD", "curl", "-f", "http://localhost:8000/health"] interval: 30s timeout: 10s retries: 3 start_period: 5s

Функции

📝 Управление задачами	🏷️ Управление тегами
• Создание, обновление и удаление задач • Перемещение и дублирование задач в любом месте • Поддержка одиночных и групповых операций • Установка дат начала/срока выполнения с помощью естественного языка • Создание и управление подзадачами • Добавление комментариев и вложений	• Создание, обновление и удаление тегов пространства • Добавление и удаление тегов из задач • Использование команд цвета естественного языка • Автоматическое контрастирование цветов переднего плана • Просмотр всех тегов пространства • Организация задач на основе тегов в рабочем пространстве
⏱️ Учет времени	🌳 Организация рабочего пространства
• Просмотр записей времени для задач • Запуск/остановка отслеживания времени для задач • Добавление записей времени вручную • Удаление записей времени • Просмотр текущего таймера • Отслеживание оплачиваемого и неоплачиваемого времени	• Навигация по пространствам, папкам и спискам • Создание и управление папками • Организация списков в пространствах • Создание списков в папках • Просмотр иерархии рабочего пространства • Эффективная навигация по пути
📄 Управление документами	👥 Управление участниками
• Список документов по всему рабочему пространству • Список страниц документов • Сведения о страницах документов • Создание документов • Обновление страниц документов (добавление и добавление)	• Поиск участников рабочей области по имени или адресу электронной почты • Назначение исполнителей задач • Просмотр сведений об участниках и разрешений • Назначение задач пользователям во время создания • Поддержка идентификаторов пользователей, адресов электронной почты или имен пользователей • Управление пользователями в рамках всей команды
⚡ Возможности интеграции
• Глобальный поиск по имени или идентификатору • Сопоставление без учета регистра • Поддержка форматирования Markdown • Встроенное ограничение скорости • Обработка ошибок и проверка • Всестороннее покрытие API

Доступные инструменты

Инструмент	Описание	Требуемые параметры
получить_иерархию_рабочего_пространства	Получить структуру рабочего пространства	Никто
создать_задачу	Создать задачу	`name` , ( `listId` / `listName` )
создать_массовые_задачи	Создать несколько задач	`tasks[]`
обновить_задачу	Изменить задачу	`taskId` / `taskName`
обновление_массовых_задач	Обновить несколько задач	`tasks[]` с идентификаторами или именами
получить_задачи	Получить задачи из списка	`listId` / `listName`
получить_задачу	Получить детали отдельной задачи	`taskId` / `taskName` (с интеллектуальным разрешением неоднозначностей)
получить_рабочие_задачи	Получайте задания с фильтрацией	По крайней мере один фильтр (теги, list_ids, space_ids и т. д.)
получить_комментарии_к_задаче	Получить комментарии по задаче	`taskId` / `taskName`
создать_задачу_комментарий	Добавить комментарий к задаче	`commentText` , ( `taskId` / ( `taskName` + `listName` ))
прикрепить_файл_задачи	Прикрепить файл к задаче	`taskId` / `taskName` , ( `file_data` или `file_url` )
удалить_задачу	Удалить задачу	`taskId` / `taskName`
удалить_массовые_задачи	Удалить несколько задач	`tasks[]` с идентификаторами или именами
переместить_задачу	Переместить задачу	`taskId` / `taskName` , `listId` / `listName`
перемещение_массовых_задач	Переместить несколько задач	`tasks[]` с идентификаторами или именами, целевой список
дубликат_задачи	Копировать задачу	`taskId` / `taskName` , `listId` / `listName`
создать_список	Создать список в космосе	`name` , `spaceId` / `spaceName`
создать_папку	Создать папку	`name` , `spaceId` / `spaceName`
создать_список_в_папке	Создать список в папке	`name` , `folderId` / `folderName`
получить_папку	Получить сведения о папке	`folderId` / `folderName`
обновить_папку	Обновить свойства папки	`folderId` / `folderName`
удалить_папку	Удалить папку	`folderId` / `folderName`
получить_список	Получить список деталей	`listId` / `listName`
список_обновлений	Обновить свойства списка	`listId` / `listName`
удалить_список	Удалить список	`listId` / `listName`
получить_пространственные_теги	Получить космические теги	`spaceId` / `spaceName`
создать_пространственный_тег	Создать тег	`tagName` , `spaceId` / `spaceName`
update_space_tag	Обновить тег	`tagName` , `spaceId` / `spaceName`
удалить_пробел_тег	Удалить тег	`tagName` , `spaceId` / `spaceName`
добавить_тег_к_задаче	Добавить тег к задаче	`tagName` , `taskId` /( `taskName` + `listName` )
удалить_тег_из_задачи	Удалить тег из задачи	`tagName` , `taskId` /( `taskName` + `listName` )
получить_задания_времени_записей	Получить записи времени для задачи	`taskId` / `taskName`
начало_времени_отслеживания	Начать отслеживание времени по задаче	`taskId` / `taskName`
stop_time_tracking	Остановить отслеживание текущего времени	Никто
добавить_время_входа	Добавить ручной ввод времени в задачу	`taskId` / `taskName` , `start` , `duration`
удалить_время_записи	Удалить запись времени	`timeEntryId`
получить_текущее_время_записи	Получить текущий работающий таймер	Никто
получить_членов_рабочего_пространства	Получить всех участников рабочего пространства	Никто
найти_участника_по_имени	Найти участника по имени или адресу электронной почты	`nameOrEmail`
resolve_assignees	Преобразовать имена участников в идентификаторы	`assignees[]`
создать_документ	Создать документ	`workspaceId` , `name` , `parentId` / `parentType` , `visibility` , `create_pages`
получить_документ	Получить документ	`workspaceId` / `documentId`
список_документов	Список документов	`workspaceId` , `documentId` / `creator` / `deleted` / `archived` / `parent_id` / `parent_type` / `limit` / `next_cursor`
список_страниц_документов	Список страниц документа	`documentId` / `documentName`
получить_страницы_документов	Получить страницы документа	`documentId` / `documentName` , `pageIds`
создать_страницы_документов	Создать страницу документа	`workspaceId` / `documentId` , `parent_page_id` / `name` / `sub_title` , `content` / `content_format`
обновить_страницу_документа	Обновить страницу документа	`workspaceId` / `documentId` , `name` / `sub_title` , `content` / `content_edit_mode` / `content_format`

Дополнительные параметры и расширенное использование см. в полной документации .

Инструменты управления участниками

При создании задач теперь можно назначать пользователей с помощью параметра assignees . Параметр принимает массив идентификаторов пользователей, адресов электронной почты или имен пользователей:

{ "name": "New Task", "description": "This is a new task.", "assignees": ["jdoe@example.com", "Jane Smith"] // Emails, usernames, or user IDs }

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

Подсказки

Пока не реализовано и не поддерживается всеми клиентскими приложениями. Запросите функцию для внедрения Prompt, которая будет наиболее полезна для вашего рабочего процесса (не будучи слишком конкретной). Примеры:

Быстрый	Цель	Функции
суммировать_задачи	Обзор задачи	Сводка статуса, приоритеты, отношения
анализировать_приоритеты	Приоритетная оптимизация	Анализ распределения, секвенирование
сгенерировать_описание	Создание описания задачи	Цели, критерии, зависимости

Обработка ошибок

Сервер выдает понятные сообщения об ошибках для:

Отсутствуют обязательные параметры
Недействительные идентификаторы или имена
Элементы не найдены
Проблемы с разрешениями
Ошибки API
Ограничение скорости

Переменная среды LOG_LEVEL может быть указана для управления подробностью журналов сервера. Допустимые значения: trace , debug , info , warn и error (по умолчанию). Это также может быть указано в командной строке, например, --env LOG_LEVEL=info .

Поддержать разработчика

При использовании этого сервера вы можете иногда видеть небольшое сообщение спонсора со ссылкой на этот репозиторий, включенное в ответы инструмента. Надеюсь, вы сможете поддержать проект! Если вы найдете этот проект полезным, пожалуйста, рассмотрите возможность поддержки:

Спонсор ТаазКарим

Благодарности

Особая благодарность ClickUp за их превосходный API и сервисы, которые делают эту интеграцию возможной.

Внося вклад

Вклады приветствуются! Подробности читайте в нашем Руководстве по вкладам .

Лицензия

Лицензия: Массачусетский технологический институт

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

Отказ от ответственности

Это программное обеспечение использует сторонние API и может ссылаться на товарные знаки или бренды, принадлежащие третьим лицам. Использование таких API или ссылок не подразумевает какой-либо связи с соответствующими компаниями или их одобрения. Все товарные знаки и бренды являются собственностью их владельцев. Этот проект является независимой работой и официально не связан или не спонсируется какой-либо упомянутой сторонней компанией.

ClickUp MCP Server