ClickUp MCP (Streamable HTTP)

用于 ClickUp REST API 的 MCP 服务器，具备以下功能：

• 工作区范围的任务搜索 (GET /team/{team_id}/task)

• 任务 CRUD（增删改查，含子任务）

• 基础浏览（团队、空间、文件夹、列表）

• 近期活动助手（通过 date_updated_gt，以及可用的审计日志）

• 文档 CRUD/搜索 (v3 API)：搜索、获取、创建文档和页面

• 逃生舱：用于调用任何 ClickUp API 端点（v2 和 v3）的通用工具。

此服务器旨在作为 Docker 服务运行，并供 OpenWebUI 和 LibreChat 使用。

环境

• CLICKUP_API_TOKEN (必需)

• CLICKUP_TEAM_ID (可选，若未设置将自动检测第一个团队)

• CLICKUP_WORKSPACE_ID (可选；ClickUp 在 v2 中通常将其称为 "team_id")

• CLICKUP_API_BASE_URL (可选，默认 https://api.clickup.com/api/v2)

• CLICKUP_API_V3_BASE_URL (可选，默认 https://api.clickup.com/api/v3)

运行 (本地)

python -m clickup_mcp --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp

OpenWebUI 应连接至：http://clickup-mcp:8000/mcp

工具

任务 (v2 API)

• search_tasks - 按名称/描述搜索任务

• filter_tasks - 按元数据（状态、负责人、日期等）过滤任务

• get_task - 按 ID 获取任务

• create_task - 创建新任务

• create_subtask - 在现有任务下创建子任务

• update_task - 更新任务

• delete_task - 删除任务

• get_task_comments - 获取任务评论

• create_task_comment - 在任务上创建评论

浏览 (v2 API)

• clickup_context - 获取已解析的上下文（团队/工作区 ID 和当前用户）

• list_teams - 列出 ClickUp 团队/工作区

• get_team - 按 ID 获取团队

• list_spaces - 列出团队中的空间

• list_folders - 列出空间中的文件夹

• list_lists_in_space - 列出空间中的（无文件夹）列表

• list_lists_in_folder - 列出文件夹中的列表

• list_tasks_in_list - 列出列表中的任务

文档 (v3 API)

• search_docs - 搜索/列出工作区中的所有文档

• get_doc - 按 ID 获取文档（包含页面列表）

• create_doc - 创建新文档

页面 (v3 API)

• list_doc_pages - 列出文档中的所有页面

• get_doc_page_listing - 获取文档的分层页面结构

• get_doc_page - 获取特定页面（含内容）

• create_doc_page - 在文档中创建新页面

• update_doc_page - 更新/编辑页面（替换、追加或前置内容）

实用工具

• recent_activity - 获取近期活动（审计日志或最近更新的任务）

• clickup_api_request - 通用 v2 API 逃生舱

• clickup_v3_api_request - 通用 v3 API 逃生舱

• health - 健康检查