Skip to content
clickup CLI clickup CLI

clickup task time list

View time entries for a task or date range

Synopsis

Display time entries logged against a ClickUp task, or query all entries across tasks for a date range (timesheet mode).

Per-task mode (default): Shows entries for a single task. If no task ID is provided, the CLI auto-detects it from the current git branch name.

Timesheet mode: When —start-date and —end-date are provided, shows all time entries across tasks for the given date range. By default filters to the current user; use —assignee to change.

In —json output, duration, start and end are milliseconds as JSON numbers, matching “task time stop” and “task time running”. They were quoted strings before v0.39.0.

clickup task time list [<task-id>] [flags]

Examples

  # List time entries for a specific task
  clickup task time list 86a3xrwkp


  # Auto-detect task from git branch
  clickup task time list


  # Timesheet: all your entries for a month
  clickup task time list --start-date 2026-02-01 --end-date 2026-02-28


  # Timesheet for all workspace members
  clickup task time list --start-date 2026-02-01 --end-date 2026-02-28 --assignee all


  # Timesheet for a specific user
  clickup task time list --start-date 2026-02-01 --end-date 2026-02-28 --assignee 54695018


  # Timesheet for multiple users (fetched concurrently)
  clickup task time list --start-date 2026-03-01 --end-date 2026-03-31 --assignee 48884897,54874661,54874662


  # Output as JSON
  clickup task time list 86a3xrwkp --json


  # Filter with jq
  clickup task time list --start-date 2026-02-01 --end-date 2026-02-28 --jq '[.[] | {task: .task.name, hrs: (.duration / 3600000)}]'

Options

      --assignee string     Filter by user ID(s) — comma-separated, or "all" for everyone (default: current user)
      --end-date string     End date for timesheet mode (YYYY-MM-DD)
  -h, --help                help for list
      --include-tags        Include task tags in JSON output (fetches concurrently, timesheet mode only)
      --jq string           Filter JSON output using a jq expression
      --json                Output JSON
  -r, --raw                 Output raw strings instead of JSON-encoded (use with --jq)
      --start-date string   Start date for timesheet mode (YYYY-MM-DD)
      --tag strings         Filter by task tag(s) — comma-separated or repeated (OR logic, timesheet mode only)
      --template string     Format JSON output using a Go template

SEE ALSO