clickup

Files (1)

• SKILL.md

SKILL.md (first lines)

# ClickUp

Interact with ClickUp using their REST API.

## Setup

1. **Check existing credentials:**
   ```
   vault_get clickup_api_token
   ```

2. **If not configured:**
   - Go to https://app.clickup.com/settings/apps
   - Generate an API Token
   - Save to vault:
     ```
     vault_save clickup_api_token "pk_xxx"
     ```
   The token is auto-injected as `$CLICKUP_API_TOKEN`.

## Get Authorized User & Workspaces

```bash
# Get user info
curl -s "https://api.clickup.com/api/v2/user" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.user'

# Get workspaces (teams)
curl -s "https://api.clickup.com/api/v2/team" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.teams[]'

# Get spaces in workspace
curl -s "https://api.clickup.com/api/v2/team/TEAM_ID/space" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.spaces[]'

# Get lists in space
curl -s "https://api.clickup.com/api/v2/space/SPACE_ID/list" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.lists[]'
```

## Tasks

```bash
# Get tasks from list
curl -s "https://api.clickup.com/api/v2/list/LIST_ID/task" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.tasks[]'

# Get task details
curl -s "https://api.clickup.com/api/v2/task/TASK_ID" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.'

# Get tasks with filters
curl -s "https://api.clickup.com/api/v2/list/LIST_ID/task?status[]=Open&due_date_lt=1735689600000" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.tasks[]'
```

## Create Task

```bash
curl -s -X POST "https://api.clickup.com/api/v2/list/LIST_ID/task" \
  -H "Authorization: $CLICKUP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Implement authentication",
    "description": "Add OAuth2 support",
    "priority": 2,
    "due_date": 1735689600000,
    "assignees": [USER_ID]
  }' | jq '.'
```

## Update Task

```bash
# Update task
curl -s -X PUT "https://api.clickup.com/api/v2/task/TASK_ID" \
  -H "Authorization: $CLICKUP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Updated task name", "status": "in progress"}'

# Close/complete task
curl -s -X PUT "https://api.clickup.com/api/v2/task/TASK_ID" \
  -H "Authorization: $CLICKUP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "complete"}'
```

## Comments

```bash
# Add comment
curl -s -X POST "https://api.clickup.com/api/v2/task/TASK_ID/comment" \
  -H "Authorization: $CLICKUP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"comment_text": "Great progress!"}'

# Get comments
curl -s "https://api.clickup.com/api/v2/task/TASK_ID/comment" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.comments[]'
```

## Time Tracking

```bash
# Start time entry
curl -s -X POST "https://api.clickup.com/api/v2/team/TEAM_ID/time_entries/start" \
  -H "Authorization: $CLICKUP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tid": "TASK_ID"}'

# Stop time entry
curl -s -X POST "https://api.clickup.com/api/v2/team/TEAM_ID/time_entries/stop" \
  -H "Authorization: $CLICKUP_API_TOKEN"

# Get time entries
curl -s "https://api.clickup.com/api/v2/team/TEAM_ID/time_entries?task_id=TASK_ID" \
  -H "Authorization: $CLICKUP_API_TOKEN" | jq '.data[]'
```

## Tips

From jholhewres/devclaw-skills, MIT.

More from jholhewres/devclaw-skills