Manage Todoist tasks via the `todoist` CLI (list, add, modify, complete, delete). Supports filters, projects, labels, and priorities.
Use todoist to manage Todoist tasks directly from the terminal.
brew install todoist-climkdir -p ~/.config/todoist
echo '{"token": "YOUR_API_TOKEN"}' > ~/.config/todoist/config.json
todoist synctodoist list # All tasks
todoist list --filter "today" # Due today
todoist list --filter "overdue" # Overdue tasks
todoist list --filter "p1" # Priority 1 (highest)
todoist list --filter "tomorrow" # Due tomorrow
todoist list --filter "@work" # By label
todoist list --filter "#Project" # By project
todoist list --filter "(today | overdue) & p1" # Combined filters
todoist add "Buy milk" # Simple task
todoist add "Call mom" --priority 1 # With priority (1=highest, 4=lowest)
todoist add "Meeting" --date "tomorrow 3pm" # With due date
todoist add "Report" --project-name "Work" # To specific project
todoist add "Review" --label-names "urgent,review" # With labels
todoist quick "Buy eggs tomorrow p1 #Shopping @errands" # Natural language
todoist modify TASK_ID --content "New title"
todoist modify TASK_ID --priority 2
todoist modify TASK_ID --date "next monday"
todoist close TASK_ID # Complete a task
todoist close TASK_ID TASK_ID2 # Complete multiple tasks
todoist delete TASK_ID
todoist show TASK_ID # Show task details
todoist projects # List all projects
todoist labels # List all labels
todoist sync # Sync local cache with Todoist
todoist list --csv # CSV output for scripting
todoist list --color # Colorized output
todoist list --namespace # Show parent tasks as namespace
todoist list --indent # Indent subtasks
Todoist CLI supports the official Todoist filter syntax:
| Filter | Description |
|---|---|
today | Due today |
tomorrow | Due tomorrow |
overdue | Past due date |
no date | No due date |
p1, p2, p3, p4 | Priority level |
@label | By label |
#Project | By project |
assigned to: me | Assigned to you |
7 days | Due in next 7 days |
Combine with & (and), | (or), ! (not):
todoist list --filter "(today | overdue) & p1"
todoist list --filter "#Work & !@done"
todoist sync after making changes in the web/mobile app12345678)~/.config/todoist/config.json~/.config/todoist/cache.json