Setup

基本能力

产品定位

ClickUp MCP Server 是一个集成 ClickUp 任务管理与 AI 应用的中间件服务，旨在通过标准化协议实现 AI 代理与 ClickUp 的无缝交互。

核心功能

• 任务管理：创建、更新、删除任务，支持批量操作，支持自然语言设置开始/截止日期，管理子任务、评论和附件。
• 标签管理：创建、更新、删除空间标签，支持自然语言颜色命令，自动生成对比前景色。
• 工作区组织：导航空间、文件夹和列表，创建和管理文件夹，组织列表。
• 集成特性：全局名称或 ID 查找，支持 Markdown 格式，内置速率限制，错误处理和验证。

适用场景

• AI 代理自动化管理 ClickUp 任务。
• 团队协作中通过自然语言指令管理任务和标签。
• 开发者在应用中集成 ClickUp 任务管理功能。

工具列表

常见问题解答

• 错误处理：提供清晰的错误消息，包括缺少参数、无效 ID、权限问题等。
• 日志级别：通过 LOG_LEVEL 环境变量控制日志详细程度。

使用教程

使用依赖

1. 获取 ClickUp API 密钥和团队 ID。
2. API 密钥：ClickUp Settings
3. 团队 ID：从工作区 URL 获取。

安装教程

NPX 安装

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

配置文件安装

将以下内容添加到客户端的 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"
      }
    }
  }
}

调试方式

• 设置日志级别： bash --env LOG_LEVEL=info
• 检查错误消息：确保参数正确，权限充足。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。