| name | clickup |
| description | Browse ClickUp tasks across spaces/folders/lists, view task details, update status, and read comments. Use when user mentions ClickUp, tasks, project management, task status, or asks "what's on my plate" or "show my tasks". |
ClickUp Skill
Browse your ClickUp workspace, view tasks, update status, and read comments. Read-focused with minimal write operations (status updates only).
Quick Start
See all spaces:
"What spaces do I have in ClickUp?"
List tasks in a space:
"Show tasks in the Client Work space"
Find a specific task:
"What's the status of the homepage redesign task?"
Update task status:
"Mark the API integration task as complete"
Read comments:
"Show me comments on task abc123"
Available Operations
| Operation | Module | Script | Description |
|---|
| List Spaces | LIST.md | list_spaces.py | Show all spaces in workspace |
| List Tasks | TASKS.md | list_tasks.py | List tasks with filters |
| Task Details | TASKS.md | task.py | Get full task details |
| Update Status | STATUS.md | update_status.py | Change task status |
| Read Comments | COMMENTS.md | comments.py | View task comments |
Scripts
List Spaces
uv run scripts/list_spaces.py
uv run scripts/list_spaces.py --with-folders
uv run scripts/list_spaces.py --with-lists
List Tasks
uv run scripts/list_tasks.py --space "Client Work"
uv run scripts/list_tasks.py --folder "ProjectX"
uv run scripts/list_tasks.py --list "Sprint 1"
uv run scripts/list_tasks.py --space "Client Work" --status "in progress"
uv run scripts/list_tasks.py --include-closed
Get Task Details
uv run scripts/task.py abc123
uv run scripts/task.py --search "homepage"
uv run scripts/task.py --search "api" --space "Engineering"
Update Task Status
uv run scripts/update_status.py abc123 --status "in progress"
uv run scripts/update_status.py abc123 --complete
uv run scripts/update_status.py --search "homepage" --status "review"
Read Comments
uv run scripts/comments.py abc123
uv run scripts/comments.py abc123 --limit 10
uv run scripts/comments.py --search "homepage"
Conversational Patterns
| Request | Action |
|---|
| "What spaces do I have?" | Run list_spaces.py |
| "Show tasks in [space]" | Run list_tasks.py --space "[space]" |
| "What's in the [folder] folder?" | Run list_tasks.py --folder "[folder]" |
| "Tasks in progress in [space]" | Run list_tasks.py --space "[space]" --status "in progress" |
| "What's the status of [task]?" | Run task.py --search "[task]" |
| "Mark [task] as done" | Run update_status.py --search "[task]" --complete |
| "Show comments on [task]" | Run comments.py --search "[task]" |
Activation Triggers
- "clickup", "tasks", "task list"
- "what's on my plate", "my tasks", "show tasks"
- "task status", "update status"
- "mark as complete", "mark done"
- "task comments"
First-Time Setup
API key is configured in .env as CLICKUP_API_KEY.
To get your API key:
- Go to ClickUp Settings > Apps
- Click "Generate" under API Token
- Copy the token (starts with
pk_)
- Add to
.env: CLICKUP_API_KEY=pk_your_token_here
Hierarchy Overview
Workspace (Team)
└── Space (e.g., "Client Work", "Internal")
├── Folder (optional grouping)
│ └── List (contains tasks)
└── List (folderless - directly in space)
Module Reference