How do I install the Todoist skill?

Run npx skillmds add modbender/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. 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?

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

Todoist by modbender — Agent Skill

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

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 CLI CLI 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 ``` ## Setup 1. Get API token from https://todoist.com/app/settings/integrations/developer 2. Either: ```bash todoist auth <your-token> # 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" --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 ```bash 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 ```bash todoist search "meeting" ``` ### Projects & Labels ```bash todoist projects # List projects todoist project-add "New Project" todoist labels # List labels todoist label-add "urgent" ``` ### Comments ```bash todoist comments <task-id> todoist comment <task-id> "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 <id> ``` **User: "What's on my work project?"** ```bash todoist tasks -p "Work" ``` **User: "Show my high priority tasks"** ```bash 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

Frequently asked questions