Todoist

Todoist CLI

CLI for Todoist task management, built on the official TypeScript SDK.

Installation

# Requires todoist-ts-cli >= 0.3.0 (deadlines, assignees, sections/collaborators)
npm install -g todoist-ts-cli@^0.3.0

Setup

1. Get API token from https://todoist.com/app/settings/integrations/developer
2. Either:

``bash todoist auth # or export TODOIST_API_TOKEN="your-token" ``

Commands

Tasks

todoist                    # Show today's tasks (default)
todoist today              # Same as above
todoist tasks              # List tasks (today + overdue)
todoist tasks --all        # All tasks
todoist tasks -p "Work"    # Tasks in project
todoist tasks -f "p1"      # Filter query (priority 1)
todoist tasks --json

Add Tasks

todoist add "Buy groceries"
todoist add "Meeting" --due "tomorrow 10am"
todoist add "Review PR" --due "today" --deadline "2026-03-05" --priority 1 --project "Work"
todoist add "Prep slides" --project "Work" --order 3  # add at a specific position (1-based)
todoist add "Triage inbox" --project "Work" --order top  # add to top (alternative to --top)
todoist add "Call mom" -d "sunday" -l "family"  # with label
todoist add "Review PR" -p "Work" -a "123456789"  # assign to collaborator user ID

Manage Tasks

todoist view           # View task details
todoist done           # Complete task
todoist reopen         # Reopen completed task
todoist update  --due "next week"
todoist update  --deadline "2026-03-05"
todoist update  --deadline none  # clear deadline
todoist update  --labels "next,waiting"  # replace labels
todoist update  --add-label next --remove-label waiting
todoist update  -a "123456789"  # assign
todoist update  -a "null"       # unassign
todoist move  -p "Personal"                 # move to project
todoist move  -p "Work" -s "Section A"      # move to section
todoist move  --parent             # make sub-task
todoist delete 

Search

todoist search "meeting"

Projects, Sections, Labels

todoist projects           # List projects
todoist project-add "New Project"
todoist project-add "Roadmap" --color blue
todoist sections
todoist sections -p "Work"
todoist section-add "Q1" -p "Work"
todoist labels             # List labels
todoist label-add "urgent"
todoist label-add "focus" --color red

Collaborators

todoist collaborators   # list collaborator IDs for assignment

Comments

todoist comments 
todoist comment  "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"   # Find task ID
todoist done 

User: "What's on my work project?"

todoist tasks -p "Work"

User: "Show my high priority tasks"

todoist tasks -f "p1"

User: "Assign this task to Alex"

todoist collaborators    # find Alex's collaborator ID
todoist update  -a ""

User: "Add a hard deadline for this task"

todoist update  --deadline "2026-03-05"

User: "Move this into the Q1 section"

todoist move  -p "Work" -s "Q1"

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")
• Deadlines use explicit dates (YYYY-MM-DD) and can be cleared with --deadline none
• Priority 1 is highest, 4 is lowest
• Use --order (1-based) or --order top to insert a task at a specific position within a project/section
• Assignment needs a collaborator user ID from todoist collaborators
• Use --json for script-friendly output on supported commands

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: mjrussell
• Source: mjrussell/agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.