Clickup Server
ClickUp MCP Server - 通过模型上下文协议（Model Context Protocol）将 ClickUp 任务管理与 AI 集成
一个用于将 ClickUp 任务与 AI 应用集成的 Model Context Protocol (MCP) 服务器。此服务器允许 AI 代理通过标准化协议与 ClickUp 任务、空间、列表和文件夹进行交互。
🚧 状态更新: 推出 v0.6.9 将添加全局任务查找（带有智能消歧）、自然语言表达的任务开始日期支持、完整标签支持（包括自然语言标签颜色命令）、子任务支持、自定义 ID 支持和日志修复
设置
- 获取你的凭据：
- 从 ClickUp 设置 获取 ClickUp API 密钥
- 从你的 ClickUp 工作区 URL 中获取团队 ID
- 选择托管安装（发送 Webhook）或 NPX 安装（下载到本地路径并安装依赖项）
- 使用自然语言管理你的工作区！
Smithery 安装（快速启动）
该服务器托管在 Smithery 上。在那里，你可以预览可用工具或将命令复制到特定客户端应用中运行。
NPX 安装
将以下条目添加到客户端的 MCP 设置 JSON 文件中：
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"
}
}
}
}或者使用以下 npx 命令：
npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id
功能
| 📝 任务管理 | 🏷️ 标签管理 |
|---|---|
| • 创建、更新和删除任务 • 在任何位置移动和复制任务 • 支持单个和批量操作 • 使用自然语言设置开始/截止日期 • 创建和管理子任务 • 添加评论和附件 |
• 创建、更新和删除空间标签 • 向任务添加和移除标签 • 使用自然语言颜色命令 • 自动对比前景色 • 查看所有空间标签 • 基于标签的工作区任务组织 |
| ⏱️ 时间跟踪 | 🌳 工作区组织 |
| • 查看任务的时间条目 • 开始/停止任务的时间跟踪 • 添加手动时间条目 • 删除时间条目 • 查看当前正在运行的计时器 • 跟踪可开票和不可开票时间 |
• 导航空间、文件夹和列表 • 创建和管理文件夹 • 在空间内组织列表 • 在文件夹中创建列表 • 查看工作区层次结构 • 高效路径导航 |
| ⚡ 集成功能 | |
| • 全局名称或 ID 查找 • 不区分大小匹配 • Markdown 格式支持 • 内置速率限制 • 错误处理和验证 • 全面的 API 覆盖 |
可用工具
| 工具 | 描述 | 必需参数 |
|---|---|---|
| get_workspace_hierarchy | 获取工作区结构 | 无 |
| create_task | 创建任务 | name, (listId/listName) |
| create_bulk_tasks | 创建多个任务 | tasks[] |
| update_task | 修改任务 | taskId/taskName |
| update_bulk_tasks | 更新多个任务 | 包含 ID 或名称的 tasks[] |
| get_tasks | 从列表获取任务 | listId/listName |
| get_task | 获取单个任务详情 | taskId/taskName（带智能消歧） |
| get_workspace_tasks | 过滤后获取任务 | 至少一个过滤器（标签、列表 ID、空间 ID 等） |
| get_task_comments | 获取任务评论 | taskId/taskName |
| create_task_comment | 添加评论到任务 | commentText, (taskId/(taskName+listName)) |
| attach_task_file | 附加文件到任务 | taskId/taskName, (file_data 或 file_url) |
| delete_task | 删除任务 | taskId/taskName |
| delete_bulk_tasks | 删除多个任务 | 包含 ID 或名称的 tasks[] |
| move_task | 移动任务 | taskId/taskName, listId/listName |
| move_bulk_tasks | 移动多个任务 | 包含 ID 或名称的 tasks[], 目标列表 |
| 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 |
| get_space_tags | 获取空间标签 | spaceId/spaceName |
| create_space_tag | 创建标签 | tagName, spaceId/spaceName |
| update_space_tag | 更新标签 | tagName, spaceId/spaceName |
| delete_space_tag | 删除标签 | tagName, spaceId/spaceName |
| add_tag_to_task | 向任务添加标签 | tagName, taskId/(taskName+listName) |
| remove_tag_from_task | 从任务中移除标签 | tagName, taskId/(taskName+listName) |
| get_task_time_entries | 获取任务的时间条目 | taskId/taskName |
| start_time_tracking | 开始任务的时间跟踪 | taskId/taskName |
| stop_time_tracking | 停止当前时间跟踪 | 无 |
| add_time_entry | 添加手动时间条目到任务 | taskId/taskName, start, duration |
| delete_time_entry | 删除时间条目 | timeEntryId |
| get_current_time_entry | 获取当前正在运行的计时器 | 无 |
查看 完整文档 了解可选参数和高级用法。
提示
尚未实现且并非所有客户端应用都支持。请求一个对你工作流程最有帮助的提示实现（不要太具体）。示例：
| 提示 | 目的 | 功能 |
|---|---|---|
| summarize_tasks | 任务概述 | 状态摘要、优先级、关系 |
| analyze_priorities | 优先级优化 | 分布分析、排序 |
| generate_description | 创建任务描述 | 目标、标准、依赖 |
错误处理
服务器为以下情况提供清晰的错误消息：
- 缺少必需参数
- 无效的 ID 或名称
- 项目未找到
- 权限问题
- API 错误
- 速率限制
可以通过指定 LOG_LEVEL 环境变量来控制服务器日志的详细程度。有效值为 trace、debug、info、warn 和 error（默认值）。
也可以在命令行上指定，例如 --env LOG_LEVEL=info。
支持开发者
使用此服务器时，你可能会偶尔看到包含指向此存储库链接的小型赞助信息。希望你能支持该项目！
如果你觉得这个项目有用，请考虑支持：
致谢
特别感谢 ClickUp 提供出色的 API 和服务，使此集成成为可能。
贡献
欢迎贡献！请阅读我们的 贡献指南 以获取详细信息。
许可证
本项目根据 MIT 许可证授权——详见 LICENSE 文件。
免责声明
本软件使用第三方 API 并可能引用第三方拥有的商标或品牌。使用此类 API 或引用并不意味着与相关公司有任何隶属关系或得到其认可。所有商标和品牌名称均为其各自所有者的财产。本项目是独立作品，与提到的任何第三方公司均无官方关联或赞助。