A comprehensive MCP integration to manage ClickUp tasks, documentation, and time tracking through an AI agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clickup-mcp
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install clickup-mcp using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is ClickUp MCP?
The ClickUp MCP skill provides a robust interface between your AI development environment and the ClickUp productivity platform. By utilizing the Model Context Protocol, this skill enables AI agents to perform complex workspace operations—such as searching across various content types, managing task lifecycles, and interacting with documentation—without requiring the user to switch context. It is a vital tool for developers using Openclaw Skills to maintain project momentum and documentation accuracy.
This skill connects to the official ClickUp MCP server, ensuring secure and reliable access to workspace hierarchies, team communication channels, and time tracking logs. Whether you are automating sprint updates, attaching files to tasks, or retrieving specifications from ClickUp Docs, this integration brings the full power of ClickUp directly into your AI-driven workflow.
ClickUp MCP Use Cases
- Searching the entire workspace for specific project requirements, technical discussions, or dashboards.
- Creating and updating tasks with priorities, assignees, and detailed descriptions during coding sessions.
- Automating time tracking for development tasks to ensure accurate billing and productivity metrics.
- Managing technical documentation by creating or editing ClickUp Doc pages directly from the CLI.
- Coordinating with team members through ClickUp Chat and task-based comments with @mentions.
How ClickUp MCP Works
- The AI agent establishes a connection to the official ClickUp MCP server using either direct OAuth or a proxied transport like mcporter.
- When a user provides a prompt, the agent identifies the appropriate tool within the Openclaw Skills framework to interact with ClickUp's API.
- The skill handles workspace hierarchy resolution, allowing the agent to locate specific Spaces, Folders, or Lists required for the operation.
- Actions such as task creation, time entry logging, or document retrieval are executed via secure API calls.
- Real-time data is returned to the agent, providing up-to-date context for further development or project management tasks.
ClickUp MCP Setup
Prerequisites
- An active ClickUp account.
- A supported client like Claude Code or a configured
mcporterinstance.
Option 1: Direct OAuth
For allowlisted clients (e.g., Claude Code), add the skill directly:
claude mcp add clickup --transport http https://mcp.clickup.com/mcp
Option 2: Manual Token Configuration (Recommended for mcporter)
- Authorize: Use Claude Code to complete the OAuth flow by running
/mcp. - Extract Token: Retrieve the access token from your local credentials file:
jq -r '.mcpOAuth | to_entries | .[] | select(.key | startswith("clickup")) | .value.accessToken' ~/.claude/.credentials.json
- Environment Setup: Add the extracted token to your
.envfile asCLICKUP_TOKEN. - Configure mcporter: Add the ClickUp server to your
mcporter.jsonwith the following header:
{
"headers": {
"Authorization": "Bearer ${CLICKUP_TOKEN}"
}
}
ClickUp MCP Data Schema & Taxonomy
The ClickUp MCP skill interacts with the standard ClickUp object model to ensure data consistency across your workspace:
| Entity | Scope | Metadata Handled |
|---|---|---|
| Tasks | Workspace-wide | Status, Priority, Assignees, Tags, Attachments |
| Docs | Workspace-wide | Nested Pages, Document Content, Structure |
| Time Entries | Task-specific | Start Time, Duration, Descriptions |
| Chat | Channels | Channel IDs, Message Content |
| Hierarchy | Account-wide | Spaces, Folders, Lists, and Member IDs |
ClickUp MCP Advanced Features
- Universal Search: Execute broad queries across tasks, docs, chat, and files simultaneously.
- Full Document Management: Programmable creation and editing of ClickUp Docs and nested pages.
- Interactive Time Tracking: Start and stop active timers or log historical time entries with automated duration parsing.
- Member Resolution: Easily find member IDs by name or email to automate task assignments.
- Transport Versatility: Support for both direct HTTP transport and secure token-based headers for custom AI agent deployments.
SKILL.md
Loading
Related Openclaw Skills
Roon Controller Skill
A sophisticated Roon music player integration for AI agents featuring automatic core discovery, zone management, and multi-language command support.
OVHcloud Manager
A comprehensive CLI-based skill for managing OVHcloud services including domains, DNS, VPS, and cloud infrastructure through automated API calls.
Groww Trading
An advanced integration for Openclaw Skills that enables real-time Indian stock market trading, portfolio tracking, and market data analysis via the Groww platform.
Firefly III Personal Finance Manager
A comprehensive AI skill for managing personal finances, tracking budgets, and automating transaction logging via the Firefly III API.
Guru MCP
A powerful integration that connects your AI agent to the Guru knowledge base for automated research and internal documentation management.
Marktplaats Search & Automation
A comprehensive tool for searching, filtering, and fetching detailed listing data from Marktplaats.nl.
Featured*
