C
ClickUp-MCP服务
@windalfin/clickup-mcp-server
0 Stars
345 次浏览
windalfin
更新于 2026-08-23
一种模型上下文协议服务器， enables 人工智能代理与 ClickUp 工作区交互，通过自然语言命令实现任务创建、管理和工作区组织。 （注：原文中的“enables”在翻译中根据语义补充了其对应的含义以使句子更通顺。）
该服务暂未提供标准配置，请参考 README 手动接入
服务介绍
MCP 服务器
这是一个用于将 ClickUp 任务与 AI 应用程序集成的 Model Context Protocol (MCP) 服务器。该服务器允许 AI 代理通过标准化协议与 ClickUp 任务、空间、列表和文件夹进行交互。
🚧 状态更新： -代码重构已完成。-增强的截止日期功能现在支持像“从现在起2小时”这样的相对时间表达，并在 ClickUp 中正确显示时间。-npx 命令已更新为使用 @latest，这将在发布新版本时自动更新服务器。-该服务器已在 Smithery、Glama 和 Pulse MCP 上列出。
快速开始
与 Cursor Composer Agent 使用指南：
- 获取您的凭证：
- 从 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 工作区互动！
Smithery 安装
该服务器也托管在 Smithery 上。在那里，您可以预览可用工具或复制命令以在特定客户端应用程序上运行。
功能
-
🎯 任务管理
- 创建、更新和删除单个任务
- 在列表、空间和文件夹之间移动和复制任务
- 批量创建、更新、移动和删除多个任务
- 查看和修改任务详细信息和属性
- 使用自然语言和相对时间表达式设置截止日期
-
📂 工作区组织
- 完整的工作区层次结构（空间、文件夹、列表）
- 具有清晰关系的树形结构
- 对工作区组件进行全面的 CRUD 操作
- 高效的基于路径的导航
-
🔄 集成特性
- 基于名称或 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 |
| 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 |
请参阅完整文档以了解可选参数和高级用法。
可用提示
尚未实现（或需要）。目前，您可以在工具结果后发送后续提示。
| 提示 | 目的 | 功能 |
|---|---|---|
| summarize_tasks | 任务概览 | 状态摘要、优先级、关系 |
| analyze_priorities | 优先级优化 | 分布分析、排序 |
| generate_description | 任务描述生成 | 目标、标准、依赖项 |
错误处理
服务器提供清晰的错误消息，包括：
- 缺少必需参数
- 无效的 ID 或名称
- 项目未找到
- 权限问题
- API 错误
- 请求速率限制
支持开发者
如果您觉得这个项目有用，请考虑支持
贡献
欢迎贡献！请阅读我们的 贡献指南 以获取详情。
许可证
本项目采用 MIT 许可证发布 - 详见 LICENSE 文件。
免责声明
免责声明：此软件使用了第三方 API，并可能引用了由第三方拥有的商标或品牌。使用这些 API 或引用并不意味着与相关公司有任何关联或得到其认可。所有商标和品牌名称均为各自所有者的财产。此项目是一个独立的作品，并不正式隶属于或受任何提到的第三方公司的赞助。
