ClickUp Project Management
Manage your ClickUp workspace using the ClickUp MCP Server via the bundled mcporter skill.
External Endpoints
| URL | Data Sent | Purpose |
|---|
| INLINECODE1 | License key (via X-License-Key header), ClickUp OAuth access token (via Authorization header), MCP tool call payloads (task names, IDs, field values, etc.) | Remote MCP server that proxies ClickUp API v2 calls on your behalf |
| INLINECODE4 |
ClickUp OAuth token (proxied by the MCP server) | Upstream ClickUp API — requests are made
by the remote server, not directly from your machine |
Security & Privacy
- - What stays local: Your
CLICKUP_MCP_LICENSE_KEY is stored in ~/.openclaw/openclaw.json (or your shell environment). OAuth tokens are cached locally by mcporter in ~/.mcporter/. - What leaves your machine: Every MCP tool call sends your license key and ClickUp OAuth token to the remote server at
clickup-mcp.taazkareem.com. Tool call payloads (task data, workspace hierarchy, etc.) are also transmitted. - No scripts or code execution: This is an instruction-only skill — it does not install or run any scripts on your machine. It relies on the bundled
mcporter client. - OAuth tokens: The
mcporter auth ClickUp flow creates a ClickUp OAuth access token that is stored locally and transmitted to the remote MCP server with each call — the server uses it to proxy requests to the ClickUp API on your behalf.
Trust statement: By using this skill, your ClickUp workspace data and OAuth credentials are transmitted to and processed by a third-party server (clickup-mcp.taazkareem.com) operated by Talib Kareem. Only install this skill if you trust this operator and have reviewed the project repository.
Prerequisites
- 1. Enable mcporter in
~/.openclaw/openclaw.json:
CODEBLOCK0
- 2. Configure ClickUp (one-time setup):
CODEBLOCK1
- 3. Authenticate (tokens are cached):
CODEBLOCK2
Optimization: Tool Filtering Personas
To reduce context noise and improve AI accuracy, you can limit the tools available to your agent using the X-Enabled-Tools header in your mcporter config.
Proactive Agent Rule: If the current task aligns with one of these personas, you should dynamically apply the filtering header by re-running the mcporter config add command with the appropriate X-Enabled-Tools or X-Disabled-Tools flag.
Recommended Presets
| Persona | Purpose | Header Config |
|---|
| Auditor | Read-only access | INLINECODE19 |
| Task Worker |
Daily task mgmt |
--header X-Enabled-Tools=get_workspace_hierarchy,get_workspace_tasks,get_task,get_list,get_folder,get_list_custom_fields,create_task,update_task,set_task_custom_field,move_task,duplicate_task,create_task_comment,get_task_comments,attach_task_file,start_time_tracking,stop_time_tracking,add_tag_to_task,remove_tag_from_task,add_task_link,delete_task_link,get_task_links,add_task_to_list,remove_task_from_list,find_member_by_name,submit_feedback |
|
Time Specialist| Tracking & Reports |
--header X-Enabled-Tools=get_workspace_hierarchy,get_workspace_tasks,get_task,get_task_time_entries,get_workspace_time_entries,get_current_time_entry,start_time_tracking,stop_time_tracking,add_time_entry,delete_time_entry,submit_feedback |
|
Content Mgr | Docs & Chat |
--header X-Enabled-Tools=get_workspace_hierarchy,get_workspace_tasks,get_task,get_task_comments,create_task_comment,find_member_by_name,create_document,get_document,list_documents,list_document_pages,get_document_pages,create_document_page,update_document_page,create_chat_channel,get_chat_channels,create_chat_message,get_chat_messages,submit_feedback |
|
Safe Power User| Full access (No Delete) |
--header X-Disabled-Tools=delete_task,delete_bulk_tasks,delete_time_entry,delete_task_link,delete_list,delete_folder,delete_space_tag |
How to Apply
To switch to a persona (e.g.,
Task Worker), run:
CODEBLOCK3
Personalization & Workflows
Following the OpenClaw standard, do not modify this skill for environment-specific details. Instead, use your agent's workspace/TOOLS.md file to define:
- - Custom Workflows: Define multi-step orchestrations (e.g., "Daily Wrap-up").
- Specific IDs: Store commonly used
team_id, list_ids, folder_ids, etc. - Structures or Conventions: Any rules or consistent behavior (e.g., common custom fields, tag rules, etc.)
Usage
Use the standard mcporter command pattern:
CODEBLOCK4
ClickUp 项目管理
使用 ClickUp MCP 服务器（通过集成的 mcporter 技能）管理您的 ClickUp 工作区。
外部端点
| URL | 发送的数据 | 目的 |
|---|
| https://clickup-mcp.taazkareem.com/mcp | 许可证密钥（通过 X-License-Key 标头）、ClickUp OAuth 访问令牌（通过 Authorization 标头）、MCP 工具调用负载（任务名称、ID、字段值等） | 远程 MCP 服务器，代表您代理 ClickUp API v2 调用 |
| https://api.clickup.com/api/v2/* |
ClickUp OAuth 令牌（由 MCP 服务器代理） | 上游 ClickUp API — 请求由远程服务器发起，而非直接来自您的机器 |
安全与隐私
- - 本地保留的内容：您的 CLICKUPMCPLICENSE_KEY 存储在 ~/.openclaw/openclaw.json（或您的 shell 环境）中。OAuth 令牌由 mcporter 本地缓存在 ~/.mcporter/ 中。
- 离开您机器的内容：每次 MCP 工具调用都会将您的许可证密钥和 ClickUp OAuth 令牌发送到位于 clickup-mcp.taazkareem.com 的远程服务器。工具调用负载（任务数据、工作区层级结构等）也会被传输。
- 无脚本或代码执行：这是一个纯指令技能 — 它不会在您的机器上安装或运行任何脚本。它依赖于集成的 mcporter 客户端。
- OAuth 令牌：mcporter auth ClickUp 流程会创建一个 ClickUp OAuth 访问令牌，该令牌存储在本地，并在每次调用时传输到远程 MCP 服务器 — 服务器使用该令牌代表您代理对 ClickUp API 的请求。
信任声明：使用此技能，您的 ClickUp 工作区数据和 OAuth 凭证将被传输到由 Talib Kareem 运营的第三方服务器（clickup-mcp.taazkareem.com）并进行处理。仅当您信任此运营者并已查看项目仓库时，才安装此技能。
前提条件
- 1. 在 ~/.openclaw/openclaw.json 中启用 mcporter：
json
{
skills: {
allowBundled: [mcporter]
}
}
- 2. 配置 ClickUp（一次性设置）：
bash
# 使用技能元数据提供的 $CLICKUP
MCPLICENSE_KEY 环境变量
mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp \
--auth oauth \
--header X-License-Key=$CLICKUP
MCPLICENSE_KEY
- 3. 进行身份验证（令牌会被缓存）：
bash
mcporter auth ClickUp
优化：工具过滤角色
为减少上下文噪音并提高 AI 准确性，您可以在 mcporter 配置中使用 X-Enabled-Tools 标头来限制代理可用的工具。
主动代理规则：如果当前任务与以下某个角色相符，您应通过使用适当的 X-Enabled-Tools 或 X-Disabled-Tools 标志重新运行 mcporter config add 命令，动态应用过滤标头。
推荐预设
| 角色 | 目的 | 标头配置 |
|---|
| 审计员 | 只读访问 | --header X-Enabled-Tools=getworkspacehierarchy,getworkspacetasks,gettask,getlist,getfolder,getlistcustomfields,gettaskcomments,gettasktimeentries,getworkspacetimeentries,getcurrenttimeentry,gettasklinks,getspacetags,getworkspacemembers,findmemberbyname,getchatchannels,getchatmessages,getdocument,listdocuments,listdocumentpages,getdocumentpages,submitfeedback |
| 任务工作者 |
日常任务管理 | --header X-Enabled-Tools=getworkspace
hierarchy,getworkspace
tasks,gettask,get
list,getfolder,get
listcustom
fields,createtask,update
task,settask
customfield,move
task,duplicatetask,create
taskcomment,get
taskcomments,attach
taskfile,start
timetracking,stop
timetracking,add
tagto
task,removetag
fromtask,add
tasklink,delete
tasklink,get
tasklinks,add
taskto
list,removetask
fromlist,find
memberby
name,submitfeedback |
|
时间专员 | 跟踪与报告 | --header X-Enabled-Tools=get
workspacehierarchy,get
workspacetasks,get
task,gettask
timeentries,get
workspacetime
entries,getcurrent
timeentry,start
timetracking,stop
timetracking,add
timeentry,delete
timeentry,submit_feedback |
|
内容管理者 | 文档与聊天 | --header X-Enabled-Tools=get
workspacehierarchy,get
workspacetasks,get
task,gettask
comments,createtask
comment,findmember
byname,create
document,getdocument,list
documents,listdocument
pages,getdocument
pages,createdocument
page,updatedocument
page,createchat
channel,getchat
channels,createchat
message,getchat
messages,submitfeedback |
|
安全高级用户 | 完全访问（无删除） | --header X-Disabled-Tools=delete
task,deletebulk
tasks,deletetime
entry,deletetask
link,deletelist,delete
folder,deletespace_tag |
如何应用
要切换到某个角色（例如任务工作者），运行：
bash
mcporter config add ClickUp https://clickup-mcp.taazkareem.com/mcp \
--header X-License-Key=$CLICKUPMCPLICENSE_KEY \
--header X-Enabled-Tools=getworkspacehierarchy,...
个性化与工作流
遵循 OpenClaw 标准，请勿为环境特定细节修改此技能。相反，请使用代理的 workspace/TOOLS.md 文件来定义：
- - 自定义工作流：定义多步骤编排（例如每日总结）。
- 特定 ID：存储常用的 teamid、listids、folder_ids 等。
- 结构或约定：任何规则或一致的行为（例如常见的自定义字段、标签规则等）。
使用方法
使用标准的 mcporter 命令模式：
bash
mcporter call ClickUp.<工具名称> [参数]
