ClickUp
效率与工作流by Polaralias
借助完整生产力工具直接管理 ClickUp 中的项目、任务和文档,支持跨工作区搜索任务、生成状态报告、跟踪工时,并查看文档层级与成员信息。
什么是 ClickUp?
借助完整生产力工具直接管理 ClickUp 中的项目、任务和文档,支持跨工作区搜索任务、生成状态报告、跟踪工时,并查看文档层级与成员信息。
核心功能 (41 个工具)
pingEcho request for connectivity checks.
healthReport server readiness and enforced safety limits.
tool_catalogueEnumerate all available tools with their annotations.
workspace_capability_snapshotExpose cached ClickUp capability probes for this session.
workspace_listList accessible ClickUp workspaces (teams). Use when you need workspace IDs before exploring spaces.
space_list_for_workspaceList spaces for a workspace by workspaceId. Use search when you only know workspace names.
folder_list_for_spaceList folders within a ClickUp space. Use when you already know spaceId.
list_list_for_space_or_folderList lists inside a space or folder by ID. If you only know names, resolve them first with resolve_path_to_ids.
workspace_overviewSummarise workspace metrics and recent spaces/folders/lists when you have a workspaceId.
workspace_hierarchyFetch nested hierarchy (spaces, folders, lists) for one or more workspaces. Use this to browse structure without task data.
hierarchy_resolve_pathResolve workspace/space/folder/list names into IDs. Use before tools that require IDs.
member_list_for_workspaceList members in a workspace by teamId. Use when you already know the workspaceId.
member_resolveResolve member identifiers (id, email, username) into member records for a workspace.
member_search_by_nameFuzzy search member names to find member IDs.
task_assignee_resolveTranslate assignee references into suggested member IDs for tasks.
space_tag_listList tags configured for a space using spaceId.
reference_link_listList public ClickUp API reference links.
reference_page_fetchFetch a public ClickUp API reference page from a link returned by reference_link_list.
task_searchStructured task search with filters. Use when you have listIds/tagIds; returns tasks across lists.
task_search_fuzzyFuzzy task search from natural language when you do not have precise filters.
task_search_fuzzy_bulkBatch fuzzy task searches for multiple natural language prompts.
task_status_reportSummarise task status and priority for a workspace, space, folder or list without returning full task lists.
task_risk_reportSummarise 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_readFetch 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_listList 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_listRetrieve task comments for a taskId.
list_custom_field_listList custom fields configured for a list by listId.
doc_listList documents within a workspace using filters.
doc_readFetch document metadata and pages for a docId.
doc_pages_readFetch selected document pages by docId and pageIds.
doc_page_listList page hierarchy for a document by docId.
doc_page_readFetch a single document page by docId and pageId.
doc_searchSearch document content across a workspace. Use doc_page_read for specific pages.
doc_search_bulkBatch document searches when you need several queries processed together.
task_time_entry_listFetch time entries for a taskId, including total duration.
time_entry_currentRetrieve the current running timer for the workspace.
time_entry_listList time entries with filters. Accepts ISO 8601 or epoch boundaries; include taskId when focusing on a single task.
time_report_for_tagAggregate 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_containerAggregate 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_contextAggregate 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_tagAggregate time for a tag within a space using spaceId. Use space_tag_list to pick the tag and includeSubtasks to control hierarchy.
README
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:
python scripts/run_server.py serve
Useful helpers:
python scripts/run_server.py doctor
python scripts/run_server.py url
Configuration
Common live runtime configuration:
CLICKUP_API_TOKENCLICKUP_TEAM_IDCLICKUP_MCP_API_KEYorMCP_API_KEY
See docs/configuration.md for the supported configuration surface.
Verification
Primary local validation commands:
python scripts/validate_harness.py
python scripts/run_harness.py
python scripts/run_live_smoke.py
Docker
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
覆盖 Skill 从创建到迭代优化全流程:起草能力、补测试提示、跑评测与基准方差分析,并持续改写内容和描述,提升效果与触发准确率。
✎ 技能工坊把技能从创建、迭代到评测串成闭环,方差分析加描述优化,特别适合把触发准确率打磨得更稳。
PPT处理
by anthropics
处理 .pptx 全流程:创建演示文稿、提取和解析幻灯片内容、批量修改现有文件,支持模板套用、合并拆分、备注评论与版式调整。
✎ 涉及PPTX的创建、解析、修改到合并拆分都能一站搞定,连备注、模板和评论也能处理,做演示文稿特别省心。
PDF处理
by anthropics
遇到 PDF 读写、文本表格提取、合并拆分、旋转加水印、表单填写或加解密时直接用它,也能提取图片、生成新 PDF,并把扫描件通过 OCR 变成可搜索文档。
✎ PDF杂活别再来回切工具了,文本表格提取、合并拆分到OCR识别一次搞定,连扫描件也能变可搜索。
相关 MCP Server
文件系统
编辑精选by Anthropic
Filesystem 是 MCP 官方参考服务器,让 LLM 安全读写本地文件系统。
✎ 这个服务器解决了让 Claude 直接操作本地文件的痛点,比如自动整理文档或生成代码文件。适合需要自动化文件处理的开发者,但注意它只是参考实现,生产环境需自行加固安全。
by wonderwhy-er
Desktop Commander 是让 AI 直接执行终端命令、管理文件和进程的 MCP 服务器。
✎ 这工具解决了 AI 无法直接操作本地环境的痛点,适合需要自动化脚本调试或文件批量处理的开发者。它能让你用自然语言指挥终端,但权限控制需谨慎,毕竟让 AI 执行 rm -rf 可不是闹着玩的。
by stickerdaniel
LinkedIn Profile and Job Scraper 是让 Claude 直接抓取 LinkedIn 个人资料、公司信息和职位详情的工具。
✎ 这个服务器解决了招聘和商业调研中手动复制粘贴 LinkedIn 数据的痛点,适合猎头或市场分析师快速获取候选人背景和公司动态。不过,LinkedIn 反爬机制频繁更新,数据稳定性需要持续维护,使用时建议搭配人工验证。