Skip to main content
Glama
deenesjakoruzh

ClickUp MCP Server

by taazkareem
npmGitHub
TypeScript
MIT License
605
201
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Всего сторонников

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

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

Настраивать

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

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

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

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

ИнструментОписаниеТребуемые параметры
получить_иерархию_рабочего_пространстваПолучить структуру рабочего пространстваНикто
создать_задачуСоздать задачу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 или ссылок не подразумевает какой-либо связи с соответствующими компаниями или их одобрения. Все товарные знаки и бренды являются собственностью их владельцев. Этот проект является независимой работой и официально не связан или не спонсируется какой-либо упомянутой сторонней компанией.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

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

  1. Монтаж кузнечных изделий (быстрый старт)
    1. Установка NPX
      1. Работает с поддержкой SSE
        1. Пример Docker-compose
          1. Функции
            1. Доступные инструменты
              1. Инструменты управления участниками
                1. Подсказки
                  1. Обработка ошибок
                    1. Поддержать разработчика
                      1. Благодарности
                        1. Внося вклад
                          1. Лицензия
                            1. Отказ от ответственности

                              Related Resources

                              Related MCP Servers

                              • Google Tasks MCP Server

                                zcaceres
                                -
                                security
                                A
                                license
                                -
                                quality
                                Integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.
                                Last updated -
                                15
                                TypeScript
                                MIT License

                              • Project Handoffs MCP Server

                                davidorex
                                A
                                security
                                F
                                license
                                A
                                quality
                                Facilitates AI session handoffs and next steps tracking through project-based organization, supporting task prioritization and seamless workflow management.
                                Last updated -
                                8
                                6
                                JavaScript

                              • ClickUp MCP Server

                                Nazruden
                                A
                                security
                                A
                                license
                                A
                                quality
                                This server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
                                Last updated -
                                5
                                56
                                7
                                TypeScript
                                MIT License
                                • Apple

                              • ClickUp MCP Server

                                v4lheru
                                A
                                security
                                A
                                license
                                A
                                quality
                                An 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 -
                                40
                                605
                                TypeScript
                                MIT License

                              View all related MCP servers

                              Appeared in Searches

                              New MCP Servers

                              MCP directory API

                              We provide all the information about MCP servers via our MCP API.

                              curl -X GET 'https://glama.ai/api/mcp/v1/servers/taazkareem/clickup-mcp-server'

                              If you have feedback or need assistance with the MCP directory API, please join our Discord server