ClickUp MCP 服务器

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows AI agents to interact with ClickUp tasks, spaces, lists, and folders, including creating, updating, deleting, moving and duplicating tasks, as well as managing workspace organization through a standardized Model Context Protocol (MCP) server.

一个模型上下文协议 (MCP) 服务器，用于将 ClickUp 任务与 AI 应用程序集成。该服务器允许 AI 代理通过标准化协议与 ClickUp 任务、空间、列表和文件夹进行交互。

🚧**状态更新：**推出 v0.6.9 将添加具有智能消歧功能的全局任务查找、具有自然语言表达的任务的开始日期支持、完整标签支持（包括自然语言标签颜色命令）、子任务支持、自定义 ID 支持和日志记录修复

设置

获取您的凭证：
- ClickUp 设置中的 ClickUp API 密钥
- 来自 ClickUp 工作区 URL 的团队 ID
选择托管安装（发送 webhook）或 NPX 安装（下载到本地路径并安装依赖项）
使用自然语言来管理您的工作区！

Smithery 安装（快速启动）

服务器托管在Smithery上。在那里，您可以预览可用的工具或复制命令以在特定的客户端应用上运行。

NPX 安装

将此条目添加到客户端的 MCP 设置 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 覆盖

可用工具

工具	描述	必需参数
获取工作区层次结构	获取工作区结构	没有任何
创建任务	创建任务	`name` ，（ `listId` / `listName` ）
创建批量任务	创建多个任务	`tasks[]`
更新任务	修改任务	`taskId` / `taskName`
更新批量任务	更新多个任务	带有 ID 或名称的`tasks[]`
获取任务	从列表中获取任务	`listId` / `listName`
获取任务	获取单个任务详情	`taskId` / `taskName` （具有智能消歧功能）
获取工作区任务	通过过滤获取任务	至少一个过滤器（标签、list_id、space_id 等）
获取任务评论	获取任务评论	`taskId` / `taskName`
创建任务评论	为任务添加评论	`commentText` ，（ `taskId` /（ `taskName` + `listName` ））
附加任务文件	将文件附加到任务	`taskId` / `taskName` ，（ `file_data`或`file_url` ）
删除任务	删除任务	`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`
获取空间标签	获取空间标签	`spaceId` / `spaceName`
创建空间标签	创建标签	`tagName` 、 `spaceId` / `spaceName`
更新空间标签	更新标签	`tagName` 、 `spaceId` / `spaceName`
删除空间标签	删除标签	`tagName` 、 `spaceId` / `spaceName`
将标签添加到任务	为任务添加标签	`tagName` ， `taskId` /（ `taskName` + `listName` ）
从任务中删除标签	从任务中删除标签	`tagName` ， `taskId` /（ `taskName` + `listName` ）
获取任务时间条目	获取任务的时间条目	`taskId` / `taskName`
开始时间跟踪	开始对任务进行时间跟踪	`taskId` / `taskName`
停止时间跟踪	停止当前时间跟踪	没有任何
添加时间条目	为任务添加手动时间输入	`taskId` / `taskName` ， `start` ， `duration`
删除时间条目	删除时间条目	`timeEntryId`
获取当前时间条目	获取当前正在运行的计时器	没有任何

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

提示

尚未实现，且并非所有客户端应用都支持。请申请一个对您的工作流程最有利的 Prompt 实现功能（无需过于具体）。示例：

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

错误处理

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

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

可以指定LOG_LEVEL环境变量来控制服务器日志的详细程度。有效值为trace 、 debug 、 info 、 warn和error （默认）。也可以在命令行中指定，例如--env LOG_LEVEL=info 。

支持开发者

使用此服务器时，您可能会偶尔在工具响应中看到一条简短的赞助商信息，其中包含指向此存储库的链接。希望您能支持这个项目！如果您觉得这个项目有用，请考虑支持：

致谢

特别感谢ClickUp提供的出色 API 和服务，使这一集成成为可能。

贡献

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

执照

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

免责声明

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

实现 AI 与 ClickUp 任务的集成，通过标准化协议支持资源管理、任务操作、工作区组织和 AI 驱动的任务推荐。

Related Resources

Reddit Discussion about this server

ClickUp MCP Server