MCP 服务器

ClickUp MCP Server

一个模型上下文协议服务器，使人工智能代理能够与 ClickUp 工作区交互，从而允许通过自然语言命令创建、管理任务和组织工作区。

README

MCP 服务器

一个用于集成 ClickUp 任务与 AI 应用的模型上下文协议 (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	任务描述创建	目标、标准、依赖关系