名称： clickup
displayName: ClickUp 集成
描述： 与 ClickUp API 交互以进行任务管理。可用于列出任务、创建任务、更新任务状态和管理工作空间。基础 URL: https://api.clickup.com/api/v2
版本： 1.0.0
标签：
- 生产力
- 任务管理
- API

ClickUp 集成

凭证配置

注意： 请在 TOOLS.md 文件中配置您的凭证，或设置以下环境变量：
- CLICKUP_API_TOKEN - 您的 ClickUp API 令牌
- CLICKUP_WORKSPACE_ID - 您的 ClickUp 工作空间 ID

用户分配指南

分配任务时，请根据任务执行者使用正确的邮箱：

示例

• 纯 AI 任务："研究趋势检测工具" → 分配给 AI 邮箱
• 纯人工任务："录制 YouTube 视频" → 分配给您自己的邮箱
• 协作任务："制定内容策略" → 同时分配给两个邮箱

常用操作

列出清单中的任务

GET https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}

获取工作空间中的所有任务

GET https://api.clickup.com/api/v2/team/{workspace_id}/task
Authorization: {your_api_token}

创建任务

POST https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}
Content-Type: application/json

{
  "name": "任务名称",
  "description": "任务描述",
  "status": "active"
}

更新任务状态

PUT https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}
Content-Type: application/json

{
  "status": "done"
}

获取任务详情

GET https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}

所有请求的通用请求头

Authorization: {your_api_token}
Content-Type: application/json

常用状态值

active（进行中）, pending（待处理）, review（审核中）, completed（已完成）, done（已完成）

错误处理

• 401: 请检查 API 令牌
• 404: 请确认 list_id 或 task_id 是否存在
• 429: 请求频率受限 - 请稍后重试