{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clickup-mcp",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clickup-mcp",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/clickup-mcp",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "ClickUp MCP (Official)",
        "body": "Access ClickUp via the official MCP server. Full workspace search, task management, time tracking, comments, chat, and docs."
      },
      {
        "title": "Option 1: Direct OAuth (Supported Clients Only)",
        "body": "ClickUp MCP only allows OAuth from allowlisted clients:\n\nClaude Desktop, Claude Code, Cursor, VS Code, Windsurf, ChatGPT\n\n# Claude Code\nclaude mcp add clickup --transport http https://mcp.clickup.com/mcp\n# Then /mcp in session to authorize"
      },
      {
        "title": "Option 2: Claude Code → mcporter (Recommended)",
        "body": "Use Claude Code to OAuth, then extract token for mcporter:\n\nStep 1: Authorize via Claude Code\n\nclaude mcp add clickup --transport http https://mcp.clickup.com/mcp\nclaude\n# In Claude Code, run: /mcp\n# Complete OAuth in browser\n\nStep 2: Extract token\n\njq -r '.mcpOAuth | to_entries | .[] | select(.key | startswith(\"clickup\")) | .value.accessToken' ~/.claude/.credentials.json\n\nStep 3: Add to environment\n\n# Add to ~/.clawdbot/.env\nCLICKUP_TOKEN=eyJhbGciOiJkaXIi...\n\nStep 4: Configure mcporter\n\nAdd to config/mcporter.json:\n\n{\n  \"mcpServers\": {\n    \"clickup\": {\n      \"baseUrl\": \"https://mcp.clickup.com/mcp\",\n      \"description\": \"Official ClickUp MCP\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${CLICKUP_TOKEN}\"\n      }\n    }\n  }\n}\n\nStep 5: Test\n\nmcporter list clickup\nmcporter call 'clickup.clickup_search(keywords: \"test\", count: 3)'"
      },
      {
        "title": "Token Refresh",
        "body": "Tokens are long-lived (~10 years). If expired:\n\nRe-run /mcp in Claude Code\nRe-extract token from ~/.claude/.credentials.json\nUpdate CLICKUP_TOKEN in .env"
      },
      {
        "title": "Search",
        "body": "ToolDescriptionclickup_searchUniversal search across tasks, docs, dashboards, chat, files"
      },
      {
        "title": "Tasks",
        "body": "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"
      },
      {
        "title": "Comments",
        "body": "ToolDescriptionclickup_get_task_commentsGet all comments on taskclickup_create_task_commentAdd comment (supports @mentions)"
      },
      {
        "title": "Time Tracking",
        "body": "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"
      },
      {
        "title": "Workspace & Hierarchy",
        "body": "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"
      },
      {
        "title": "Members",
        "body": "ToolDescriptionclickup_get_workspace_membersList all workspace membersclickup_find_member_by_nameFind member by name/emailclickup_resolve_assigneesGet user IDs from names"
      },
      {
        "title": "Chat",
        "body": "ToolDescriptionclickup_get_chat_channelsList all Chat channelsclickup_send_chat_messageSend message to channel"
      },
      {
        "title": "Docs",
        "body": "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"
      },
      {
        "title": "Search Workspace",
        "body": "mcporter call 'clickup.clickup_search(\n  keywords: \"Q4 marketing\",\n  count: 10\n)'"
      },
      {
        "title": "Create Task",
        "body": "mcporter call 'clickup.clickup_create_task(\n  name: \"Review PR #42\",\n  list_id: \"901506994423\",\n  description: \"Check the new feature\",\n  status: \"to do\"\n)'"
      },
      {
        "title": "Update Task",
        "body": "mcporter call 'clickup.clickup_update_task(\n  task_id: \"abc123\",\n  status: \"in progress\"\n)'"
      },
      {
        "title": "Add Comment",
        "body": "mcporter call 'clickup.clickup_create_task_comment(\n  task_id: \"abc123\",\n  comment_text: \"@Mark can you review this?\"\n)'"
      },
      {
        "title": "Time Tracking",
        "body": "# Start timer\nmcporter call 'clickup.clickup_start_time_tracking(\n  task_id: \"abc123\",\n  description: \"Working on feature\"\n)'\n\n# Stop timer\nmcporter call 'clickup.clickup_stop_time_tracking()'\n\n# Log time manually (duration in ms, e.g., 2h = 7200000)\nmcporter call 'clickup.clickup_add_time_entry(\n  task_id: \"abc123\",\n  start: \"2026-01-06 10:00\",\n  duration: \"2h\",\n  description: \"Code review\"\n)'"
      },
      {
        "title": "Get Workspace Structure",
        "body": "mcporter call 'clickup.clickup_get_workspace_hierarchy(limit: 10)'"
      },
      {
        "title": "Chat",
        "body": "# List channels\nmcporter call 'clickup.clickup_get_chat_channels()'\n\n# Send message\nmcporter call 'clickup.clickup_send_chat_message(\n  channel_id: \"channel-123\",\n  content: \"Team standup in 5 minutes!\"\n)'"
      },
      {
        "title": "Limitations",
        "body": "No delete operations — Safety measure; use ClickUp UI\nNo custom fields — Not exposed in official MCP\nNo views management — Not available\nOAuth required — Must use allowlisted client (Claude Code workaround available)\nRate limits — Same as ClickUp API (~100 req/min)"
      },
      {
        "title": "Resources",
        "body": "ClickUp MCP Documentation\nSupported Tools\nClickUp API Reference\nFeedback / Allowlist Request"
      }
    ],
    "body": "ClickUp MCP (Official)\n\nAccess ClickUp via the official MCP server. Full workspace search, task management, time tracking, comments, chat, and docs.\n\nSetup\nOption 1: Direct OAuth (Supported Clients Only)\n\nClickUp MCP only allows OAuth from allowlisted clients:\n\nClaude Desktop, Claude Code, Cursor, VS Code, Windsurf, ChatGPT\n# Claude Code\nclaude mcp add clickup --transport http https://mcp.clickup.com/mcp\n# Then /mcp in session to authorize\n\nOption 2: Claude Code → mcporter (Recommended)\n\nUse Claude Code to OAuth, then extract token for mcporter:\n\nStep 1: Authorize via Claude Code\n\nclaude mcp add clickup --transport http https://mcp.clickup.com/mcp\nclaude\n# In Claude Code, run: /mcp\n# Complete OAuth in browser\n\n\nStep 2: Extract token\n\njq -r '.mcpOAuth | to_entries | .[] | select(.key | startswith(\"clickup\")) | .value.accessToken' ~/.claude/.credentials.json\n\n\nStep 3: Add to environment\n\n# Add to ~/.clawdbot/.env\nCLICKUP_TOKEN=eyJhbGciOiJkaXIi...\n\n\nStep 4: Configure mcporter\n\nAdd to config/mcporter.json:\n\n{\n  \"mcpServers\": {\n    \"clickup\": {\n      \"baseUrl\": \"https://mcp.clickup.com/mcp\",\n      \"description\": \"Official ClickUp MCP\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${CLICKUP_TOKEN}\"\n      }\n    }\n  }\n}\n\n\nStep 5: Test\n\nmcporter list clickup\nmcporter call 'clickup.clickup_search(keywords: \"test\", count: 3)'\n\nToken Refresh\n\nTokens are long-lived (~10 years). If expired:\n\nRe-run /mcp in Claude Code\nRe-extract token from ~/.claude/.credentials.json\nUpdate CLICKUP_TOKEN in .env\nAvailable Tools (32)\nSearch\nTool\tDescription\nclickup_search\tUniversal search across tasks, docs, dashboards, chat, files\nTasks\nTool\tDescription\nclickup_create_task\tCreate task with name, description, status, assignees, due date, priority\nclickup_get_task\tGet task details (with optional subtasks)\nclickup_update_task\tUpdate any task field\nclickup_attach_task_file\tAttach file to task (URL or base64)\nclickup_add_tag_to_task\tAdd tag to task\nclickup_remove_tag_from_task\tRemove tag from task\nComments\nTool\tDescription\nclickup_get_task_comments\tGet all comments on task\nclickup_create_task_comment\tAdd comment (supports @mentions)\nTime Tracking\nTool\tDescription\nclickup_start_time_tracking\tStart timer on task\nclickup_stop_time_tracking\tStop active timer\nclickup_add_time_entry\tLog time manually\nclickup_get_task_time_entries\tGet time entries for task\nclickup_get_current_time_entry\tCheck active timer\nWorkspace & Hierarchy\nTool\tDescription\nclickup_get_workspace_hierarchy\tGet full structure (Spaces, Folders, Lists)\nclickup_create_list\tCreate list in Space\nclickup_create_list_in_folder\tCreate list in Folder\nclickup_get_list\tGet list details\nclickup_update_list\tUpdate list settings\nclickup_create_folder\tCreate folder in Space\nclickup_get_folder\tGet folder details\nclickup_update_folder\tUpdate folder settings\nMembers\nTool\tDescription\nclickup_get_workspace_members\tList all workspace members\nclickup_find_member_by_name\tFind member by name/email\nclickup_resolve_assignees\tGet user IDs from names\nChat\nTool\tDescription\nclickup_get_chat_channels\tList all Chat channels\nclickup_send_chat_message\tSend message to channel\nDocs\nTool\tDescription\nclickup_create_document\tCreate new Doc\nclickup_list_document_pages\tGet Doc structure\nclickup_get_document_pages\tGet page content\nclickup_create_document_page\tAdd page to Doc\nclickup_update_document_page\tEdit page content\nUsage Examples\nSearch Workspace\nmcporter call 'clickup.clickup_search(\n  keywords: \"Q4 marketing\",\n  count: 10\n)'\n\nCreate Task\nmcporter call 'clickup.clickup_create_task(\n  name: \"Review PR #42\",\n  list_id: \"901506994423\",\n  description: \"Check the new feature\",\n  status: \"to do\"\n)'\n\nUpdate Task\nmcporter call 'clickup.clickup_update_task(\n  task_id: \"abc123\",\n  status: \"in progress\"\n)'\n\nAdd Comment\nmcporter call 'clickup.clickup_create_task_comment(\n  task_id: \"abc123\",\n  comment_text: \"@Mark can you review this?\"\n)'\n\nTime Tracking\n# Start timer\nmcporter call 'clickup.clickup_start_time_tracking(\n  task_id: \"abc123\",\n  description: \"Working on feature\"\n)'\n\n# Stop timer\nmcporter call 'clickup.clickup_stop_time_tracking()'\n\n# Log time manually (duration in ms, e.g., 2h = 7200000)\nmcporter call 'clickup.clickup_add_time_entry(\n  task_id: \"abc123\",\n  start: \"2026-01-06 10:00\",\n  duration: \"2h\",\n  description: \"Code review\"\n)'\n\nGet Workspace Structure\nmcporter call 'clickup.clickup_get_workspace_hierarchy(limit: 10)'\n\nChat\n# List channels\nmcporter call 'clickup.clickup_get_chat_channels()'\n\n# Send message\nmcporter call 'clickup.clickup_send_chat_message(\n  channel_id: \"channel-123\",\n  content: \"Team standup in 5 minutes!\"\n)'\n\nLimitations\nNo delete operations — Safety measure; use ClickUp UI\nNo custom fields — Not exposed in official MCP\nNo views management — Not available\nOAuth required — Must use allowlisted client (Claude Code workaround available)\nRate limits — Same as ClickUp API (~100 req/min)\nResources\nClickUp MCP Documentation\nSupported Tools\nClickUp API Reference\nFeedback / Allowlist Request"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/pvoo/clickup-mcp",
    "publisherUrl": "https://clawhub.ai/pvoo/clickup-mcp",
    "owner": "pvoo",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}