<img src="https://clickup.com/assets/brand/logo-v3-clickup-dark.svg" alt="ClickUp" height="40" style="vertical-align: middle; margin-top: -4px;">

MCP服务器

Model Context Protocol（MCP）服务器用于将ClickUp任务与AI应用程序集成。此服务器允许AI代理通过标准化协议与ClickUp任务、空间、列表和文件夹进行交互。

🚧 状态更新： -代码重构已完成。-增强的截止日期功能现在支持相对时间表达式，如“从现在起2小时”，并在ClickUp中正确显示时间。-更新了npx命令以使用@latest，当有新版本发布时应自动更新服务器。-该服务器已在Smithery、Glama和Pulse MCP上列出。

<a href="https://glama.ai/mcp/servers/iwjvs2zy63"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=3207579250,1619434940&fm=3081&app=3081&f=PNG?w=760&h=200" alt="ClickUp Server MCP服务器" /> </a>

快速开始

使用Cursor Composer Agent的指南：

1. 获取您的凭据：
   • 从ClickUp设置获取ClickUp API密钥
   • 从您的ClickUp工作区URL获取团队ID
2. 转到设置中的功能（或根据版本的不同转到MCP服务器）
3. 在MCP服务器下添加：

npx -y @taazkareem/clickup-mcp-server@latest \
  --env CLICKUP_API_KEY=your_api_key_here \
  --env CLICKUP_TEAM_ID=your_team_id_here

4. 替换凭据并点击保存
5. 使用自然语言与您的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	更新多个任务	tasks[] 包含ID或名称
get_tasks	从列表获取任务	listId/listName
get_task	获取任务详情	taskId/taskName
delete_task	删除任务	taskId/taskName
delete_bulk_tasks	删除多个任务	tasks[] 包含ID或名称
move_task	移动任务	taskId/taskName, listId/listName
move_bulk_tasks	移动多个任务	tasks[] 包含ID或名称，目标列表
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	创建任务描述	目标、标准、依赖

错误处理

服务器提供以下情况的明确错误消息：

• 缺少必需的参数
• 无效的ID或名称
• 未找到项目
• 权限问题
• API错误
• 速率限制

支持开发者

如果您发现这个项目有用，请考虑支持

贡献

欢迎贡献！请阅读我们的贡献指南以获取详细信息。

许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

免责声明

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