clickup
/clickup
Interact with ClickUp tasks - get task details, view comments, create and manage tasks. Use when working with ClickUp task URLs or IDs.
Assessment and security
- Files in this package
- 15
- Scripts
- 11
- HTML comments
- 0
- URLs in SKILL.md
- 10
No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
- 11 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: api/checklists.mjs, api/client.mjs, api/comments.mjs, api/links.mjs, api/lists.mjs, api/tasks.mjs, api/user.mjs, lib/format.mjs
What it does and when to use it
Interact with ClickUp tasks - get task details, view comments, create and manage tasks. Use when working with ClickUp task URLs or IDs.
Original author description
Interact with ClickUp tasks - get task details, view comments, create and manage tasks. Use when working with ClickUp task URLs or IDs.
How it works
- Setup
- Running Commands
- Examples
- Task/List URL Formats
- Output Format
- When to Use
- Tips
SKILL.md preview
---
name: clickup
description: Interact with ClickUp tasks - get task details, view comments, create and manage tasks. Use when working with ClickUp task URLs or IDs.
---
# ClickUp
Interact with ClickUp tasks via the API. Get task information, view comments, create tasks, manage assignments, and post updates.
## Setup
1. Copy `.env-example` to `.env` in this skill directory
2. Add your ClickUp Personal API Token (starts with `pk_`)
3. Generate token at: ClickUp Settings > Apps > API Token
```bash
cp .claude/skills/clickup/.env-example .claude/skills/clickup/.env
# Edit .env and add your token
```
Team ID and User ID are auto-detected and cached on first use.
### Default List (Optional)
Set `CLICKUP_DEFAULT_LIST_ID` in `.env` to enable creating tasks without specifying a list:
```bash
# In .claude/skills/clickup/.env
CLICKUP_DEFAULT_LIST_ID=901111220963
```
## Running Commands
```bash
node .claude/skills/clickup/query.mjs <command> [options]
```
### Commands
| Command | Description |
|---------|-------------|
| `get <url\|id>` | Get task details (name, description, status, assignees, etc.) |
| `comments <url\|id>` | List comments on a task |
| `comment <url\|id> "message"` | Post a comment to a task (supports markdown) |
| `status <url\|id> [status]` | Update task status (or list available statuses) |
| `tasks <list_id>` | List tasks in a list |
| `me` | Show current user info |
| `create [list_id] "title"` | Create a new task (list_id optional if default set) |
| `my-tasks` | List all tasks assigned to you across workspace |
| `search "query"` | Search tasks by name or description |
| `assign <task> <user>` | Assign task to a user (by name, email, or ID) |
| `due <task> "date"` | Set due date (e.g., "tomorrow", "friday", "+3d") |
| `priority <task> <level>` | Set priority (urgent, high, normal, low, none) |
| `subtask <task> "title"` | Create a subtask |
| `move <task> <list_id>` | Move task to a different list |
| `link <task> <url> ["desc"]` | Add external link reference (as comment) |
| `checklist <task> "item"` | Add checklist item to task |
| `delete-comment <comment_id>` | Delete a comment |
| `watch <task> <user>` | Notify user via @mention comment (watchers not supported in API) |
| `tag <task> "tag_name"` | Add a tag to task |
| `description <task> "text"` | Update task description (markdown supported) |
### Options
| Flag | Description |
|------|-------------|
| `--json` | Output raw JSON response |
| `--subtasks` | Include subtasks when getting task details |
| `--me` | Filter to tasks assigned to me (for tasks command) |
## Examples
### Get Task Details
```bash
# Using full URL
node .claude/skills/clickup/query.mjs get "https://app.clickup.com/t/86a1b2c3d"
# Using task ID directly
node .claude/skills/clickup/query.mjs get 86a1b2c3d
# Include subtasks
node .claude/skills/clickup/query.mjs get 86a1b2c3d --subtasks
```
### Create a Task
```bash
# With explicit list ID
node .claude/skills/clickup/query.mjs create 901111220963 "New feature: dark mode"
# Using default list (if CLICKUP_DEFAULT_LIST_ID is set)
node .claude/skills/clickup/query.mjs create "Quick task"
```
### List My Tasks
```bash
# All tasks assigned to you across the workspace
node .claude/skills/clickup/query.mjs my-tasks
```
### Search Tasks
```bash
node .claude/skills/clickup/query.mjs search "authentication"
```
### Update Task Status
```bash
# List available statuses for a task
node .claude/skills/clickup/query.mjs status 86a1b2c3d
# Update status (case-insensitive, partial match)
node .claude/skills/clickup/query.mjs status 86a1b2c3d "in progress"
node .claude/skills/clickup/query.mjs status 86a1b2c3d "complete"
```
### Assign Tasks
```bash
# Assign by username
node .claude/skills/clickup/query.mjs assign 86a1b2c3d jane
# Assign by email
node .claude/skills/clickup/query.mjs assign 86a1b2c3d jane@example.com
```
### Set Due Dates
```bash
node .claude/skills/clickup/query.mjs due 86a1b2c3d "tomorrow"
node .claude/skills/clickup/query.mjs due 86a1b2c3d "next friday"
node .claude/skills/clickup/query.mjs due 86a1b2c3d "+3d"
node .claude/skills/clickup/query.mjs due 86a1b2c3d "2024-01-15"
```
### Set Priority
```bash
node .claude/skills/clickup/query.mjs priority 86a1b2c3d urgent
node .claude/skills/clickup/query.mjs priority 86a1b2c3d high
node .claude/skills/clickup/query.mjs priority 86a1b2c3d none # Clear priority
```
### Create Subtasks
```bash
node .claude/skills/clickup/query.mjs subtask 86a1b2c3d "Write unit tests"
node .claude/skills/clickup/query.mjs subtask 86a1b2c3d "Update documentation"
```
### Move Tasks
```bash
node .claude/skills/clickup/query.mjs move 86a1b2c3d 901111220964
```
### Add Links
```bash
# Add link with description
node .claude/skills/clickup/query.mjs link 86a1b2c3d "https://github.com/..." "PR #123"
# Add link without description
node .claude/skills/clickup/query.mjs link 86a1b2c3d "https://docs.example.com/guide"
```
### Add Checklist Items
```bash
node .claude/skills/clickup/query.mjs checklist 86a1b2c3d "Review code"
node .claude/skills/clickup/query.mjs checklist 86a1b2c3d "Run tests"
node .claude/skills/clickup/query.mjs checklist 86a1b2c3d "Deploy to staging"
```
### List Tasks in a List
```bash
# All tasks in a list
node .claude/skills/clickup/query.mjs tasks 901111220963
# Only tasks assigned to me
node .claude/skills/clickup/query.mjs tasks 901111220963 --me
```
### View Comments
```bash
node .claude/skills/clickup/query.mjs comments "https://app.clickup.com/t/86a1b2c3d"
```
### Post a Comment
```bash
node .claude/skills/clickup/query.mjs comment 86a1b2c3d "Starting work on this task"
# Multi-line comment
node .claude/skills/clickup/query.mjs comment 86a1b2c3d "Status update:
- Completed initial review
- Found 3 issues to address
- Will submit PR by EOD"
```
### Show Current User
```bash
node .claude/skills/clickup/query.mjs me
```
### Delete a Comment
```bash
# Get comment IDs from the comments command (shown in --json output)
node .claude/skills/clickup/query.mjs delete-comment 90110200841741
```
### Notify Users (Watch)
```bash
# Notify user via @mention comment (ClickUp API doesn't support adding watchers directly)
node .claude/skills/clickup/query.mjs watch 86a1b2c3d john
# Notify by email
node .claude/skills/clickup/query.mjs watch 86a1b2c3d jane@example.com
```
### Add Tags
```bash
# Add a tag to a task
node .claude/skills/clickup/query.mjs tag 86a1b2c3d "DevOps"
node .claude/skills/clickup/query.mjs tag 86a1b2c3d "bug"
```
### Update Description
```bash
# Update task description with markdown
node .claude/skills/clickup/query.mjs description 86a1b2c3d "## Summary
This is a **bold** statement.
- Item 1
- Item 2
See [documentation](https://example.com) for more info."
```
## Task/List URL Formats
The skill recognizes these ClickUp URL formats:
- `https://app.clickup.com/t/{task_id}`
- `https://app.clickup.com/{team_id}/v/li/{list_id}?p={task_id}`
- Direct task ID: `86a1b2c3d`
- Direct list ID: `901111220963`
## Output Format
### Task Details
```
Task: Implement user authentication
Status: In Progress
Priority: High
Assignees: John Doe, Jane Smith
Due: 2024-01-15
Created: 2024-01-10
URL: https://app.clickup.com/t/86a1b2c3d
Description:
Add OAuth2 authentication with Google and GitHub providers...
```
### Task List
```
[to do] Fix login bug
ID: 868h2cxat | Priority: high | Assignees: John Doe
https://app.clickup.com/t/868h2cxat
[in progress] Update API docs
ID: 868g7c75u | Priority: None | Assignees: Jane Smith
https://app.clickup.com/t/868g7c75u
Total: 2 task(s)
```
### Comments
```
[2024-01-12 14:30] John Doe:
Started working on this. Will push initial commit today.
[2024-01-12 16:45] Jane Smith:
@John looks good! Let me know when ready for review.
```
## When to Use
- **Understanding context**: Get task details before starting work
- **Quick task creation**: Create tasks without leaving your terminal
- **Daily standups**: Use `my-tasks` to see your assignments
- **Status updates**: Post progress comments as you work
- **Task management**: Assign, prioritize, and set due dates
- **Collaboration**: View recent comments for context, add watchers
- **Task organization**: Add tags to categorize tasks
- **Task linking**: Reference task IDs in commit messages
## Tips
- Team ID, User ID, and default list ID are auto-cached in `.env`
- Set `CLICKUP_DEFAULT_LIST_ID` to skip list_id when creating team tasks
- Use `my-tasks` for a quick overview of your assignments
- Use natural language dates: "tomorrow", "next friday", "+3d"
- Post comments to keep stakeholders updated on progress
- Include task IDs in commit messages for traceability
- Use `--json` for scripting or piping to other tools
Files in this package (15)
- .env.example 1 KB
- .gitignore 1 KB
- SKILL.md 9 KB
- package.json 1 KB
- query.mjs 22 KB
- api/checklists.mjs 1 KB
- api/client.mjs 2 KB
- api/comments.mjs 1 KB
- api/links.mjs 1 KB
- api/lists.mjs 1 KB
- api/tasks.mjs 8 KB
- api/user.mjs 2 KB
- lib/format.mjs 4 KB
- lib/markdown.mjs 10 KB
- lib/parse.mjs 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · civitai/civitai | 100 | Apache-2.0 |
| TerminalSkills/skills | 100 | Apache-2.0 |
| apideck-libraries/api-skills | 100 | Apache-2.0 |
| craftos-dev/craftbot | 90 | MIT |
| krodak/clickup-cli | 90 | MIT |
| LeoYeAI/openclaw-master-skills | 90 | MIT |
Database snapshot: 13.11.2026 · package version e2ba62dd3225 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 4 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100clickup-cli
ClickUp CLI for managing tasks, sprints, comments, statuses, and Docs. Use when the user needs to interact with ClickUp — creating/editing tasks, checking sprint status, adding comments, linking PRs, managing Docs and pages, or searching tasks. Prefer this CLI over raw API calls. - 100clickup-core-workflow-a
Create, reconcile, update, and retire ClickUp tasks with schema validation, durable source identity, and explicit destructive approval. Use when automating task lifecycle work through ClickUp API v2. Trigger with "ClickUp task sync", "create ClickUp tasks", or "ClickUp task CRUD". - 90ClickUp Task Workflow
This skill should be used when the user mentions "ClickUp task", "CU-xxx", "task workflow", "clickup integration", or when working with task plugin commands (/task:start, /task:done, /task:merge, /task:status, /task:new). Provides workflow patterns for ClickUp task management integrated with kas. - 100clickup-webhooks
Receive and verify ClickUp webhooks. Use when setting up ClickUp webhook handlers, debugging X-Signature verification, or handling ClickUp events like taskCreated, taskUpdated, taskStatusUpdated, or taskCommentPosted. - 95fathom-to-clickup
Run, debug and improve the Fathom to ClickUp automation in this repo (From Fathom action items, Watch call tasks, mention tasks). Use when: Fathom tasks look wrong, missing, duplicated or unrouted; adding a client; someone asks about the task format; or it's time to review what… - 100testing-clickup-cli
Run and manage tests for clickup-cli. Covers unit tests, e2e tests against a real ClickUp workspace, and the test data setup. Use when running tests, adding test coverage, debugging test failures, or setting up test fixtures.