ClickUp MCP Server

基本能力

产品定位

ClickUp MCP Server 是一个用于集成 ClickUp 任务管理与 AI 应用的中间件服务，提供标准化的协议接口，使 AI 代理能够高效地管理和操作 ClickUp 中的任务和资源。

核心功能

• 资源管理：列出和读取 ClickUp 任务，查看任务详情、状态和分配情况。
• 工作区组织：创建和管理空间、文件夹、列表，支持通过 ID 或名称灵活识别。
• 任务操作：创建单个或批量任务，移动任务，复制任务，设置优先级和截止日期，分配团队成员。
• 信息检索：获取完整的空间、文件夹和列表层次结构，列出可用状态，按名称查找任务。
• 智能名称解析：支持通过名称而非 ID 引用列表和文件夹，全局搜索，不区分大小写匹配。
• AI 集成：生成任务描述，总结任务，分析优先级，提供 AI 驱动的任务推荐。
• 安全性：安全的 API 密钥管理，基于环境的配置。

适用场景

• 团队协作：通过 AI 代理自动化管理 ClickUp 任务，提升团队效率。
• 任务自动化：批量创建、移动或更新任务，减少手动操作。
• 智能分析：利用 AI 分析任务优先级和状态，优化工作流程。

工具列表

1. workspace_hierarchy：列出 ClickUp 工作区的完整层次结构，包括空间、文件夹和列表的 ID 和状态。
2. create_task：创建新任务，支持设置名称、列表、描述、状态、优先级等。
3. create_bulk_tasks：批量创建任务，支持多任务同时操作。
4. create_list：在空间中创建新列表。
5. create_folder：在空间中创建新文件夹。
6. create_list_in_folder：在文件夹中创建新列表。
7. move_task：将任务移动到不同的列表。
8. duplicate_task：复制任务到指定列表。
9. update_task：更新现有任务的名称、描述、状态等。

常见问题解答

• 如何获取 API 密钥：从 ClickUp 设置 > 应用 获取。
• 如何配置环境变量：创建 .env 文件，设置 CLICKUP_API_KEY 和 TEAM_ID。
• 名称解析失败：确保名称拼写正确，且不区分大小写。

使用教程

使用依赖

• 确保已安装 Node.js 和 npm。

安装教程

1. 推荐使用 npx：

npx @taazkareem/clickup-mcp-server

1. 全局安装：

npm install -g @taazkareem/clickup-mcp-server

配置

1. 获取 ClickUp API 密钥和团队 ID。
2. 创建 .env 文件：

CLICKUP_API_KEY=your_api_key_here
TEAM_ID=your_team_id_here

调试方式

1. 启动开发模式：

npm run dev

1. 检查日志和错误信息，确保 API 密钥和团队 ID 正确。

许可证

该项目遵循 MIT 开源许可条款。