lvl3dev-todoist-cli 0.1.0

Simple command-line interface for the Todoist API Python SDK.

lvl3dev-todoist-cli

Simple command-line interface for Todoist using the official todoist-api-python SDK.

Development setup (uv)

uv sync

Run commands through uv:

uv run todoist --help

Build and install (uv + pipx)

Build a wheel with uv:

uv build

Install globally with pipx from the built wheel:

pipx install dist/lvl3dev_todoist_cli-*.whl

For local iteration, reinstall after changes with:

pipx install --force dist/lvl3dev_todoist_cli-*.whl

Authentication

Set your API token:

export TODOIST_API_TOKEN="YOUR_API_TOKEN"

You can also pass --token per command.

Usage

todoist --help

Tasks

todoist tasks list
todoist tasks add "Pay rent" --due-string "tomorrow 9am" --priority 1
todoist tasks get <task_id>
todoist tasks update <task_id> --content "Pay rent and utilities"
todoist tasks complete <task_id>
todoist tasks delete <task_id>

Priority values are user-facing Todoist priorities: p1 highest, p4 lowest.

Projects

todoist projects list
todoist projects add "Operations"
todoist projects update <project_id> "Ops"

Comments

todoist comments list --task-id <task_id>
todoist comments add --task-id <task_id> "Started work"

Labels

todoist labels list

JSON Output

Use --json to get structured output:

todoist --json tasks list