name: todoist description: Manage Todoist tasks, projects, labels, and sections via the todoist CLI. Use when a user asks to add/complete/list tasks, show today's tasks, search tasks, or manage projects. homepage: https://github.com/buddyh/todoist-cli metadata: {"clawdbot":{"emoji":"✅","requires":{"bins":["todoist"]},"install":[{"id":"brew","kind":"brew","formula":"buddyh/tap/todoist","bins":["todoist"],"label":"Install todoist (brew)"},{"id":"go","kind":"go","module":"github.com/buddyh/todoist-cli/cmd/todoist@latest","bins":["todoist"],"label":"Install todoist-cli (go)"}]}}

Todoist CLI

Use todoist to manage tasks, projects, labels, and sections via the Todoist REST API.

Tasks

# Today's tasks (default)
todoist

# List tasks
todoist tasks --all
todoist tasks --filter "p1"           # High priority
todoist tasks --filter "overdue"      # Overdue
todoist tasks -p Work                 # By project

# Add task
todoist add "Buy groceries"
todoist add "Call mom" -d tomorrow
todoist add "Urgent" -P 1 -d "today 5pm" -l urgent

# Complete / reopen
todoist complete <task-id>
todoist done <task-id>
todoist reopen <task-id>

# Update task
todoist update <task-id> --due "next monday"
todoist update <task-id> -P 2

# Move task (Kanban)
todoist move <task-id> --section "In Progress"
todoist move <task-id> --project "Work"

# Delete task
todoist delete <task-id>

# View / search
todoist view <task-id>
todoist search "meeting"

Projects

todoist projects
todoist projects add "New Project" --color blue

Labels

todoist labels
todoist labels add urgent --color red

Sections

todoist sections -p Work
todoist sections add "In Progress" -p Work

Comments

todoist comment <task-id>
todoist comment <task-id> "This is a note"

Completed Tasks

todoist completed
todoist completed --since 2024-01-01 --limit 50

Command Reference

Priority Mapping

Notes

• All commands support --json for machine-readable output
• Auth: todoist auth or set TODOIST_API_TOKEN