Skip to main content
Glama
deenesjakoruzh

ClickUp MCP Server

by taazkareem
npmGitHub
TypeScript
MIT License
2,170
388
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

支持人数

一个模型上下文协议 (MCP) 服务器，用于将 ClickUp 任务与 AI 应用程序集成。该服务器允许 AI 代理通过标准化协议与 ClickUp 任务、空间、列表和文件夹进行交互。

🚀状态更新： v0.7.2 现已推出，具有完整的时间跟踪支持和文档管理功能。

设置

  1. 获取您的凭证：
    • ClickUp 设置中的 ClickUp API 密钥
    • 来自 ClickUp 工作区 URL 的团队 ID
  2. 选择托管安装（发送 webhook）或 NPX 安装（下载到本地路径并安装依赖项）
  3. 使用自然语言来管理您的工作区！

Smithery 安装（快速启动）

服务器托管在Smithery上。在那里，您可以预览可用的工具或复制命令以在特定的客户端应用上运行。

NPX 安装

将此条目添加到客户端的 MCP 设置 JSON 文件中：

{ "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（服务器发送事件）模式下运行：

{ "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

特征

📝 任务管理🏷️标签管理
• 创建、更新和删除任务• 随处移动和复制任务• 支持单个和批量操作• 使用自然语言设置开始/截止日期• 创建和管理子任务• 添加评论和附件• 创建、更新和删除空间标签• 在任务中添加和删除标签• 使用自然语言颜色命令• 自动对比前景色• 查看所有空间标签• 跨工作区基于标签的任务组织
⏱️时间跟踪🌳工作空间组织
• 查看任务的时间条目• 开始/停止任务的时间跟踪• 添加手动时间条目• 删除时间条目• 查看当前正在运行的计时器• 跟踪计费和不计费时间• 导航空间、文件夹和列表• 创建和管理文件夹• 组织空间内的列表• 在文件夹中创建列表• 查看工作区层次结构• 高效的路径导航
📄文档管理👥会员管理
• 所有工作区的文档列表• 文档页面列表• 文档页面详细信息• 文档创建• 文档页面更新（附加和前置）• 通过姓名或电子邮件查找工作区成员• 解析任务的受让人• 查看成员详细信息和权限• 在创建过程中将任务分配给用户• 支持用户 ID、电子邮件或用户名• 团队范围的用户管理
⚡集成功能
• 全局名称或基于 ID 的查找• 不区分大小写的匹配• Markdown 格式支持• 内置速率限制• 错误处理和验证• 全面的 API 覆盖

可用工具

工具描述必需参数
获取工作区层次结构获取工作区结构没有任何
创建任务创建任务name ，（ listId / listName ）
创建批量任务创建多个任务tasks[]
更新任务修改任务taskId / taskName
更新批量任务更新多个任务带有 ID 或名称的tasks[]
获取任务从列表中获取任务listId / listName
获取任务获取单个任务详情taskId / taskName （具有智能消歧功能）
获取工作区任务通过过滤获取任务至少一个过滤器（标签、list_id、space_id 等）
获取任务评论获取任务评论taskId / taskName
创建任务评论为任务添加评论commentText ，（ taskId /（ taskName + listName ））
附加任务文件将文件附加到任务taskId / taskName ，（ file_data或file_url ）
删除任务删除任务taskId / taskName
删除批量任务删除多个任务带有 ID 或名称的tasks[]
移动任务移动任务taskId / taskName ， listId / listName
移动批量任务移动多个任务带有 ID 或名称、目标列表的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
更新空间标签更新标签tagName 、 spaceId / spaceName
删除空间标签删除标签tagName 、 spaceId / spaceName
将标签添加到任务为任务添加标签tagName ， taskId /（ taskName + listName ）
从任务中删除标签从任务中删除标签tagName ， taskId /（ taskName + listName ）
获取任务时间条目获取任务的时��条目taskId / taskName
开始时间跟踪开始对任务进行时间跟踪taskId / taskName
停止时间跟踪停止当前时间跟踪没有任何
添加时间条目为任务添加手动时间输入taskId / taskName ， start ， duration
删除时间条目删除时间条目timeEntryId
获取当前时间条目获取当前正在运行的计时器没有任何
获取工作区成员获取所有工作区成员没有任何
通过名称查找成员通过姓名或电子邮件查找会员nameOrEmail
解析分配者将成员名称解析为 IDassignees[]
创建文档创建文档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 ID、 name / sub_title 、 content / content_edit_mode / content_format

请参阅完整文档以了解可选参数和高级用法。

会员管理工具

创建任务时，您现在可以使用assignees参数分配用户。该参数接受用户ID、邮箱或用户名的数组：

{ "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 或引用并不意味着与相关公司有任何关联或获得其认可。所有商标和品牌名称均为其各自所有者的财产。本项目为独立作品，与文中提及的任何第三方公司均无正式关联或赞助。

Deploy 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.

实现 AI 与 ClickUp 任务的集成，通过标准化协议支持资源管理、任务操作、工作区组织和 AI 驱动的任务推荐。

  1. Smithery 安装（快速启动）
    1. NPX 安装
      1. 使用 SSE 支持运行
        1. Docker-compose 示例
          1. 特征
            1. 可用工具
              1. 会员管理工具
                1. 提示
                  1. 错误处理
                    1. 支持开发者
                      1. 致谢
                        1. 贡献
                          1. 执照
                            1. 免责声明

                              Related Resources

                              Related MCP Servers

                              • 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 -
                                25
                                14
                                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 -
                                3
                                2
                                MIT License

                              • ClickUp MCP Server

                                windalfin
                                -
                                security
                                A
                                license
                                -
                                quality
                                A 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 -
                                2,170
                                2
                                MIT License

                              • ClickUp MCP Server

                                DiversioTeam
                                A
                                security
                                A
                                license
                                A
                                quality
                                Enables 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 -
                                28
                                3
                                MIT License
                                • Apple
                                • Linux

                              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