- name
- todoist
- description
- Manage Todoist tasks via the
todoistCLI (list, add, modify, complete, delete). Supports filters, projects, labels, and priorities. - homepage
- https://github.com/sachaos/todoist
- metadata
- {"clawdbot":{"emoji":"✅","requires":{"bins":["todoist"]},"install":[{"id":"brew","kind":"brew","formula":"todoist-cli","bins":["todoist"],"label":"Install todoist-cli via Homebrew"}]}}
Todoist CLI
Use todoist to manage Todoist tasks directly from the terminal.
Setup
- Install:
brew install todoist-cli - Get your API token from https://app.todoist.com/app/settings/integrations/developer
- Create config:
mkdir -p ~/.config/todoist
echo '{"token": "YOUR_API_TOKEN"}' > ~/.config/todoist/config.json- Sync:
todoist sync
List Tasks
todoist 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 filtersAdd Tasks
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 languageModify Tasks
todoist modify TASK_ID --content "New title"
todoist modify TASK_ID --priority 2
todoist modify TASK_ID --date "next monday"Complete Tasks
todoist close TASK_ID # Complete a task
todoist close TASK_ID TASK_ID2 # Complete multiple tasksDelete Tasks
todoist delete TASK_IDView Details
todoist show TASK_ID # Show task details
todoist projects # List all projects
todoist labels # List all labelsSync
todoist sync # Sync local cache with TodoistOutput Formats
todoist list --csv # CSV output for scripting
todoist list --color # Colorized output
todoist list --namespace # Show parent tasks as namespace
todoist list --indent # Indent subtasksFilter Syntax
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"Notes
- Run
todoist syncafter making changes in the web/mobile app - Task IDs are numeric (e.g.,
12345678) - Config stored in
~/.config/todoist/config.json - Cache stored in
~/.config/todoist/cache.json