Todoist CLI
Official Todoist command line with an agent skill: tasks, projects and inbox from the terminal
Install
npm install -g @doist/todoist-cli
td auth loginLogin opens a browser. Add --read-only for read-only access.
This is third-party code. Review the repository files before installing.
What it does
The td utility works with a Todoist account from the terminal: quick-add tasks in natural language, see today's and inbox tasks, list tasks by project and open a task by URL. The td skill install command drops a SKILL.md into the chosen agent's folder so the agent can call td on its own. Lists can be printed as JSON, NDJSON or bare IDs for scripting. A read-only mode makes the CLI block any data changes.
Who it is for. For people who run their tasks in Todoist and want an agent to read and update them from the terminal.
Good fit when
- You want the agent to create tasks after a work session or a call
- You want to see today's plan without opening the app
- You need project tasks as JSON for a script
Not a fit when
- Your tasks live somewhere other than Todoist
- The agent must not write to personal tasks: use --read-only in that case
Example request
Show my Todoist tasks for today and add "send the invoice to the client tomorrow" to the Work projectLimitations
Requires a Todoist account and a browser login or API token. The token is kept in the OS credential store by default; without one, login fails unless you explicitly choose plaintext storage. Some commands need extra OAuth scopes. Access to Todoist from Russia without a VPN is unverified.
How to disable. Remove the skill with td skill uninstall <agent>, then run npm uninstall -g @doist/todoist-cli. td auth logout removes the stored token.
Security check
- Creates, updates and deletes tasks in the Todoist account
- Stores an account access token
README in short
The README covers npm installation, browser login with the token kept in the OS keychain, and alternatives: a manual token or the TODOIST_API_TOKEN variable. A dedicated section installs the skill for Claude Code, Codex, Copilot, Cursor, Gemini and the universal .agents folder. It lists core commands, script-friendly output formats, a screen reader mode and shell completion. MIT licensed.
FAQ
How is this different from Todoist MCP?
This is a command line plus a skill describing it: the agent runs td in a terminal. An MCP server plugs into the client as a tool set.
Can I stop the agent from changing tasks?
Yes, log in with td auth login --read-only and create, update and delete commands are blocked.
Related
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI
Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search