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-clitd auth logintd skill install claude-codetd skill install codexHow 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
- npm install -g fails with a permissions error (EACCES) on Linux — your global npm folder belongs to root; set a user prefix with npm config set prefix ~/.npm-global, or use a Node version manager — https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally
- npm 11 prints "install-scripts" warnings during install — the skipped postinstall step only refreshes skills you already installed, so a first install still works — https://github.com/Doist/todoist-cli/blob/e70566e/package.json
- Skill install stops for an agent you have not used yet — "does not appear to be installed (… not found)" — open that assistant once so its folder exists, then run the install again — https://github.com/Doist/todoist-cli/blob/e70566e/src/lib/skills/create-installer.ts
- The skill is already there — "Skill file already exists at … Use --force to overwrite." — add --force — https://github.com/Doist/todoist-cli/blob/e70566e/src/lib/skills/create-installer.ts
- Login fails on a machine without a keychain — secure storage is required by default; use td auth login --credential-store=plaintext only if you accept a token in a file — https://github.com/Doist/todoist-cli
- A command fails for a missing permission — the error suggests a td auth login command with --additional-scopes — https://github.com/Doist/todoist-cli
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.
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