Name: ClickUp MCP Server
Author: taazkareem

支持人数 GitHub 星数

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

🚀状态更新： v0.7.2 现已推出，具有完整的时间跟踪支持和文档管理功能。

设置

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

Related MCP server: ClickUp MCP Server

Smithery 安装（快速启动）

铁匠徽章

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

NPX 安装

NPM 版本依赖状态 NPM 下载

将此条目添加到客户端的 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", "DOCUMENT_SUPPORT": "true" } } } }

或者使用这个 npx 命令：

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

注意：如果您不传递“DOCUMENT_SUPPORT”：“true”，则默认值为false，并且文档支持将不会激活。

此外，您可以使用DISABLED_TOOLS环境变量或--env DISABLED_TOOLS参数来禁用特定工具。请提供要禁用的工具名称列表（以逗号分隔），例如create_task,delete_task 。

如果您遇到工具数量或任何上下文限制问题，请禁用不需要的工具

使用 SSE 支持运行

通过设置以下环境变量，服务器可以在 SSE（服务器发送事件）模式下运行：

{ "mcpServers": { "ClickUp": { "command": "npx", "args": [ "-y", "@taazkareem/clickup-mcp-server@latest" ], "env": { "CLICKUP_API_KEY": "your-api-key", "CLICKUP_TEAM_ID": "your-team-id", "ENABLE_SSE": "true", "PORT": "8000" // Optional, defaults to 3231 } } } }

或者通过命令行：

npx -y @taazkareem/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id --env ENABLE_SSE=true --env PORT=8000

Docker-compose 示例

version: '3.8' services: clickup-mcp-server: build: context: . dockerfile: Dockerfile ports: - '3231:8000' environment: - CLICKUP_API_KEY=${CLICKUP_API_KEY} - CLICKUP_TEAM_ID=${CLICKUP_TEAM_ID} - ENABLE_SSE=true - LOG_LEVEL=info - DOCUMENT_SUPPORT=true volumes: - ./src:/app/src restart: unless-stopped healthcheck: test: ["CMD", "curl", "-f", "http://localhost:8000/health"] interval: 30s timeout: 10s retries: 3 start_period: 5s

特征

📝 任务管理	🏷️标签管理
• 创建、更新和删除任务• 随处移动和复制任务• 支持单个和批量操作• 使用自然语言设置开始/截止日期• 创建和管理子任务• 添加评论和附件	• 创建、更新和删除空间标签• 在任务中添加和删除标签• 使用自然语言颜色命令• 自动对比前景色• 查看所有空间标签• 跨工作区基于标签的任务组织
⏱️ 时间跟踪	🌳 工作空间组织
• 查看任务的时间条目• 开始/停止任务的时间跟踪• 添加手动时间条目• 删除时间条目• 查看当前正在运行的计时器• 跟踪计费和不计费时间	• 导航空间、文件夹和列表• 创建和管理文件夹• 组织空间内的列表• 在文件夹中创建列表• 查看工作区层次结构• 高效的路径导航
📄 文档管理	👥 会员管理
• 所有工作区的文档列表• 文档页面列表• 文档页面详细信息• 文档创建• 文档页面更新（附加和前置）	• 通过姓名或电子邮件查找工作区成员• 解析任务的受让人• 查看成员详细信息和权限• 在创建过程中将任务分配给用户• 支持用户 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`
获取当前时间条目	获取当前正在运行的计时器	没有任何
获取工作区成员	获取所有工作区成员	没有任何
通过名称查找成员	通过姓名或电子邮件查找会员	`nameOrEmail`
解析分配者	将成员名称解析为 ID	`assignees[]`
创建文档	创建文档	`workspaceId` 、 `name` 、 `parentId` / `parentType` 、 `visibility` 、 `create_pages`
获取文档	获取文档	`workspaceId` / `documentId`
列出文档	列出文件	`workspaceId` 、 `documentId` / `creator` / `deleted` / `archived` / `parent_id` / `parent_type` / `limit` / `next_cursor`
列出文档页面	列出文档页面	`documentId` / `documentName`
获取文档页面	获取文档页面	`documentId` / `documentName` ， `pageIds`
创建文档页面	创建文档页面	`workspaceId` / `documentId` 、 `parent_page_id` / `name` / `sub_title` 、 `content` / `content_format`
更新文档页面	更新文档页面	`workspaceId` / `documentId` ID、 `name` / `sub_title` 、 `content` / `content_edit_mode` / `content_format`

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

会员管理工具

创建任务时，您现在可以使用assignees参数分配用户。该参数接受用户ID、邮箱或用户名的数组：

{ "name": "New Task", "description": "This is a new task.", "assignees": ["jdoe@example.com", "Jane Smith"] // Emails, usernames, or user IDs }

会员管理工具可在需要时帮助解决用户参考问题。

提示

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

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

错误处理

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

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

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

支持开发者

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

赞助商 TaazKareem

致谢

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

贡献

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

执照

许可证：MIT

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

免责声明

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

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

ClickUp MCP Server

设置