Todoist CLI

Todoist CLI

A fast, full-featured Todoist CLI written in Go.

Authentication

Get your API token from https://todoist.com/app/settings/integrations/developer

Interactive
todoist auth

Direct
todoist auth <your-token>

Or set environment variable
export TODOIST_API_TOKEN=<your-token>

Tasks

Show today's tasks (default)
todoist

List all tasks
todoist tasks --all

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

Show task descriptions and comments
todoist tasks -p Work --details

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

Complete a task
todoist complete <task-id>
todoist done <task-id>

Reopen completed task
todoist reopen <task-id>

View task details
todoist view <task-id>

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

Delete a task
todoist delete <task-id>

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

Search
todoist search "meeting"

Projects

List projects
todoist projects

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

Labels

List labels
todoist labels

Create label
todoist labels add urgent --color red

Sections

List sections
todoist sections -p Work

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

Comments

View comments on a task
todoist comment <task-id>

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

Completed Tasks

Show recently completed
todoist completed

Filter by date
todoist completed --since 2024-01-01 --limit 50

JSON Output

All commands support --json for machine-readable output:

todoist tasks --json | jq '.[] | .content'

Command Reference

| Command | Description |

|---------|-------------|

| todoist | Show today's tasks |

| todoist tasks | List tasks with filters |

| todoist add | Create a new task |

| todoist complete | Mark task complete |

| todoist done | Alias for complete |

| todoist reopen | Reopen completed task |

| todoist delete | Delete a task |

| todoist update | Update a task |

| todoist move | Move task to section/project |

| todoist view | View task details |

| todoist search | Search tasks |

| todoist projects | List/manage projects |

| todoist labels | List/manage labels |

| todoist sections | List/manage sections |

| todoist comment | View/add comments |

| todoist completed | Show completed tasks |

| todoist auth | Authenticate |

Priority Mapping

| CLI | Todoist |

|-----|---------|

| -P 1 | p1 (highest) |

| -P 2 | p2 |

| -P 3 | p3 |

| -P 4 | p4 (lowest) |

Notes

• -All commands support --json for machine-readable output