Todoist CLI Skill for Openclaw

A command-line integration that allows AI agents to manage Todoist tasks and agendas using the td CLI.

mattjefferson
v0.1.1
Jan 24, 2026
0
2.9k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install todoist-td

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install todoist-td using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Todoist CLI Skill?

This skill enables AI coding agents to interact with Todoist via the td CLI, providing a robust way to manage to-do lists and project tasks. By integrating this capability into Openclaw Skills, users can leverage natural language to query their agenda, update task details, and maintain organization across their projects without leaving the terminal. It focuses on using structured data formats like JSON to ensure precision when the agent reads or modifies task information.

Todoist CLI Skill Use Cases

  • Reviewing today's agenda and overdue tasks to prioritize work.
  • Adding new tasks rapidly using natural language syntax.
  • Modifying task metadata such as priority levels, labels, and due dates.
  • Moving tasks between the inbox and specific projects.
  • Marking tasks as complete or deleting them following user confirmation.

How Todoist CLI Skill Works

  1. The AI agent identifies a task-related request and triggers the td CLI interface.
  2. The skill queries Todoist for task lists, often requesting output in JSON format for accurate parsing.
  3. Tasks are identified using unique IDs or content matching to ensure the correct item is modified.
  4. Commands are issued to the CLI to perform actions like updates, additions, or status changes.
  5. The agent summarizes the outcome, clearly distinguishing between different task states like overdue or upcoming.

Todoist CLI Skill Setup

To use this integration within Openclaw Skills, you must first install the td CLI from its repository:

git clone https://github.com/Doist/todoist-cli
cd todoist-cli
npm install
npm run build
npm link

Verify the installation by running:

td --help

Ensure your Todoist API token is configured according to the CLI documentation so the agent can authenticate successfully.

Todoist CLI Skill Data Schema & Taxonomy

The skill interacts with Todoist data primarily through JSON objects. The following fields are commonly managed:

Field Description
id The unique identifier for referencing specific tasks
content The title or main text of the todo item
description Detailed notes, often used for links or phone numbers
priority Task priority levels ranging from p1 to p4
due Due dates, supporting natural language strings like "tomorrow 3pm"
labels A comma-separated list of tags for categorization

Todoist CLI Skill Advanced Features

  • Natural language task creation that parses dates, priorities, and projects in a single string.
  • Precision editing using unique task IDs to avoid ambiguity in large lists.
  • Bulk task management through filtered lists and JSON parsing.
  • Support for NDJSON for high-performance data processing in complex workflows.
  • Safety protocols that require explicit user confirmation for destructive actions like deletion.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*