How do I install the Todoist skill?

Run npx skillmds@latest add demerzels-lab/todoist-3 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. 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?

Demerzels-lab (@demerzels-lab) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Todoist by demerzels-lab — Agent Skill

Name: Todoist
Author: Demerzels-lab

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-3description: Manage Todoist tasks via the `todoist` CLI (list, add, modify, complete, delete). Supports filters, projects, labels, and priorities.---# Todoist CLIUse `todoist` to manage Todoist tasks directly from the terminal.## Setup1. Install: `brew install todoist-cli`2. Get your API token from https://app.todoist.com/app/settings/integrations/developer3. Create config:```bashmkdir -p ~/.config/todoistecho '{"token": "YOUR_API_TOKEN"}' > ~/.config/todoist/config.json```4. Sync: `todoist sync`## List Tasks```bashtodoist list # All taskstodoist list --filter "today" # Due todaytodoist list --filter "overdue" # Overdue taskstodoist list --filter "p1" # Priority 1 (highest)todoist list --filter "tomorrow" # Due tomorrowtodoist list --filter "@work" # By labeltodoist list --filter "#Project" # By projecttodoist list --filter "(today | overdue) & p1" # Combined filters```## Add Tasks```bashtodoist add "Buy milk" # Simple tasktodoist add "Call mom" --priority 1 # With priority (1=highest, 4=lowest)todoist add "Meeting" --date "tomorrow 3pm" # With due datetodoist add "Report" --project-name "Work" # To specific projecttodoist add "Review" --label-names "urgent,review" # With labelstodoist quick "Buy eggs tomorrow p1 #Shopping @errands" # Natural language```## Modify Tasks```bashtodoist modify TASK_ID --content "New title"todoist modify TASK_ID --priority 2todoist modify TASK_ID --date "next monday"```## Complete Tasks```bashtodoist close TASK_ID # Complete a tasktodoist close TASK_ID TASK_ID2 # Complete multiple tasks```## Delete Tasks```bashtodoist delete TASK_ID```## View Details```bashtodoist show TASK_ID # Show task detailstodoist projects # List all projectstodoist labels # List all labels```## Sync```bashtodoist sync # Sync local cache with Todoist```## Output Formats```bashtodoist list --csv # CSV output for scriptingtodoist list --color # Colorized outputtodoist list --namespace # Show parent tasks as namespacetodoist list --indent # Indent subtasks```## Filter SyntaxTodoist 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):```bashtodoist 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