clickup-mcpManage ClickUp tasks, docs, time tracking, comments, chat, and search via official MCP. OAuth authentication required.
Install via ClawdBot CLI:
clawdbot install pvoo/clickup-mcpRequires:
Access ClickUp via the official MCP server. Full workspace search, task management, time tracking, comments, chat, and docs.
ClickUp MCP only allows OAuth from allowlisted clients:
# Claude Code
claude mcp add clickup --transport http https://mcp.clickup.com/mcp
# Then /mcp in session to authorizeUse 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 browserStep 2: Extract token
jq -r '.mcpOAuth | to_entries | .[] | select(.key | startswith("clickup")) | .value.accessToken' ~/.claude/.credentials.jsonStep 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)'Tokens are long-lived (~10 years). If expired:
/mcp in Claude Code~/.claude/.credentials.jsonCLICKUP_TOKEN in .env| Tool | Description |
|------|-------------|
| clickup_search | Universal search across tasks, docs, dashboards, chat, files |
| Tool | Description |
|------|-------------|
| clickup_create_task | Create task with name, description, status, assignees, due date, priority |
| clickup_get_task | Get task details (with optional subtasks) |
| clickup_update_task | Update any task field |
| clickup_attach_task_file | Attach file to task (URL or base64) |
| clickup_add_tag_to_task | Add tag to task |
| clickup_remove_tag_from_task | Remove tag from task |
| Tool | Description |
|------|-------------|
| clickup_get_task_comments | Get all comments on task |
| clickup_create_task_comment | Add comment (supports @mentions) |
| Tool | Description |
|------|-------------|
| clickup_start_time_tracking | Start timer on task |
| clickup_stop_time_tracking | Stop active timer |
| clickup_add_time_entry | Log time manually |
| clickup_get_task_time_entries | Get time entries for task |
| clickup_get_current_time_entry | Check active timer |
| Tool | Description |
|------|-------------|
| clickup_get_workspace_hierarchy | Get full structure (Spaces, Folders, Lists) |
| clickup_create_list | Create list in Space |
| clickup_create_list_in_folder | Create list in Folder |
| clickup_get_list | Get list details |
| clickup_update_list | Update list settings |
| clickup_create_folder | Create folder in Space |
| clickup_get_folder | Get folder details |
| clickup_update_folder | Update folder settings |
| Tool | Description |
|------|-------------|
| clickup_get_workspace_members | List all workspace members |
| clickup_find_member_by_name | Find member by name/email |
| clickup_resolve_assignees | Get user IDs from names |
| Tool | Description |
|------|-------------|
| clickup_get_chat_channels | List all Chat channels |
| clickup_send_chat_message | Send message to channel |
| Tool | Description |
|------|-------------|
| clickup_create_document | Create new Doc |
| clickup_list_document_pages | Get Doc structure |
| clickup_get_document_pages | Get page content |
| clickup_create_document_page | Add page to Doc |
| clickup_update_document_page | Edit page content |
mcporter call 'clickup.clickup_search(
keywords: "Q4 marketing",
count: 10
)'mcporter call 'clickup.clickup_create_task(
name: "Review PR #42",
list_id: "901506994423",
description: "Check the new feature",
status: "to do"
)'mcporter call 'clickup.clickup_update_task(
task_id: "abc123",
status: "in progress"
)'mcporter call 'clickup.clickup_create_task_comment(
task_id: "abc123",
comment_text: "@Mark can you review this?"
)'# 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"
)'mcporter call 'clickup.clickup_get_workspace_hierarchy(limit: 10)'# 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!"
)'Generated Mar 1, 2026
A project manager uses the skill to create tasks, assign them to team members via assignee resolution, and track progress through status updates and comments. They can search across the workspace for related tasks and documents, ensuring alignment and timely completion of project milestones.
Developers leverage the skill to manage coding tasks, log time entries for sprints, and attach files like code snippets to tasks. They use comments for code reviews and integrate with chat channels to coordinate standups and updates, streamlining agile workflows.
Marketing teams create tasks for campaign elements, track time spent on creative work, and use docs for content planning. They search for past campaigns to reference materials and send chat messages to coordinate launches across channels.
A freelancer uses the skill to start and stop timers on client tasks, manually log hours for billing, and generate time entry reports. They create tasks for project deliverables and update statuses to keep clients informed on progress.
Administrators manage course planning by creating lists and folders for different departments, assigning tasks to faculty, and tracking time for curriculum development. They use docs for syllabus creation and search for resources across the workspace.
Companies integrate the skill into their ClickUp subscription to enhance team productivity, offering premium features like advanced search and time tracking. Revenue is generated through tiered plans based on user count and tool access, with upsells for additional integrations.
Consultants use the skill to manage client projects, providing services like workflow automation and data analysis via ClickUp tools. Revenue comes from hourly billing or fixed project fees, leveraging the skill for efficient task and time management.
A freemium model offers basic task management and search for free, with revenue from premium upgrades for advanced features like unlimited time tracking, chat integration, and priority support. This attracts small teams and scales with business growth.
💬 Integration Tip
Use the mcporter workaround for OAuth if not on an allowlisted client, and regularly refresh tokens by re-authorizing in Claude Code to maintain access.
Manage Trello boards, lists, and cards via the Trello REST API.
Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.
Master OpenClaw's timing systems. Use for scheduling reliable reminders, setting up periodic maintenance (janitor jobs), and understanding when to use Cron v...
Calendar management and scheduling. Create events, manage meetings, and sync across calendar providers.
Kanban-style task management dashboard for AI assistants. Manage tasks via CLI or dashboard UI. Use when user mentions tasks, kanban, task board, mission con...