todoist-api

SKILL.md

Procedural guidance for Todoist task management via the td CLI tool.

Supports full CRUD operations on tasks, projects, sections, labels, and comments with natural language quick-add parsing (e.g., td add "Buy milk tomorrow p1 #Shopping")

Requires user confirmation before destructive actions (delete, complete, update, archive); read-only operations execute directly

Provides filtering by project, label, priority, due date, assignee, and custom Todoist queries; output as JSON, newline-delimited JSON, or human-readable format

Includes task views (today, upcoming, inbox, completed), project nesting, section organization, reminders, saved filters, and activity tracking

Todoist CLI Skill

This skill provides procedural guidance for working with Todoist using the td CLI tool.

Prerequisites

The td CLI must be installed and authenticated. Verify with:

td auth status

If td is not installed or not authenticated:

Not installed: Tell the user to install with npm install -g @doist/todoist-cli

Not authenticated: Tell the user to run td auth login to authenticate via OAuth

Output Formats for Agents