todoist-cli

Manage Todoist tasks, projects, labels, and reminders through the td command-line interface.

1|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill todoist-cli-azaidrahman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todoist-cli
Source: https://github.com/azaidrahman/zaid-sani-dotfiles/tree/main/dot_claude/skills/todoist-cli
Command: npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill todoist-cli-azaidrahman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Todoist from an AI assistant or terminal normally requires hand-writing REST API calls and handling authentication, pagination, and ID resolution yourself. This Skill wraps the official td CLI so you can view, create, update, complete, and organize Todoist items with simple commands. ## Core Features & Use Cases - Full task lifecycle: Add tasks with natural language (td task quickadd "Buy milk tomorrow p1 #Shopping"), list, reschedule, move, complete, and delete tasks across projects and workspaces. - Organization and collaboration: Manage projects, sections, labels, filters, folders, workspaces, comments, attachments, notifications, and reminders from one CLI. - Scripting-friendly output: Most commands support --json/--ndjson, --dry-run, and --quiet for safe automation, plus multi-account support via td accounts. - Use Case: Ask the assistant to "show my p1 tasks due today in the Work project and reschedule anything overdue to tomorrow" — the Skill runs the right td commands and reports the results. ## Quick Start Ask the assistant to list your Todoist tasks due today using the todoist-cli skill, after installing the td CLI and running td auth login once.

Frequently Asked Questions about todoist-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a Todoist task from the command line?

Use td task quickadd with natural language, for example td task quickadd "Buy milk tomorrow p1 #Shopping". The parser handles dates, priority, projects, labels, and assignees inline. Use td task add when you need structured flags like --deadline or --parent.

How do I authenticate the Todoist td CLI?

Run td auth login to complete the OAuth flow and store the token in your OS credential manager. Optional scopes like backups, billing, and app-management are added with --additional-scopes, and TODOIST_API_TOKEN overrides stored credentials.

Can the td CLI manage multiple Todoist accounts?

Yes, td auth login can store several accounts at once. Use td accounts list and td accounts use to pick a default, or pass --user <id|email> on any command for a one-off override.

Does td task add support natural language due dates?

The --due flag is sent verbatim to the Todoist API as due_string, so values like "tomorrow" or "every Monday" work. The server parser does not unpack complex clauses such as "starting <date>", so keep due strings simple.

Why should I avoid curl on Todoist attachment URLs?

Downloading an image with curl and reading it can pin a failed vision decode in the conversation context. Use td attachment view <file-url> instead, which returns text or base64 output that is safe to keep in context.