使用说明
MCP服务器
用于将ClickUp任务与AI应用程序集成的模型上下文协议(MCP)服务器。该服务器允许AI代理通过标准化协议与ClickUp任务、空间、列表和文件夹进行交互。
🚧 状态更新: -代码重构已完成。-增强的截止日期功能现在支持相对时间表达式,如“2小时后”,并在ClickUp中显示适当的时间。-npx命令已更新为使用@latest,当新版本发布时,该命令应自动更新服务器。-服务器已在Smithery、Glama和Pulse MCP上列出。
快速开始
使用Cursor Composer Agent的说明:
- 获取您的凭据:
- 来自的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_works空间层次结构 | 获取工作区结构 | 无 |
| 创建任务 | 创建任务 | name, (listId/listName) |
| create_bulk_tasks | 创建多个任务 | tasks[] |
| update_task | 修改任务 | taskId/taskName |
| update_bulk_tasks | 更新多个任务 | tasks[] 带有ID或名称 |
| get_tasks | 从列表中获取任务 | listId/listName |
| 获取任务 | 获取任务详细信息 | taskId/taskName |
| 删除任务 | 删除任务 | taskId/taskName |
| delete_bulk_tasks | 删除多个任务 | tasks[] 带有ID或名称 |
| 移动任务 | 移动任务 | taskId/taskName, listId/listName |
| move_bulk_tasks | 移动多个任务 | tasks[] 带有ID或名称的目标列表 |
| 重复任务 | 复制任务 | taskId/taskName, listId/listName |
| create_list | 在空间中创建列表 | name, spaceId/spaceName |
| 创建文件夹 | 创建文件夹 | name, spaceId/spaceName |
| create_list_in_folder | 在文件夹中创建列表 | name, folderId/folderName |
| 获取文件夹 | 获取文件夹详细信息 | folderId/folderName |
| update_folder | 更新文件夹属性 | folderId/folderName |
| 删除文件夹 | 删除文件夹 | folderId/folderName |
| get_list | 获取列表详细信息 | listId/listName |
| update_list | 更新列表属性 | listId/listName |
| delete_list | 删除列表 | listId/listName |
看 全部文件 用于可选参数和高级用法。
可用提示
尚未实现(或需要)目前,您可以在工具结果后发送后续提示。
| 提示 | 目的 | 功能 |
|---|---|---|
| 总结任务 | 任务概述 | 状态摘要、优先级、关系 |
| 分析优先级 | 优先级优化 | 分布分析、排序 |
| generate-description | 任务描述创建 | 目标、标准、依赖关系 |
错误处理
服务器为以下对象提供明确的错误消息:
- 缺少必要参数
- ID或名称无效
- 未找到项目
- 权限问题
- API错误
- 速率限制
支持开发者
如果你觉得这个项目有用,请考虑支持
贡献
欢迎投稿!请阅读我们的 贡献指南 了解详情。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
免责声明
免责声明:本软件使用第三方API,可能会引用商标 或第三方拥有的品牌。使用此类API或引用并不意味着 与各公司的任何关联或由其背书。所有商标和 品牌名称是其各自所有者的财产。这个项目是一个独立的 工作,与上述任何第三方公司没有正式关联或赞助。