A
securityA
licenseA
qualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
5
56
7
TypeScript
MIT License
一个模型上下文协议 (MCP) 服务器，用于将 ClickUp 任务与 AI 应用程序集成。该服务器允许 AI 代理通过标准化协议与 ClickUp 任务、空间、列表和文件夹进行交互。
🚀状态更新： v0.7.2 现已推出，具有完整的时间跟踪支持和文档管理功能。
设置
- 获取您的凭证：
- ClickUp 设置中的 ClickUp API 密钥
- 来自 ClickUp 工作区 URL 的团队 ID
- 选择托管安装（发送 webhook）或 NPX 安装（下载到本地路径并安装依赖项）
- 使用自然语言来管理您的工作区！
Smithery 安装（快速启动）
服务器托管在Smithery上。在那里，您可以预览可用的工具或复制命令以在特定的客户端应用上运行。
NPX 安装
将此条目添加到客户端的 MCP 设置 JSON 文件中：
或者使用这个 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（服务器发送事件）模式下运行：
或者通过命令行：
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 示例
特征
| 📝 任务管理 | 🏷️标签管理 |
|---|---|
| • 创建、更新和删除任务• 随处移动和复制任务• 支持单个和批量操作• 使用自然语言设置开始/截止日期• 创建和管理子任务• 添加评论和附件 | • 创建、更新和删除空间标签• 在任务中添加和删除标签• 使用自然语言颜色命令• 自动对比前景色• 查看所有空间标签• 跨工作区基于标签的任务组织 |
| ⏱️时间跟踪 | 🌳工作空间组织 |
| • 查看任务的时间条目• 开始/停止任务的时间跟踪• 添加手动时间条目• 删除时间条目• 查看当前正在运行的计时器• 跟踪计费和不计费时间 | • 导航空间、文件夹和列表• 创建和管理文件夹• 组织空间内的列表• 在文件夹中创建列表• 查看工作区层次结构• 高效的路径导航 |
| 📄文档管理 | 👥会员管理 |
| • 所有工作区的文档列表• 文档页面列表• 文档页面详细信息• 文档创建• 文档页面更新（附加和前置） | • 通过姓名或电子邮件查找工作区成员• 解析任务的受让人• 查看成员详细信息和权限• 在创建过程中将任务分配给用户• 支持用户 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、邮箱或用户名的数组：
会员管理工具可在需要时帮助解决用户参考问题。
提示
尚未实现，且并非所有客户端应用都支持。请申请一个对您的工作流程最有利的 Prompt 实现功能（无需过于具体）。示例：
错误处理
服务器提供了以下清晰的错误消息：
- 缺少必需参数
- 无效的身份证件或姓名
- 未找到商品
- 权限问题
- API 错误
- 速率限制
可以指定LOG_LEVEL环境变量来控制服务器日志的详细程度。有效值为trace 、 debug 、 info 、 warn和error （默认）。也可以在命令行中指定，例如--env LOG_LEVEL=info 。
支持开发者
使用此服务器时，您可能会偶尔在工具响应中看到一条简短的赞助商信息，其中包含指向此存储库的链接。希望您能支持这个项目！如果您觉得这个项目有用，请考虑支持：
致谢
特别感谢ClickUp提供的出色 API 和服务，使这一集成成为可能。
贡献
欢迎贡献！详情请阅读我们的贡献指南。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。
免责声明
本软件使用第三方 API，并可能引用第三方拥有的商标或品牌。使用此类 API 或引用并不意味着与相关公司有任何关联或获得其认可。所有商标和品牌名称均为其各自所有者的财产。本项目为独立作品，与文中提及的任何第三方公司均无正式关联或赞助。
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
实现 AI 与 ClickUp 任务的集成，通过标准化协议支持资源管理、任务操作、工作区组织和 AI 驱动的任务推荐。
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables AI agents to control web browsers via a standardized interface for operations like launching, interacting with, and closing browsers.Last updated -0JavaScript
- AsecurityAlicenseAqualityAn enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.Last updated -40343TypeScriptMIT License
- AsecurityAlicenseAqualityClickUp MCP Server enables AI assistants to seamlessly interact with your ClickUp workspace. This powerful integration allows Claude to create and manage tasks, access documents, organize folders and lists, add comments, and handle checklists—all through natural conversation.Last updated -42594TypeScriptMIT License