clickup-mcp-server: A ClickUp MCP Server

基本能力

产品定位

clickup-mcp-server 是一个用于与 ClickUp API 交互和自动化的模型上下文协议服务器，旨在帮助 AI 系统自动化管理 ClickUp 工作空间中的任务和项目。

核心功能

1. 任务管理
2. 创建、更新和删除任务
3. 移动和复制任务
4. 设置任务属性（如截止日期、优先级和标签）
5. 管理子任务
6. 添加评论和附件

7. 支持单任务和批量操作

8. 工作空间组织

9. 导航和管理工作空间、空间、文件夹和列表
10. 创建、更新和删除空间和文件夹

11. 查看完整的工作空间层次结构

12. 格式化与显示

13. 支持完整的 Markdown 格式
14. HTML 转换以确保在 ClickUp 中正确渲染

15. 增强复杂项目结构的显示

16. 开发者体验

17. 全面的错误处理和验证
18. 清晰一致的 API 响应
19. 详细的工具文档

适用场景

• 任务管理自动化：AI 系统可以自动创建、更新和管理任务
• 项目规划：自动生成任务计划和项目结构
• 状态报告：生成任务状态摘要和进度报告

工具列表

1. 工作空间/团队工具
2. get_workspaces：获取所有工作空间

3. navigate_workspace：通过路径符号导航工作空间层次结构

4. 空间工具

5. get_spaces：获取工作空间中的所有空间
6. create_space：创建新空间

7. get_space_hierarchy：获取空间的完整层次结构

8. 文件夹工具

9. get_folders：获取空间中的所有文件夹
10. create_folder：创建新文件夹
11. update_folder：更新文件夹名称

12. delete_folder：删除文件夹

13. 列表/看板工具

14. get_lists：获取空间中的所有列表
15. create_list：创建新列表

16. organize_lists：按位置组织列表

17. 任务工具

18. get_tasks：获取列表中的所有任务
19. create_task：创建新任务
20. update_task：更新任务属性
21. delete_task：删除任务
22. move_task：移动任务到不同列表
23. add_comment：添加评论到任务
24. add_attachment：通过 URL 添加附件到任务

常见问题解答

• 如何获取 API 密钥：从 ClickUp API Settings 获取
• 如何调试：使用 -v 或 -vv 标志运行服务器以增加详细程度

使用教程

使用依赖

• Python 3.10 或更高版本
• ClickUp 账户和 API 密钥

安装教程

1. 使用 uv（推荐） uv --directory "/path/to/clickup-mcp-server" run clickup-mcp-server --api-key YOUR_API_KEY

2. 使用 PIP pip install clickup-mcp-server python -m clickup_mcp_server --api-key YOUR_API_KEY

调试方式

1. 使用详细模式运行服务器： uvx clickup-mcp-server -vv

2. 使用 MCP 检查器调试： npx @modelcontextprotocol/inspector uvx clickup-mcp-server

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。