ClickUp MCP-сервер

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

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

Настраивать

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

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

Сервер размещен на 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 ).

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

Функции

📝 Управление задачами	🏷️ Управление тегами
• Создание, обновление и удаление задач • Перемещение и дублирование задач в любом месте • Поддержка одиночных и групповых операций • Установка дат начала/срока выполнения с помощью естественного языка • Создание и управление подзадачами • Добавление комментариев и вложений	• Создание, обновление и удаление тегов пространства • Добавление и удаление тегов из задач • Использование команд цвета естественного языка • Автоматическое контрастирование цветов переднего плана • Просмотр всех тегов пространства • Организация задач на основе тегов в рабочем пространстве
⏱️ Учет времени	🌳 Организация рабочего пространства
• Просмотр записей времени для задач • Запуск/остановка отслеживания времени для задач • Добавление записей времени вручную • Удаление записей времени • Просмотр текущего таймера • Отслеживание оплачиваемого и неоплачиваемого времени	• Навигация по пространствам, папкам и спискам • Создание и управление папками • Организация списков в пространствах • Создание списков в папках • Просмотр иерархии рабочих пространств • Эффективная навигация по путям
📄 Управление документами	⚡ Возможности интеграции
• Список документов по всему рабочему пространству • Список страниц документов • Сведения о страницах документов • Создание документов • Обновление страниц документов (добавление и добавление)	• Глобальный поиск по имени или идентификатору • Сопоставление без учета регистра • Поддержка форматирования 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`
получить_текущее_время_записи	Получить текущий работающий таймер	Никто
создать_документ	Создать документ	`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`

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

Подсказки

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

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

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

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

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

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

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

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

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

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

Внося вклад

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

Лицензия

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

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

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

ClickUp MCP Server

Integrations

Настраивать

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

Установка NPX

Функции

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

Подсказки

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

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

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

Внося вклад

Лицензия

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

Tools

Related Resources

Related MCP Servers

ClickUp MCP Server

Browser Automation MCP Server

ClickUp MCP Server

Metabase MCP Server

Appeared in Searches

New MCP Servers