How do I install the Todoist skill?

Run npx skillmds@latest add dvcrn/todoist in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Todoist safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Todoist?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Todoist free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Todoist?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Todoist by dvcrn — Agent Skill

Name: Todoist
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Todoist CLI

CLI for Todoist task management, built on the official TypeScript SDK.

Installation

# Requires todoist-ts-cli >= 0.2.0 (for --top / --order)
npm install -g todoist-ts-cli@^0.2.0

Setup

Get API token from https://todoist.com/app/settings/integrations/developer

Either:

todoist auth <your-token>
# or
export TODOIST_API_TOKEN="your-token"

Commands

Tasks

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

todoist add "Buy groceries"
todoist add "Meeting" --due "tomorrow 10am"
todoist add "Review PR" --due "today" --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

Manage Tasks

todoist view <id>          # View task details
todoist done <id>          # Complete task
todoist reopen <id>        # Reopen completed task
todoist update <id> --due "next week"
todoist move <id> -p "Personal"
todoist delete <id>

Search

todoist search "meeting"

Projects & Labels

todoist projects           # List projects
todoist project-add "New Project"
todoist labels             # List labels
todoist label-add "urgent"

Comments

todoist comments <task-id>
todoist comment <task-id> "Note about this task"

Usage Examples

User: "What do I have to do today?"

todoist today

User: "Add 'buy milk' to my tasks"

todoist add "Buy milk" --due "today"

User: "Remind me to call the dentist tomorrow"

todoist add "Call the dentist" --due "tomorrow"

User: "Mark the grocery task as done"

todoist search "grocery"   # Find task ID
todoist done <id>

User: "What's on my work project?"

todoist tasks -p "Work"

User: "Show my high priority tasks"

todoist tasks -f "p1"

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")
Priority 1 is highest, 4 is lowest
Use --order <n> (1-based) or --order top to insert a task at a specific position within a project/section

---name: todoistdescription: Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.---# Todoist CLICLI for Todoist task management, built on the official TypeScript SDK.## Installation```bash# Requires todoist-ts-cli >= 0.2.0 (for --top / --order)npm install -g todoist-ts-cli@^0.2.0```## Setup1. Get API token from https://todoist.com/app/settings/integrations/developer2. Either: ```bash todoist auth <your-token> # or export TODOIST_API_TOKEN="your-token" ```## Commands### Tasks```bashtodoist # Show today's tasks (default)todoist today # Same as abovetodoist tasks # List tasks (today + overdue)todoist tasks --all # All taskstodoist tasks -p "Work" # Tasks in projecttodoist tasks -f "p1" # Filter query (priority 1)todoist tasks --json```### Add Tasks```bashtodoist add "Buy groceries"todoist add "Meeting" --due "tomorrow 10am"todoist add "Review PR" --due "today" --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```### Manage Tasks```bashtodoist view <id> # View task detailstodoist done <id> # Complete tasktodoist reopen <id> # Reopen completed tasktodoist update <id> --due "next week"todoist move <id> -p "Personal"todoist delete <id>```### Search```bashtodoist search "meeting"```### Projects & Labels```bashtodoist projects # List projectstodoist project-add "New Project"todoist labels # List labelstodoist label-add "urgent"```### Comments```bashtodoist comments <task-id>todoist comment <task-id> "Note about this task"```## Usage Examples**User: "What do I have to do today?"**```bashtodoist today```**User: "Add 'buy milk' to my tasks"**```bashtodoist add "Buy milk" --due "today"```**User: "Remind me to call the dentist tomorrow"**```bashtodoist add "Call the dentist" --due "tomorrow"```**User: "Mark the grocery task as done"**```bashtodoist search "grocery" # Find task IDtodoist done <id>```**User: "What's on my work project?"**```bashtodoist tasks -p "Work"```**User: "Show my high priority tasks"**```bashtodoist tasks -f "p1"```## Filter SyntaxTodoist 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")- Priority 1 is highest, 4 is lowest- Use `--order <n>` (1-based) or `--order top` to insert a task at a specific position within a project/section

Frequently asked questions

Todoist