内容
# ClickUp MCP 服务器
用于集成 ClickUp 与 LLMs（如 Claude、ChatGPT 和 Gemini）的自定义 MCP 服务器。
允许模型直接在聊天中查询、创建和更新 ClickUp 任务。适用于使用敏捷开发方法（如 Scrum 或 Kanban）的团队和小组。
## 工具列表
### 读取和发现（管理员 API 密钥）
| 工具 | 描述 |
|---|---|
| `get_authorized_teams` | 发现可访问的工作区。**首次使用流程时请先使用此工具。** |
| `get_spaces` | 列出工作区（team_id）内的空间。 |
| `list_lists` | 列出空间（space_id）内所有可用列表，含或不含文件夹。 |
| `list_tasks` | 列出特定列表（list_id）中的任务。 |
| `get_task` | 获取任务的精选详细信息（包括 Markdown 描述和可读自定义字段）。 |
| `get_custom_fields` | 获取列表中可用的自定义字段及其下拉选项。 |
| `get_list_members` | 获取具有显式访问权限的列表成员（ID、用户名、电子邮件）。 |
| `get_custom_task_types` | 查询工作区中的自定义任务类型（项目、故事、漏洞）。 |
| `search_tasks` | 在整个工作区中按名称或关键词搜索任务，以避免重复。 |
| `get_task_comments` | 获取特定任务的评论。 |
### 写入和变更（用户 API 密钥）
| 工具 | 描述 |
|---|---|
| `create_task` | 创建带有 Markdown 支持、受邀者、自定义字段和自定义项目 ID 的新任务。 |
| `update_task_status` | 更改现有任务的状态。 |
| `set_custom_field` | 为自定义字段赋值（支持关联、下拉等）。 |
| `append_task_description` | 在现有描述末尾追加 Markdown 块（例如演练）。 |
| `create_task_comment` | 以用户身份发布评论（例如提交/PR 链接）。 |
| `update_task_comment` | 更新现有评论。 |
| `add_task_time_tracking` | 在任务中记录以毫秒为单位的工作时间。 |
## 为同事安装
### 前置条件
如果尚未安装，请安装 `uv`：
```bash
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
```
### 配置编辑器（双令牌架构）
将以下内容添加到编辑器的 MCP 配置文件中（例如 `claude_desktop_config.json` 或 `mcp.json`）：
```json
{
"mcpServers": {
"clickup": {
"command": "uvx",
"args": [
"--from", "git+https://github.com/RonnyRodriguez26/clickup-mcp.git",
"clickup-mcp",
"--admin-api-key", "pk_ADMIN_TOKEN_HERE",
"--user-api-key", "pk_USER_TOKEN_HERE"
]
}
}
}
```
> **如何获取我的令牌？**
> ClickUp → 设置 → 应用 → API 令牌 → 生成
### 按编辑器划分的配置文件位置
| 编辑器 | 配置文件路径 |
|---|---|
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Cursor / VS Code | `.cursor/mcp.json` 或 `.vscode/mcp.json`（在工作区中） |
| Gemini CLI / Antigravity | `.gemini/settings.json` → `mcpServers` |
保存配置后重启编辑器。
## 本地开发
```bash
git clone https://github.com/RonnyRodriguez26/clickup-mcp.git
cd clickup-mcp
# 使用双令牌直接运行
python clickup_mcp.py --admin-api-key pk_admin... --user-api-key pk_user...
# 或使用 uv
uv run clickup_mcp.py --admin-api-key pk_admin... --user-api-key pk_user...
```
