A
securityA
licenseA
qualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
14
14
MIT License
Сервер Model Context Protocol (MCP) для интеграции задач ClickUp с приложениями AI. Этот сервер позволяет агентам AI взаимодействовать с задачами ClickUp, пространствами, списками и папками через стандартизированный протокол.
🚀 Обновление статуса: теперь доступна версия v0.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 ).
Пожалуйста, отключите ненужные вам инструменты, если у вас возникли проблемы с количеством инструментов или ограничениями контекста.
Работает с поддержкой SSE
Сервер можно запустить в режиме SSE (Server-Sent Events), установив следующие переменные среды:
{
"mcpServers": {
"ClickUp": {
"command": "npx",
"args": [
"-y",
"@taazkareem/clickup-mcp-server@latest"
],
"env": {
"CLICKUP_API_KEY": "your-api-key",
"CLICKUP_TEAM_ID": "your-team-id",
"ENABLE_SSE": "true",
"PORT": "8000" // Optional, defaults to 3231
}
}
}
}
Или через командную строку:
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 |
Доступные инструменты
Инструмент | Описание | Требуемые параметры |
Получить структуру рабочего пространства | Никто | |
Создать задачу |
, (
/
) | |
Создать несколько задач |
| |
Изменить задачу |
/
| |
Обновить несколько задач |
с идентификаторами или именами | |
Получить задачи из списка |
/
| |
Получить детали отдельной задачи |
/
(с интеллектуальным разрешением неоднозначностей) | |
Получайте задания с фильтрацией | По крайней мере один фильтр (теги, list_ids, space_ids и т. д.) | |
Получить комментарии по задаче |
/
| |
Добавить комментарий к задаче |
, (
/ (
+
)) | |
Прикрепить файл к задаче |
/
, (
или
) | |
Удалить задачу |
/
| |
Удалить несколько задач |
с идентификаторами или именами | |
Переместить задачу |
/
,
/
| |
Переместить несколько задач |
с идентификаторами или именами, целевой список | |
Копировать задачу |
/
,
/
| |
Создать список в космосе |
,
/
| |
Создать папку |
,
/
| |
Создать список в папке |
,
/
| |
Получить сведения о папке |
/
| |
Обновить свойства папки |
/
| |
Удалить папку |
/
| |
Получить список деталей |
/
| |
Обновить свойства списка |
/
| |
Удалить список |
/
| |
Получить космические теги |
/
| |
Создать тег |
,
/
| |
Обновить тег |
,
/
| |
Удалить тег |
,
/
| |
Добавить тег к задаче |
,
/(
+
) | |
Удалить тег из задачи |
,
/(
+
) | |
Получить записи времени для задачи |
/
| |
Начать отслеживание времени по задаче |
/
| |
Остановить отслеживание текущего времени | Никто | |
Добавить ручной ввод времени в задачу |
/
,
,
| |
Удалить запись времени |
| |
Получить текущий работающий таймер | Никто | |
Получить всех участников рабочего пространства | Никто | |
Найти участника по имени или адресу электронной почты |
| |
Преобразовать имена участников в идентификаторы |
| |
Создать документ |
,
,
/
,
,
| |
Получить документ |
/
| |
Список документов |
,
/
/
/
/
/
/
/
| |
Список страниц документа |
/
| |
Получить страницы документа |
/
,
| |
Создать страницу документа |
/
,
/
/
,
/
| |
Обновить страницу документа |
/
,
/
,
/
/
|
Дополнительные параметры и расширенное использование см. в полной документации .
Инструменты управления участниками
При создании задач теперь можно назначать пользователей с помощью параметра 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 или ссылок не подразумевает какой-либо связи с соответствующими компаниями или их одобрения. Все товарные знаки и бренды являются собственностью их владельцев. Этот проект является независимой работой и официально не связан или не спонсируется какой-либо упомянутой сторонней компанией.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Обеспечивает интеграцию ИИ с задачами ClickUp, поддерживая управление ресурсами, выполнение задач, организацию рабочего пространства и рекомендации задач на основе ИИ через стандартизированный протокол.
- Монтаж кузнечных изделий (быстрый старт)
- Установка NPX
- Работает с поддержкой SSE
- Пример Docker-compose
- Функции
- Доступные инструменты
- Инструменты управления участниками
- Подсказки
- Обработка ошибок
- Поддержать разработчика
- Благодарности
- Внося вклад
- Лицензия
- Отказ от ответственности
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.Last updated -02MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -1,7032MIT License
- AsecurityAlicenseAqualityEnables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.Last updated -283MIT License
Appeared in Searches
- A method or tool for managing ClickUp task list custom fields with read and write update capabilities
- Automating Task Assignment Based on Priority with Reshuffling Capabilities
- Tools and platforms for task management
- A tool for planning and managing software projects
- A server for software engineers that integrates with Jira and Slack