ClickUp

效率与工作流

by Polaralias

借助完整生产力工具直接管理 ClickUp 中的项目、任务和文档,支持跨工作区搜索任务、生成状态报告、跟踪工时,并查看文档层级与成员信息。

什么是 ClickUp

借助完整生产力工具直接管理 ClickUp 中的项目、任务和文档,支持跨工作区搜索任务、生成状态报告、跟踪工时,并查看文档层级与成员信息。

核心功能 (41 个工具)

ping

Echo request for connectivity checks.

health

Report server readiness and enforced safety limits.

tool_catalogue

Enumerate all available tools with their annotations.

workspace_capability_snapshot

Expose cached ClickUp capability probes for this session.

workspace_list

List accessible ClickUp workspaces (teams). Use when you need workspace IDs before exploring spaces.

space_list_for_workspace

List spaces for a workspace by workspaceId. Use search when you only know workspace names.

folder_list_for_space

List folders within a ClickUp space. Use when you already know spaceId.

list_list_for_space_or_folder

List lists inside a space or folder by ID. If you only know names, resolve them first with resolve_path_to_ids.

workspace_overview

Summarise workspace metrics and recent spaces/folders/lists when you have a workspaceId.

workspace_hierarchy

Fetch nested hierarchy (spaces, folders, lists) for one or more workspaces. Use this to browse structure without task data.

hierarchy_resolve_path

Resolve workspace/space/folder/list names into IDs. Use before tools that require IDs.

member_list_for_workspace

List members in a workspace by teamId. Use when you already know the workspaceId.

member_resolve

Resolve member identifiers (id, email, username) into member records for a workspace.

member_search_by_name

Fuzzy search member names to find member IDs.

task_assignee_resolve

Translate assignee references into suggested member IDs for tasks.

space_tag_list

List tags configured for a space using spaceId.

reference_link_list

List public ClickUp API reference links.

reference_page_fetch

Fetch a public ClickUp API reference page from a link returned by reference_link_list.

task_search

Structured task search with filters. Use when you have listIds/tagIds; returns tasks across lists.

task_search_fuzzy

Fuzzy task search from natural language when you do not have precise filters.

task_search_fuzzy_bulk

Batch fuzzy task searches for multiple natural language prompts.

task_status_report

Summarise task status and priority for a workspace, space, folder or list without returning full task lists.

task_risk_report

Summarise overdue and at-risk tasks within a workspace, space, folder or list. Subtasks are included by default; use includeSubtasks to focus on parent tasks and inspect isSubtask/parentId in results to understand hierarchy.

task_read

Fetch task details including createdDate/updatedDate fields derived from ClickUp timestamps. Subtask cues (isSubtask, parentId, hasSubtasks, subtaskCount) are included; check them before claiming there are no subtasks. GET /task/{task_id}

task_list_for_list

List tasks in a list. Tasks linked from other lists are included by default (include_timl=true). Outputs include createdDate derived from ClickUp date_created and hierarchy cues (isSubtask, parentId, hasSubtasks, subtaskCount). Always review hasSubtasks/subtaskCount before asserting there are no subtasks. Results are paginated and may span multiple pages; iterate via the page input to retrieve additional pages. GET /list/{list_id}/task

task_comment_list

Retrieve task comments for a taskId.

list_custom_field_list

List custom fields configured for a list by listId.

doc_list

List documents within a workspace using filters.

doc_read

Fetch document metadata and pages for a docId.

doc_pages_read

Fetch selected document pages by docId and pageIds.

doc_page_list

List page hierarchy for a document by docId.

doc_page_read

Fetch a single document page by docId and pageId.

doc_search

Search document content across a workspace. Use doc_page_read for specific pages.

doc_search_bulk

Batch document searches when you need several queries processed together.

task_time_entry_list

Fetch time entries for a taskId, including total duration.

time_entry_current

Retrieve the current running timer for the workspace.

time_entry_list

List time entries with filters. Accepts ISO 8601 or epoch boundaries; include taskId when focusing on a single task.

time_report_for_tag

Aggregate logged time for a tag across the workspace. Use space_tag_list to discover tags, and includeSubtasks to control whether child task time is counted.

time_report_for_container

Aggregate time for a workspace, space, folder or list using containerId + containerType. Resolve IDs with resolve_path_to_ids, list_workspaces/spaces/folders/lists, and set includeSubtasks to clarify hierarchy handling.

time_report_for_context

Aggregate time for a task, list (including filtered views), space or workspace. Use search_tasks or task_list_for_list to source listId/taskId before calling. Subtask handling is explicit via includeSubtasks.

