clickup-mcp

What This Skill Does

The ClickUp MCP skill provides a robust bridge between the OpenClaw agent and your ClickUp workspace. By leveraging the official Model Context Protocol (MCP) server, it allows your agent to perform complex operations including global search, task creation, project management, and granular time tracking. It acts as an extension of your own productivity, enabling the agent to read and modify your project boards, communicate via task comments, and log hours without requiring constant human intervention. Whether you are managing complex development sprints or daily administrative chores, this tool centralizes your ClickUp environment directly within the agent's workflow.

Installation

To get started, you must first ensure your environment is configured for MCP integration. We recommend the mcporter method for maximum flexibility:

1. Install via CLI: clawhub install openclaw/skills/skills/pvoo/clickup-mcp.
2. Authorize the application using Claude Code by running claude mcp add clickup --transport http https://mcp.clickup.com/mcp and following the OAuth browser flow.
3. Extract the accessToken from ~/.claude/.credentials.json using jq.
4. Set this token in your ~/.clawdbot/.env file as CLICKUP_TOKEN.
5. Update your config/mcporter.json with the specified headers to authenticate your calls.
6. Verify the installation by running mcporter list clickup.

Use Cases

• Project Management Automation: Automatically create subtasks when a new issue is identified in a repo.
• Administrative Efficiency: Search for specific documentation or past task discussions across multiple workspaces.
• Accurate Billing: Start and stop time tracking timers based on active development tasks to ensure billable hours are tracked precisely.
• Collaborative Sync: Post updates or feedback to team members directly on task comments using @mentions.

Example Prompts

1. "Search for the 'API documentation' task in ClickUp and summarize the latest comments for me."
2. "Create a new task in the 'Development' folder titled 'Implement Authentication' with high priority and due date set for Friday."
3. "Start the time tracker for the 'Bug Fix' task I'm currently working on."

Tips & Limitations

Tokens generated are long-lived (lasting approximately 10 years), making this a low-maintenance integration. However, always ensure your .env file is protected and never committed to version control. If you encounter authorization errors, simply re-authenticate via the Claude Code /mcp command to refresh your credentials. Note that the agent can only perform actions within the permissions granted by your ClickUp account OAuth scopes.