MCP Server
2025.03.14
0
任务管理工作区组织AI 集成交流协作开发效率
ClickUp MCP Server 是一个用于将 ClickUp 任务与 AI 应用集成的模型上下文协议（MCP）服务器。该服务器允许 AI 代理通过标准化协议与 ClickUp 的任务、空间、列表和文件夹进行交互。
View on GitHub
Overview
基本能力
产品定位
ClickUp MCP Server 是一个用于将 ClickUp 任务与 AI 应用集成的模型上下文协议（MCP）服务器。该服务器允许 AI 代理通过标准化协议与 ClickUp 的任务、空间、列表和文件夹进行交互。
核心功能
- 任务管理：创建、更新和删除单个任务；批量移动和复制任务；设置截止日期（支持自然语言和相对时间表达式）。
- 工作区组织：完整的工作区层次结构（空间、文件夹、列表）；树形结构；对工作区组件的完整 CRUD 操作。
- 集成功能：基于名称或 ID 的项目查找；不区分大小写的名称匹配；Markdown 格式化支持；内置 API 速率限制。
适用场景
- AI 代理与 ClickUp 任务管理的集成。
- 批量操作 ClickUp 任务和列表。
- 使用自然语言设置任务截止日期。
工具列表
| 工具 | 描述 | 必需参数 |
|---|---|---|
| get_workspace_hierarchy | 获取工作区结构 | 无 |
| create_task | 创建任务 | name, (listId/listName) |
| create_bulk_tasks | 创建多个任务 | tasks[] |
| update_task | 修改任务 | taskId/taskName |
| update_bulk_tasks | 更新多个任务 | tasks[] with IDs or names |
| get_tasks | 从列表中获取任务 | listId/listName |
| get_task | 获取任务详情 | taskId/taskName |
| delete_task | 删除任务 | taskId/taskName |
| delete_bulk_tasks | 删除多个任务 | tasks[] with IDs or names |
| move_task | 移动任务 | taskId/taskName, listId/listName |
| move_bulk_tasks | 移动多个任务 | tasks[] with IDs or names, target list |
| duplicate_task | 复制任务 | taskId/taskName, listId/listName |
| create_list | 在空间中创建列表 | name, spaceId/spaceName |
| create_folder | 创建文件夹 | name, spaceId/spaceName |
| create_list_in_folder | 在文件夹中创建列表 | name, folderId/folderName |
| get_folder | 获取文件夹详情 | folderId/folderName |
| update_folder | 更新文件夹属性 | folderId/folderName |
| delete_folder | 删除文件夹 | folderId/folderName |
| get_list | 获取列表详情 | listId/listName |
| update_list | 更新列表属性 | listId/listName |
| delete_list | 删除列表 | listId/listName |
常见问题解答
- 错误处理：服务器提供清晰的错误消息，包括缺少必需参数、无效 ID 或名称、找不到项目、权限问题、API 错误和速率限制。
- 支持开发者：如果项目对你有用，请考虑支持开发者。
使用教程
使用依赖
- 获取你的凭证：
- 从 ClickUp 设置 获取 ClickUp API 密钥。
- 从你的 ClickUp 工作区 URL 获取团队 ID。
安装教程
- 转到设置中的功能（或 MCP 服务器，取决于版本）。
- 在 MCP 服务器下添加：
npx -y @taazkareem/clickup-mcp-server@latest \
--env CLICKUP_API_KEY=your_api_key_here \
--env CLICKUP_TEAM_ID=your_team_id_here
- 替换凭证并点击保存。
- 使用自然语言与你的 ClickUp 工作区交互！
调试方式
安装完成后，可以使用自然语言与 ClickUp 工作区交互，查看任务和列表的创建、更新和删除是否正常工作。