lvl3dev-todoist-cli 1.0.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

Install from PyPI:

pipx install lvl3dev-todoist-cli

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"
todoist projects view-style <project_id> board

Sections

todoist sections list --project-id <project_id>
todoist sections add --project-id <project_id> "In Progress"
todoist sections update <section_id> "Doing"
todoist sections delete <section_id>

Boards

todoist boards show --project-id <project_id>
todoist boards move <task_id> --section-id <section_id>

Calendar

todoist calendar today
todoist calendar week
todoist calendar range --from 2026-02-20 --to 2026-02-27
todoist calendar reschedule <task_id> --due-string "tomorrow 9am"

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