A
security-
licenseA
qualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.
Last updated -
27
17
MIT License
一个模型上下文协议 (MCP) 服务器，用于将 ClickUp 任务与 AI 应用程序集成。该服务器允许 AI 代理通过标准化协议与 ClickUp 任务、空间、列表和文件夹进行交互。
🚀状态更新： v0.7.2 现已推出，具有完整的时间跟踪支持和文档管理功能。
设置
获取您的凭证：
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",
"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 覆盖 |
可用工具
工具 | 描述 | 必需参数 |
获取工作区结构 | 没有任何 | |
创建任务 |
，（
/
） | |
创建多个任务 |
| |
修改任务 |
/
| |
更新多个任务 | 带有 ID 或名称的
| |
从列表中获取任务 |
/
| |
获取单个任务详情 |
/
（具有智能消歧功能） | |
通过过滤获取任务 | 至少一个过滤器（标签、list_id、space_id 等） | |
获取任务评论 |
/
| |
为任务添加评论 |
，（
/（
+
）） | |
将文件附加到任务 |
/
，（
或
） | |
删除任务 |
/
| |
删除多个任务 | 带有 ID 或名称的
| |
移动任务 |
/
，
/
| |
移动多个任务 | 带有 ID 或名称、目标列表的
| |
复制任务 |
/
，
/
| |
在空间中创建列表 |
、
/
| |
创建文件夹 |
、
/
| |
在文件夹中创建列表 |
，
/
| |
获取文件夹详细信息 |
/
| |
更新文件夹属性 |
/
| |
删除文件夹 |
/
| |
获取列表详细信息 |
/
| |
更新列表属性 |
/
| |
删除列表 |
/
| |
获取空间标签 |
/
| |
创建标签 |
、
/
| |
更新标签 |
、
/
| |
删除标签 |
、
/
| |
为任务添加标签 |
，
/（
+
） | |
从任务中删除标签 |
，
/（
+
） | |
获取任务的时间条目 |
/
| |
开始对任务进行时间跟踪 |
/
| |
停止当前时间跟踪 | 没有任何 | |
为任务添加手动时间输入 |
/
，
，
| |
删除时间条目 |
| |
获取当前正在运行的计时器 | 没有任何 | |
获取所有工作区成员 | 没有任何 | |
通过姓名或电子邮件查找会员 |
| |
将成员名称解析为 ID |
| |
创建文档 |
、
、
/
、
、
| |
获取文档 |
/
| |
列出文件 |
、
/
/
/
/
/
/
/
| |
列出文档页面 |
/
| |
获取文档页面 |
/
，
| |
创建文档页面 |
/
、
/
/
、
/
| |
更新文档页面 |
/
ID、
/
、
/
/
|
请参阅完整文档以了解可选参数和高级用法。
会员管理工具
创建任务时，您现在可以使用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 。
支持开发者
使用此服务器时，您可能会偶尔在工具响应中看到一条简短的赞助商信息，其中包含指向此存储库的链接。希望您能支持这个项目！如果您觉得这个项目有用，请考虑支持：
致谢
特别感谢ClickUp提供的出色 API 和服务，使这一集成成为可能。
贡献
欢迎贡献！详情请阅读我们的贡献指南。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。
免责声明
本软件使用第三方 API，并可能引用第三方拥有的商标或品牌。使用此类 API 或引用并不意味着与相关公司有任何关联或获得其认可。所有商标和品牌名称均为其各自所有者的财产。本项目为独立作品，与文中提及的任何第三方公司均无正式关联或赞助。
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
实现 AI 与 ClickUp 任务的集成，通过标准化协议支持资源管理、任务操作、工作区组织和 AI 驱动的任务推荐。
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityAn 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 -02MIT License
- -security-license-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -1,7342MIT License
- Asecurity-licenseAqualityEnables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.Last updated -283MIT License
Appeared in Searches
- A method or tool for managing ClickUp task list custom fields with read and write update capabilities
- Automating Task Assignment Based on Priority with Reshuffling Capabilities
- Tools and platforms for task management
- A tool for planning and managing software projects
- A server for software engineers that integrates with Jira and Slack