MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于将 ClickUp 任务与 AI 应用程序集成。该服务器允许 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 速率限制

可用工具

工具	描述	必需参数
获取工作区层次结构	获取工作区结构	没有任何
创建任务	创建任务	`name` ，（ `listId` / `listName` ）
创建批量任务	创建多个任务	`tasks[]`
更新任务	修改任务	`taskId` / `taskName`
更新批量任务	更新多个任务	带有 ID 或名称的`tasks[]`
获取任务	从列表中获取任务	`listId` / `listName`
获取任务	获取任务详细信息	`taskId` / `taskName`
删除任务	删除任务	`taskId` / `taskName`
删除批量任务	删除多个任务	带有 ID 或名称的`tasks[]`
移动任务	移动任务	`taskId` / `taskName` , `listId` / `listName`
移动批量任务	移动多个任务	带有 ID 或名称、目标列表的`tasks[]`
重复任务	复制任务	`taskId` / `taskName` , `listId` / `listName`
创建列表	在空间中创建列表	`name` 、 `spaceId` / `spaceName`
创建文件夹	创建文件夹	`name` 、 `spaceId` / `spaceName`
在文件夹中创建列表	在文件夹中创建列表	`name` ， `folderId` / `folderName`
获取文件夹	获取文件夹详细信息	`folderId` / `folderName`
更新文件夹	更新文件夹属性	`folderId` / `folderName`
删除文件夹	删除文件夹	`folderId` / `folderName`
获取列表	获取列表详细信息	`listId` / `listName`
更新列表	更新列表属性	`listId` / `listName`
删除列表	删除列表	`listId` / `listName`

请参阅完整文档以了解可选参数和高级用法。

可用提示

尚未实施（或不需要）目前，您可以在工具结果之后发送后续提示。

迅速的	目的	特征
总结任务	任务概述	状态摘要、优先事项、关系
分析优先级	优先级优化	分布分析、测序
生成描述	任务描述创建	目标、标准、依赖关系

错误处理

服务器提供了以下清晰的错误消息：

缺少必需参数
无效的身份证件或姓名
未找到商品
权限问题
API 错误
速率限制

支持开发者

如果您发现该项目有用，请考虑支持

贡献

欢迎贡献！详情请阅读我们的贡献指南。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

免责声明

免责声明：本软件使用第三方 API，并可能引用第三方拥有的商标或品牌。使用此类 API 或引用并不意味着与相关公司有任何关联或获得其认可。所有商标和品牌名称均为其各自所有者的财产。本项目为独立作品，与文中提及的任何第三方公司均无正式关联或赞助。

ClickUp MCP Server

Integrations