ClickUp MCP
Manage ClickUp tasks, docs, time tracking, comments, chat, and search via official MCP. OAuth authentication required.
Manage ClickUp tasks, docs, time tracking, comments, chat, and search via official MCP. OAuth authentication required.
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
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 authorize
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)'
Tokens are long-lived (~10 years). If expired:
/mcp in Claude Code~/.claude/.credentials.jsonCLICKUP_TOKEN in .env| Tool | Description |
|---|---|
| Universal search across tasks, docs, dashboards, chat, files |
| Tool | Description |
|---|---|
| Create task with name, description, status, assignees, due date, priority |
| Get task details (with optional subtasks) |
| Update any task field |
| Attach file to task (URL or base64) |
| Add tag to task |
| Remove tag from task |
| Tool | Description |
|---|---|
| Get all comments on task |
| Add comment (supports @mentions) |
| Tool | Description |
|---|---|
| Start timer on task |
| Stop active timer |
| Log time manually |
| Get time entries for task |
| Check active timer |
| Tool | Description |
|---|---|
| Get full structure (Spaces, Folders, Lists) |
| Create list in Space |
| Create list in Folder |
| Get list details |
| Update list settings |
| Create folder in Space |
| Get folder details |
| Update folder settings |
| Tool | Description |
|---|---|
| List all workspace members |
| Find member by name/email |
| Get user IDs from names |
| Tool | Description |
|---|---|
| List all Chat channels |
| Send message to channel |
| Tool | Description |
|---|---|
| Create new Doc |
| Get Doc structure |
| Get page content |
| Add page to Doc |
| 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!" )'
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.