# Todoist > Manage tasks, projects, sections, labels, and collaborators in Todoist. Use when user asks about tasks, to-dos, reminders, deadlines, assignment, or productivity workflows. - **Type:** Skill - **Install:** `agentstack add skill-mjrussell-agent-skills-todoist` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [mjrussell](https://agentstack.voostack.com/s/mjrussell) - **Installs:** 0 - **Category:** [Productivity](https://agentstack.voostack.com/c/productivity) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [mjrussell](https://github.com/mjrussell) - **Source:** https://github.com/mjrussell/agent-skills/tree/main/todoist ## Install ```sh agentstack add skill-mjrussell-agent-skills-todoist ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Todoist CLI CLI for Todoist task management, built on the official TypeScript SDK. ## Installation ```bash # Requires todoist-ts-cli >= 0.3.0 (deadlines, assignees, sections/collaborators) npm install -g todoist-ts-cli@^0.3.0 ``` ## Setup 1. Get API token from https://todoist.com/app/settings/integrations/developer 2. Either: ```bash todoist auth # or export TODOIST_API_TOKEN="your-token" ``` ## Commands ### Tasks ```bash todoist # Show today's tasks (default) todoist today # Same as above todoist tasks # List tasks (today + overdue) todoist tasks --all # All tasks todoist tasks -p "Work" # Tasks in project todoist tasks -f "p1" # Filter query (priority 1) todoist tasks --json ``` ### Add Tasks ```bash todoist add "Buy groceries" todoist add "Meeting" --due "tomorrow 10am" todoist add "Review PR" --due "today" --deadline "2026-03-05" --priority 1 --project "Work" todoist add "Prep slides" --project "Work" --order 3 # add at a specific position (1-based) todoist add "Triage inbox" --project "Work" --order top # add to top (alternative to --top) todoist add "Call mom" -d "sunday" -l "family" # with label todoist add "Review PR" -p "Work" -a "123456789" # assign to collaborator user ID ``` ### Manage Tasks ```bash todoist view # View task details todoist done # Complete task todoist reopen # Reopen completed task todoist update --due "next week" todoist update --deadline "2026-03-05" todoist update --deadline none # clear deadline todoist update --labels "next,waiting" # replace labels todoist update --add-label next --remove-label waiting todoist update -a "123456789" # assign todoist update -a "null" # unassign todoist move -p "Personal" # move to project todoist move -p "Work" -s "Section A" # move to section todoist move --parent # make sub-task todoist delete ``` ### Search ```bash todoist search "meeting" ``` ### Projects, Sections, Labels ```bash todoist projects # List projects todoist project-add "New Project" todoist project-add "Roadmap" --color blue todoist sections todoist sections -p "Work" todoist section-add "Q1" -p "Work" todoist labels # List labels todoist label-add "urgent" todoist label-add "focus" --color red ``` ### Collaborators ```bash todoist collaborators # list collaborator IDs for assignment ``` ### Comments ```bash todoist comments todoist comment "Note about this task" ``` ## Usage Examples **User: "What do I have to do today?"** ```bash todoist today ``` **User: "Add 'buy milk' to my tasks"** ```bash todoist add "Buy milk" --due "today" ``` **User: "Remind me to call the dentist tomorrow"** ```bash todoist add "Call the dentist" --due "tomorrow" ``` **User: "Mark the grocery task as done"** ```bash todoist search "grocery" # Find task ID todoist done ``` **User: "What's on my work project?"** ```bash todoist tasks -p "Work" ``` **User: "Show my high priority tasks"** ```bash todoist tasks -f "p1" ``` **User: "Assign this task to Alex"** ```bash todoist collaborators # find Alex's collaborator ID todoist update -a "" ``` **User: "Add a hard deadline for this task"** ```bash todoist update --deadline "2026-03-05" ``` **User: "Move this into the Q1 section"** ```bash todoist move -p "Work" -s "Q1" ``` ## Filter Syntax Todoist supports powerful filter queries: - `p1`, `p2`, `p3`, `p4` - Priority levels - `today`, `tomorrow`, `overdue` - `@label` - Tasks with label - `#project` - Tasks in project - `search: keyword` - Search ## Notes - Task IDs are shown in task listings - Due dates support natural language ("tomorrow", "next monday", "jan 15") - Deadlines use explicit dates (`YYYY-MM-DD`) and can be cleared with `--deadline none` - Priority 1 is highest, 4 is lowest - Use `--order ` (1-based) or `--order top` to insert a task at a specific position within a project/section - Assignment needs a collaborator user ID from `todoist collaborators ` - Use `--json` for script-friendly output on supported commands ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [mjrussell](https://github.com/mjrussell) - **Source:** [mjrussell/agent-skills](https://github.com/mjrussell/agent-skills) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-mjrussell-agent-skills-todoist - Seller: https://agentstack.voostack.com/s/mjrussell - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.