Todoist Api

If you're managing Todoist from the command line with the td CLI, this skill gives Claude the complete playbook. It covers task CRUD, projects, sections, labels, comments, and all the filtering options you'd actually use. The natural language quick add syntax is well documented (dates, priorities, labels all in one string), and there's proper guidance on JSON output formats for programmatic use. One thing done right: it enforces confirmation prompts before destructive actions like deletions or completions, which prevents the "wait, did I just archive my entire Work project?" moments. Useful if you're building automation or just want Claude to manipulate your task list without switching contexts.

skills.sh installs: 1.7K
GitHub stars: 301
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add intellectronica/agent-skills --skill todoist-api --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

--json - Output as JSON array
--ndjson - Output as newline-delimited JSON (one object per line)
--full - Include all fields in JSON output (default shows essential fields only)

Confirmation Requirement

Before executing any destructive action, always ask the user for confirmation using AskUserQuestion or similar tool. A single confirmation suffices for a logical group of related actions.

Destructive actions include: