# Send ClickUp MCP to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clickup-mcp",
    "name": "ClickUp MCP",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/pvoo/clickup-mcp",
    "canonicalUrl": "https://clawhub.ai/pvoo/clickup-mcp",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/clickup-mcp",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clickup-mcp",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "clickup-mcp",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T12:20:30.816Z",
      "expiresAt": "2026-05-06T12:20:30.816Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clickup-mcp",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clickup-mcp",
        "contentDisposition": "attachment; filename=\"clickup-mcp-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "clickup-mcp"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clickup-mcp"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clickup-mcp",
    "downloadUrl": "https://openagent3.xyz/downloads/clickup-mcp",
    "agentUrl": "https://openagent3.xyz/skills/clickup-mcp/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clickup-mcp/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clickup-mcp/agent.md"
  }
}
```
## Documentation

### ClickUp MCP (Official)

Access ClickUp via the official MCP server. Full workspace search, task management, time tracking, comments, chat, and docs.

### Option 1: Direct OAuth (Supported Clients Only)

ClickUp MCP only allows OAuth from allowlisted clients:

Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, ChatGPT

# Claude Code
claude mcp add clickup --transport http https://mcp.clickup.com/mcp
# Then /mcp in session to authorize

### Option 2: Claude Code → mcporter (Recommended)

Use Claude Code to OAuth, then extract token for mcporter:

Step 1: Authorize via Claude Code

claude mcp add clickup --transport http https://mcp.clickup.com/mcp
claude
# In Claude Code, run: /mcp
# Complete OAuth in browser

Step 2: Extract token

jq -r '.mcpOAuth | to_entries | .[] | select(.key | startswith("clickup")) | .value.accessToken' ~/.claude/.credentials.json

Step 3: Add to environment

# Add to ~/.clawdbot/.env
CLICKUP_TOKEN=eyJhbGciOiJkaXIi...

Step 4: Configure mcporter

Add to config/mcporter.json:

{
  "mcpServers": {
    "clickup": {
      "baseUrl": "https://mcp.clickup.com/mcp",
      "description": "Official ClickUp MCP",
      "headers": {
        "Authorization": "Bearer ${CLICKUP_TOKEN}"
      }
    }
  }
}

Step 5: Test

mcporter list clickup
mcporter call 'clickup.clickup_search(keywords: "test", count: 3)'

### Token Refresh

Tokens are long-lived (~10 years). If expired:

Re-run /mcp in Claude Code
Re-extract token from ~/.claude/.credentials.json
Update CLICKUP_TOKEN in .env

### Search

ToolDescriptionclickup_searchUniversal search across tasks, docs, dashboards, chat, files

### Tasks

ToolDescriptionclickup_create_taskCreate task with name, description, status, assignees, due date, priorityclickup_get_taskGet task details (with optional subtasks)clickup_update_taskUpdate any task fieldclickup_attach_task_fileAttach file to task (URL or base64)clickup_add_tag_to_taskAdd tag to taskclickup_remove_tag_from_taskRemove tag from task

### Comments

ToolDescriptionclickup_get_task_commentsGet all comments on taskclickup_create_task_commentAdd comment (supports @mentions)

### Time Tracking

ToolDescriptionclickup_start_time_trackingStart timer on taskclickup_stop_time_trackingStop active timerclickup_add_time_entryLog time manuallyclickup_get_task_time_entriesGet time entries for taskclickup_get_current_time_entryCheck active timer

### Workspace & Hierarchy

ToolDescriptionclickup_get_workspace_hierarchyGet full structure (Spaces, Folders, Lists)clickup_create_listCreate list in Spaceclickup_create_list_in_folderCreate list in Folderclickup_get_listGet list detailsclickup_update_listUpdate list settingsclickup_create_folderCreate folder in Spaceclickup_get_folderGet folder detailsclickup_update_folderUpdate folder settings

### Members

ToolDescriptionclickup_get_workspace_membersList all workspace membersclickup_find_member_by_nameFind member by name/emailclickup_resolve_assigneesGet user IDs from names

### Chat

ToolDescriptionclickup_get_chat_channelsList all Chat channelsclickup_send_chat_messageSend message to channel

### Docs

ToolDescriptionclickup_create_documentCreate new Docclickup_list_document_pagesGet Doc structureclickup_get_document_pagesGet page contentclickup_create_document_pageAdd page to Docclickup_update_document_pageEdit page content

### Search Workspace

mcporter call 'clickup.clickup_search(
  keywords: "Q4 marketing",
  count: 10
)'

### Create Task

mcporter call 'clickup.clickup_create_task(
  name: "Review PR #42",
  list_id: "901506994423",
  description: "Check the new feature",
  status: "to do"
)'

### Update Task

mcporter call 'clickup.clickup_update_task(
  task_id: "abc123",
  status: "in progress"
)'

### Add Comment

mcporter call 'clickup.clickup_create_task_comment(
  task_id: "abc123",
  comment_text: "@Mark can you review this?"
)'

### Time Tracking

# Start timer
mcporter call 'clickup.clickup_start_time_tracking(
  task_id: "abc123",
  description: "Working on feature"
)'

# Stop timer
mcporter call 'clickup.clickup_stop_time_tracking()'

# Log time manually (duration in ms, e.g., 2h = 7200000)
mcporter call 'clickup.clickup_add_time_entry(
  task_id: "abc123",
  start: "2026-01-06 10:00",
  duration: "2h",
  description: "Code review"
)'

### Get Workspace Structure

mcporter call 'clickup.clickup_get_workspace_hierarchy(limit: 10)'

### Chat

# List channels
mcporter call 'clickup.clickup_get_chat_channels()'

# Send message
mcporter call 'clickup.clickup_send_chat_message(
  channel_id: "channel-123",
  content: "Team standup in 5 minutes!"
)'

### Limitations

No delete operations — Safety measure; use ClickUp UI
No custom fields — Not exposed in official MCP
No views management — Not available
OAuth required — Must use allowlisted client (Claude Code workaround available)
Rate limits — Same as ClickUp API (~100 req/min)

### Resources

ClickUp MCP Documentation
Supported Tools
ClickUp API Reference
Feedback / Allowlist Request
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: pvoo
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T12:20:30.816Z
- Expires at: 2026-05-06T12:20:30.816Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/clickup-mcp)
- [Send to Agent page](https://openagent3.xyz/skills/clickup-mcp/agent)
- [JSON manifest](https://openagent3.xyz/skills/clickup-mcp/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/clickup-mcp/agent.md)
- [Download page](https://openagent3.xyz/downloads/clickup-mcp)