todoist-cli

Manage Todoist tasks and metadata via CLI commands.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/huangeddie/dotfiles --skill todoist-cli-huangeddie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todoist-cli
Source: https://github.com/huangeddie/dotfiles/tree/main/dot_agents/exact_packages/assistant/exact_skills/todoist-cli
Command: npx skills add https://github.com/huangeddie/dotfiles --skill todoist-cli-huangeddie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the friction of manually organizing Todoist tasks and projects by letting you view, create, update, complete, and manage Todoist items from the command line.

Core Features & Use Cases

  • Task management across the lifecycle: list, view, add/quickadd, update, reschedule, move, complete/uncomplete, delete, and browse tasks.
  • Organization at scale: manage projects, labels, filters, sections, folders, and workspaces with consistent reference types (name, id, or Todoist URLs where supported).
  • Collaboration and reminders: handle comments, notifications, reminders, and attachments safely, including fetching attachment content via td when needed.
  • Use case: you can quickly capture meeting action items by quick-adding tasks with inline syntax for dates, priority, project, labels, sections, and assignees, then later refine them with structured update commands.

Quick Start

Use the td CLI to add a Todoist task with a due date for tomorrow and priority p1.

Frequently Asked Questions about todoist-cli

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

FAQPage Schema
How do I manage Todoist tasks from the command line?

You can manage Todoist tasks from the command line by using the td CLI to list, view, add, update, complete, and delete tasks. It requires running td auth login first to authenticate your account before executing any task management commands.

Can I quickly add a Todoist task with a due date and priority using the CLI?

Yes, you can quickly add a Todoist task with a due date and priority using the td CLI's quickadd feature. This supports inline syntax for dates, priority levels, projects, labels, sections, and assignees directly within your command input.

Does the Todoist CLI support managing projects, labels, and filters?

The Todoist CLI supports managing projects, labels, filters, sections, folders, and workspaces at scale. You can reference these organizational elements by name, id, or Todoist URLs where supported to execute organization management commands.

How does the Todoist CLI handle untrusted task content and attachments?

The Todoist CLI enforces safe handling for untrusted task content and attachments by using the td attachment view command for content retrieval. This ensures potentially unsafe attachment content is processed securely without direct execution.

What is the best way to script Todoist task lifecycle operations like rescheduling and moving?

The best way to script Todoist task lifecycle operations like rescheduling and moving is using the td CLI. It provides authenticated, scriptable access to update, reschedule, move, complete, uncomplete, and delete tasks programmatically.

Can I handle comments and reminders for Todoist tasks via the command line?

Yes, you can handle comments, notifications, and reminders for Todoist tasks via the command line. The td CLI supports collaboration workflows, allowing you to manage task comments and reminders directly from your terminal.