todoist-api
Installation
Summary
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
SKILL.md
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 loginto authenticate via OAuth
Output Formats for Agents
Related skills