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 login to authenticate via OAuth

Output Formats for Agents

For machine-readable output, use these flags:

Related skills

More from intellectronica/agent-skills

Installs
759
GitHub Stars
259
First Seen
Jan 28, 2026