SkillPartly tested (needs an account)

Manage Todoist tasks from your agent

Todoist CLI

Official Todoist command-line tool with a skill, so your assistant can list, add, complete and organise your Todoist tasks and projects for you.

Works with
Claude Code, Codex CLI
Good for
Daily work and research

What it does

Todoist is a popular to-do list app. The Todoist CLI is its official command-line tool, made by Doist, the company behind Todoist. It adds a td command to your terminal: td today shows what is due, td add "Buy milk tomorrow #Shopping" adds a task in plain words, and td project list lists your projects.

The CLI can also install a skill (a set of instructions your assistant reads) for Claude Code and Codex. The skill teaches the assistant how to use td, which flags exist and to treat task names and comments as untrusted text, never as instructions. After that you can manage your list by asking your assistant, for example to sort today's tasks or move a set of tasks to another project.

You sign in once through your browser. A read-only login is available if you want the assistant to look but never change anything.

Example prompts

  • The README and skill do not give example prompts. The skill triggers when you mention tasks, inbox, today, upcoming, projects, labels or filters.

How to install

npm install -g @doist/todoist-cli
td auth login
td skill install claude-code
td skill install codex

How to use it

After install, ask your assistant about your tasks in plain words; the skill tells it to use the td command. You can also type td today yourself to see today's and overdue tasks.

Check it works

Run td auth status to see whether you are signed in and in which mode (read-only, read-write or unknown). Run td skill list to see where the skill is installed.

Common problems

Other assistants

  • Gemini CLI: the gemini target installs for Antigravity, not Gemini CLI. Universal (td skill install universal) writes to ~/.agents/skills for Amp, OpenCode and others; Codex also reads this folder — https://github.com/Doist/todoist-cli

What to watch out for

  • Your assistant can change your real Todoist data: create, update, complete, move, archive and delete. Log in with td auth login --read-only if you only want it to read
  • The login token is stored in your system keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service). Only --credential-store=plaintext writes it to a file, with a warning
  • The skill has no disable-model-invocation and its description matches any mention of tasks, inbox, today or projects, so the assistant can load it and run td by itself
  • Needs Node.js 24 or newer and npm 11 (package.json engines). Every command talks to Todoist's servers, and each request carries headers with the CLI version, your OS, a session id and the command name (usage tracking in src/lib/usage-tracking.ts; we found no off switch)
  • A TODOIST_API_TOKEN environment variable always wins over the stored login and is treated as write-capable, even if you logged in read-only
  • td skill install claude-code and codex write to ~/.claude/skills or ~/.codex/skills (the older Codex folder, which still works) and stop if that folder does not exist; td skill install gemini targets Antigravity (~/.gemini/config/skills), not Gemini CLI
  • Updating the CLI updates installed skill files automatically. Extensions (td extension install owner/repo) run third-party programs, so install only ones you trust

Licence and author

Licence
MIT
Author
Doist
Source code
github.com/Doist/todoist-cli

How we tested it

We installed it on an empty test computer on 9 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.

Test level

npm install -g and td skill install claude-code worked once ~/.claude existed; td skill install codex stopped with NOT_INSTALLED without ~/.codex. Not signed in to Todoist, so no task commands were run.

Technical details of the test
Date
9 Nov 2026
Method
Reviewed by our team against the repository at e70566e, its README, the skill text and the source. Installed 5.12.1 in a clean Linux container.

Checked again on 9 Nov 2026

Alternatives

  • linear — connects your assistant to Linear, a team issue tracker; Todoist CLI is for personal and shared to-do lists

FAQ

  • Q: Is this made by Todoist? A: Yes, the repository belongs to Doist, the company that makes Todoist.
  • Q: Can I stop the assistant from deleting tasks? A: Yes. Log in with td auth login --read-only; the CLI then blocks every command that changes data. Do not also set TODOIST_API_TOKEN, which overrides that login.
  • Q: How do I remove it? A: Run td skill uninstall <agent>, then npm uninstall -g @doist/todoist-cli.

Sources

  • github.com/Doist/todoist-cli
  • github.com/Doist/todoist-cli/blob/e70566e/src/lib/skills/index.ts
  • github.com/Doist/todoist-cli/blob/e70566e/src/lib/skills/create-installer.ts
  • github.com/Doist/todoist-cli/blob/e70566e/CHANGELOG.md