| name | todoist |
| description | Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity. |
| homepage | https://todoist.com |
| metadata | {"clawdbot":{"emoji":"✅","requires":{"bins":["todoist"],"env":["TODOIST_API_TOKEN"]}}} |
Todoist CLI
CLI for Todoist task management, built on the official TypeScript SDK.
Environment
The workspace already provides the todoist CLI. Use the TODOIST_API_TOKEN
environment variable when it is present, or read the task-provided local export
when the user points you to a snapshot file. Do not install CLI packages or
ask the user to create a token during the task.
Commands
Tasks
todoist
todoist today
todoist tasks
todoist tasks --all
todoist tasks -p "Work"
todoist tasks -f "p1"
todoist tasks --json
Add Tasks
todoist add "Buy groceries"
todoist add "Meeting" --due "tomorrow 10am"
todoist add "Review PR" --due "today" --priority 1 --project "Work"
todoist add "Prep slides" --project "Work" --order 3
todoist add "Triage inbox" --project "Work" --order top
todoist add "Call mom" -d "sunday" -l "family"
Manage Tasks
todoist view <id>
todoist done <id>
todoist reopen <id>
todoist update <id> --due "next week"
todoist move <id> -p "Personal"
todoist delete <id>
Search
todoist search "meeting"
Projects & Labels
todoist projects
todoist project-add "New Project"
todoist labels
todoist label-add "urgent"
Comments
todoist comments <task-id>
todoist comment <task-id> "Note about this task"
Usage Examples
User: "What do I have to do today?"
todoist today
User: "Add 'buy milk' to my tasks"
todoist add "Buy milk" --due "today"
User: "Remind me to call the dentist tomorrow"
todoist add "Call the dentist" --due "tomorrow"
User: "Mark the grocery task as done"
todoist search "grocery"
todoist done <id>
User: "What's on my work project?"
todoist tasks -p "Work"
User: "Show my high priority tasks"
todoist tasks -f "p1"
Filter Syntax
Todoist supports powerful filter queries:
p1, p2, p3, p4 - Priority levels
today, tomorrow, overdue
@label - Tasks with label
#project - Tasks in project
search: keyword - Search
Notes
- Task IDs are shown in task listings
- Due dates support natural language ("tomorrow", "next monday", "jan 15")
- Priority 1 is highest, 4 is lowest
- Use
--order <n> (1-based) or --order top to insert a task at a specific position within a project/section