time_report_for_space_tag

Aggregate time for a tag within a space using spaceId. Use space_tag_list to pick the tag and includeSubtasks to control hierarchy.

README

<p align="center"> <img src="ClickUp%20MCP.png" alt="ClickUp MCP banner" width="960" /> </p>

ClickUp MCP

ClickUp MCP is a FastMCP server that exposes ClickUp workspace operations through a validated, checked-in tool surface.

What It Does

The server gives agents and local tools a structured way to read and update ClickUp data without inventing ad hoc wrappers on each project. The repository focuses on a fully declared tool surface, evidence-backed validation, and predictable local runtime behavior.

Core Capabilities

  • workspace, space, folder, and list operations
  • task creation, updates, and lifecycle actions
  • member, doc, view, time-tracking, and custom-field coverage
  • checked-in tool manifest and validation status artifacts
  • local and live smoke validation paths

Quick Start

Run locally:

bash
python scripts/run_server.py serve

Useful helpers:

bash
python scripts/run_server.py doctor
python scripts/run_server.py url

Configuration

Common live runtime configuration:

  • CLICKUP_API_TOKEN
  • CLICKUP_TEAM_ID
  • CLICKUP_MCP_API_KEY or MCP_API_KEY

See docs/configuration.md for the supported configuration surface.

Verification

Primary local validation commands:

bash
python scripts/validate_harness.py
python scripts/run_harness.py
python scripts/run_live_smoke.py

Docker

bash
docker build -t clickup-mcp:local .
docker run --rm -p 3004:3004 -e API_KEY_MODE=disabled clickup-mcp:local

Documentation

Start with:

For repository workflow and agent-focused context, read AGENTS.md.

常见问题

ClickUp 是什么?

借助完整生产力工具直接管理 ClickUp 中的项目、任务和文档,支持跨工作区搜索任务、生成状态报告、跟踪工时,并查看文档层级与成员信息。

ClickUp 提供哪些工具?

提供 41 个工具,包括 ping、health、tool_catalogue

相关 Skills

技能工坊

by anthropics

Universal
热门

覆盖 Skill 从创建到迭代优化全流程:起草能力、补测试提示、跑评测与基准方差分析,并持续改写内容和描述,提升效果与触发准确率。

技能工坊把技能从创建、迭代到评测串成闭环,方差分析加描述优化,特别适合把触发准确率打磨得更稳。

效率与工作流
未扫描157.8k

PPT处理

by anthropics

Universal
热门

处理 .pptx 全流程:创建演示文稿、提取和解析幻灯片内容、批量修改现有文件,支持模板套用、合并拆分、备注评论与版式调整。

涉及PPTX的创建、解析、修改到合并拆分都能一站搞定,连备注、模板和评论也能处理,做演示文稿特别省心。

效率与工作流
未扫描157.8k

PDF处理

by anthropics

Universal
热门

遇到 PDF 读写、文本表格提取、合并拆分、旋转加水印、表单填写或加解密时直接用它,也能提取图片、生成新 PDF,并把扫描件通过 OCR 变成可搜索文档。

PDF杂活别再来回切工具了,文本表格提取、合并拆分到OCR识别一次搞定,连扫描件也能变可搜索。

效率与工作流
未扫描157.8k

相关 MCP Server

文件系统

编辑精选

by Anthropic

热门

Filesystem 是 MCP 官方参考服务器,让 LLM 安全读写本地文件系统。

这个服务器解决了让 Claude 直接操作本地文件的痛点,比如自动整理文档或生成代码文件。适合需要自动化文件处理的开发者,但注意它只是参考实现,生产环境需自行加固安全。

效率与工作流
88.0k

by wonderwhy-er

热门

Desktop Commander 是让 AI 直接执行终端命令、管理文件和进程的 MCP 服务器。

这工具解决了 AI 无法直接操作本地环境的痛点,适合需要自动化脚本调试或文件批量处理的开发者。它能让你用自然语言指挥终端,但权限控制需谨慎,毕竟让 AI 执行 rm -rf 可不是闹着玩的。

效率与工作流
6.2k

by stickerdaniel

热门

LinkedIn Profile and Job Scraper 是让 Claude 直接抓取 LinkedIn 个人资料、公司信息和职位详情的工具。

这个服务器解决了招聘和商业调研中手动复制粘贴 LinkedIn 数据的痛点,适合猎头或市场分析师快速获取候选人背景和公司动态。不过,LinkedIn 反爬机制频繁更新,数据稳定性需要持续维护,使用时建议搭配人工验证。

效率与工作流
2.6k

评论