Skip to content
clickup CLI clickup CLI

clickup task time log

Log time to a task

Synopsis

Log a time entry against a ClickUp task.

If no task ID is provided, the command attempts to auto-detect the task ID from the current git branch name.

Use —from-file to bulk log time entries from a JSON file. The file should contain an array of objects with task_id, duration, and optionally date, description, assignee, and billable fields.

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

Examples

  # Log 2 hours to a specific task
  clickup task time log 86a3xrwkp --duration 2h


  # Log 1h30m with a description
  clickup task time log --duration 1h30m --description "Implemented auth flow"


  # Log time for a specific date
  clickup task time log 86a3xrwkp --duration 45m --date 2025-01-15


  # Log billable time
  clickup task time log --duration 3h --billable


  # Log time for another team member
  clickup task time log 86a3xrwkp --duration 2h --assignee 54874661


  # Bulk log from a JSON file
  clickup task time log --from-file entries.json

Options

      --assignee string      User ID to log time for (default: current user)
      --billable             Mark time entry as billable
      --date string          Date of the work (YYYY-MM-DD, default today)
      --description string   Description of work done
      --duration string      Duration to log (e.g. "2h", "30m", "1h30m")
      --from-file string     Log time entries from a JSON file (array of entry objects)
  -h, --help                 help for log

SEE ALSO