How do I install the Todoist skill?

Run npx skillmds@latest add dvcrn/todoist-7 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

Use todoist to manage Todoist tasks directly from the terminal.

Setup

Install: brew install todoist-cli
Get your API token from https://app.todoist.com/app/settings/integrations/developer
Create config:

mkdir -p ~/.config/todoist
echo '{"token": "YOUR_API_TOKEN"}' > ~/.config/todoist/config.json

Sync: todoist sync

List Tasks

todoist list                           # All tasks
todoist list --filter "today"          # Due today
todoist list --filter "overdue"        # Overdue tasks
todoist list --filter "p1"             # Priority 1 (highest)
todoist list --filter "tomorrow"       # Due tomorrow
todoist list --filter "@work"          # By label
todoist list --filter "#Project"       # By project
todoist list --filter "(today | overdue) & p1"  # Combined filters

Add Tasks

todoist add "Buy milk"                                    # Simple task
todoist add "Call mom" --priority 1                       # With priority (1=highest, 4=lowest)
todoist add "Meeting" --date "tomorrow 3pm"               # With due date
todoist add "Report" --project-name "Work"                # To specific project
todoist add "Review" --label-names "urgent,review"        # With labels
todoist quick "Buy eggs tomorrow p1 #Shopping @errands"   # Natural language

Modify Tasks

todoist modify TASK_ID --content "New title"
todoist modify TASK_ID --priority 2
todoist modify TASK_ID --date "next monday"

Complete Tasks

todoist close TASK_ID              # Complete a task
todoist close TASK_ID TASK_ID2     # Complete multiple tasks

Delete Tasks

todoist delete TASK_ID

View Details

todoist show TASK_ID               # Show task details
todoist projects                   # List all projects
todoist labels                     # List all labels

Sync

todoist sync                       # Sync local cache with Todoist

Output Formats

todoist list --csv                 # CSV output for scripting
todoist list --color               # Colorized output
todoist list --namespace           # Show parent tasks as namespace
todoist list --indent              # Indent subtasks

Filter Syntax

Todoist CLI supports the official Todoist filter syntax:

Filter	Description
`today`	Due today
`tomorrow`	Due tomorrow
`overdue`	Past due date
`no date`	No due date
`p1`, `p2`, `p3`, `p4`	Priority level
`@label`	By label
`#Project`	By project
`assigned to: me`	Assigned to you
`7 days`	Due in next 7 days

Combine with & (and), | (or), ! (not):

todoist list --filter "(today | overdue) & p1"
todoist list --filter "#Work & !@done"

Notes

Run todoist sync after making changes in the web/mobile app
Task IDs are numeric (e.g., 12345678)
Config stored in ~/.config/todoist/config.json
Cache stored in ~/.config/todoist/cache.json

---name: todoist-7description: Manage Todoist tasks via the `todoist` CLI (list, add, modify, complete, delete). Supports filters, projects, labels, and priorities.--- # Todoist CLI Use `todoist` to manage Todoist tasks directly from the terminal. ## Setup 1. Install: `brew install todoist-cli` 2. Get your API token from https://app.todoist.com/app/settings/integrations/developer 3. Create config: ```bash mkdir -p ~/.config/todoist echo '{"token": "YOUR_API_TOKEN"}' > ~/.config/todoist/config.json ``` 4. Sync: `todoist sync` ## List Tasks ```bash todoist list # All tasks todoist list --filter "today" # Due today todoist list --filter "overdue" # Overdue tasks todoist list --filter "p1" # Priority 1 (highest) todoist list --filter "tomorrow" # Due tomorrow todoist list --filter "@work" # By label todoist list --filter "#Project" # By project todoist list --filter "(today | overdue) & p1" # Combined filters ``` ## Add Tasks ```bash todoist add "Buy milk" # Simple task todoist add "Call mom" --priority 1 # With priority (1=highest, 4=lowest) todoist add "Meeting" --date "tomorrow 3pm" # With due date todoist add "Report" --project-name "Work" # To specific project todoist add "Review" --label-names "urgent,review" # With labels todoist quick "Buy eggs tomorrow p1 #Shopping @errands" # Natural language ``` ## Modify Tasks ```bash todoist modify TASK_ID --content "New title" todoist modify TASK_ID --priority 2 todoist modify TASK_ID --date "next monday" ``` ## Complete Tasks ```bash todoist close TASK_ID # Complete a task todoist close TASK_ID TASK_ID2 # Complete multiple tasks ``` ## Delete Tasks ```bash todoist delete TASK_ID ``` ## View Details ```bash todoist show TASK_ID # Show task details todoist projects # List all projects todoist labels # List all labels ``` ## Sync ```bash todoist sync # Sync local cache with Todoist ``` ## Output Formats ```bash todoist list --csv # CSV output for scripting todoist list --color # Colorized output todoist list --namespace # Show parent tasks as namespace todoist list --indent # Indent subtasks ``` ## Filter Syntax Todoist CLI supports the [official Todoist filter syntax](https://todoist.com/help/articles/introduction-to-filters-V98wIH): | Filter | Description | |--------|-------------| | `today` | Due today | | `tomorrow` | Due tomorrow | | `overdue` | Past due date | | `no date` | No due date | | `p1`, `p2`, `p3`, `p4` | Priority level | | `@label` | By label | | `#Project` | By project | | `assigned to: me` | Assigned to you | | `7 days` | Due in next 7 days | Combine with `&` (and), `|` (or), `!` (not): ```bash todoist list --filter "(today | overdue) & p1" todoist list --filter "#Work & !@done" ``` ## Notes - Run `todoist sync` after making changes in the web/mobile app - Task IDs are numeric (e.g., `12345678`) - Config stored in `~/.config/todoist/config.json` - Cache stored in `~/.config/todoist/cache.json`

Frequently asked questions

Todoist