🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Personal Task Tracking

by @mmaggiezhou

Query and manage ClickUp via REST API and the local `scripts/query.sh` helper. Use when listing open or completed tasks, counting due work, looking up spaces...

Versionv1.0.1
πŸ’‘ Examples

Using the Helper Script

The fastest way to query ClickUp:

# Set environment variables
export CLICKUP_API_KEY="pk_..."
export CLICKUP_TEAM_ID="..."
export CLICKUP_ASSIGNEE_ID="..."

Get open tasks due or overdue by a given end time

./scripts/clickup-query.sh tasks --end "2026-03-28 17:00"

Get task counts for open tasks due or overdue by a given end time

./scripts/clickup-query.sh task-count --end "2026-03-28 17:00"

Get tasks completed during a time window

./scripts/clickup-query.sh completed-tasks --start "2026-03-24" --end "2026-03-28 17:00"

Get spaces under the team

./scripts/clickup-query.sh spaces

Get lists under a space_id

./scripts/clickup-query.sh lists 123456

Create a task with given title and due date, assign to CLICKUP_ASSIGNEE_ID, under a list_id

./scripts/clickup-query.sh create-task {list_id} "Follow up with customer" "2026-03-28 17:00"

Close a task with task_id

./scripts/clickup-query.sh close-task 86e0jmdfe

Direct API Calls

For custom queries or operations not covered by the helper script. Example:

# Get all open tasks (with subtasks and pagination)
curl "https://api.clickup.com/api/v2/team/{team_id}/task?include_closed=false&subtasks=true" \
  -H "Authorization: {api_key}"

βš™οΈ Configuration

Before using this skill, ensure the following are configured:

  • API Token: CLICKUP_API_KEY
  • Team/Workspace ID: CLICKUP_TEAM_ID
  • Task Assignee ID: CLICKUP_ASSIGNEE_ID
  • Check if they are available as environment variables:

    echo $CLICKUP_API_KEY
    echo $CLICKUP_TEAM_ID
    echo $CLICKUP_ASSIGNEE_ID
    

    If not available, export them as environment variables.

    export CLICKUP_API_KEY={value}
    export CLICKUP_TEAM_ID={value}
    export CLICKUP_ASSIGNEE_ID={value}
    

    View on ClawHub
    TERMINAL
    clawhub install personal-task-tracking

    πŸ§ͺ Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    πŸ” Can't find the right skill?

    Search 60,000+ AI agent skills β€” free, no login needed.

    Search Skills β†’