Neura Market Logo

Todoist

Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.

Matt Russell

@mjrussell

What This Skill Does

Command-line interface for Todoist task management. Supports adding, viewing, completing, searching, and organizing tasks, projects, labels, and comments via the Todoist API.

Replaces manually navigating the Todoist web or mobile app for bulk or automated task operations by exposing all core features through a single CLI.

When to Use It

  • View today's tasks and overdue items from the terminal
  • Add a new task with a due date and priority level
  • Search for a specific task by keyword across all projects
  • Mark a task as completed and optionally reopen it
  • List all tasks in a specific project or with a given label
  • Add a comment to an existing task for additional context

Install

$ openclaw skills install @mjrussell/todoist

Todoist CLI

CLI for Todoist task management, built on the official TypeScript SDK.

Installation

# Requires todoist-ts-cli >= 0.2.0 (for --top / --order)
npm install -g todoist-ts-cli@^0.2.0

Setup

  1. Get API token from https://todoist.com/app/settings/integrations/developer
  2. Either: 
    todoist auth <your-token>
# or
export TODOIST_API_TOKEN="your-token"

Commands

Tasks

todoist                    # Show today's tasks (default)
todoist today              # Same as above
todoist tasks              # List tasks (today + overdue)
todoist tasks --all        # All tasks
todoist tasks -p "Work"    # Tasks in project
todoist tasks -f "p1"      # Filter query (priority 1)
todoist tasks --json

Add Tasks

todoist add "Buy groceries"
todoist add "Meeting" --due "tomorrow 10am"
todoist add "Review PR" --due "today" --priority 1 --project "Work"
todoist add "Prep slides" --project "Work" --order 3  # add at a specific position (1-based)
todoist add "Triage inbox" --project "Work" --order top  # add to top (alternative to --top)
todoist add "Call mom" -d "sunday" -l "family"  # with label

Manage Tasks

todoist view <id>          # View task details
todoist done <id>          # Complete task
todoist reopen <id>        # Reopen completed task
todoist update <id> --due "next week"
todoist move <id> -p "Personal"
todoist delete <id>

Search

todoist search "meeting"

Projects & Labels

todoist projects           # List projects
todoist project-add "New Project"
todoist labels             # List labels
todoist label-add "urgent"

Comments

todoist comments <task-id>
todoist comment <task-id> "Note about this task"

Usage Examples

User: "What do I have to do today?"

todoist today

User: "Add 'buy milk' to my tasks"

todoist add "Buy milk" --due "today"

User: "Remind me to call the dentist tomorrow"

todoist add "Call the dentist" --due "tomorrow"

User: "Mark the grocery task as done"

todoist search "grocery"   # Find task ID
todoist done <id>

User: "What's on my work project?"

todoist tasks -p "Work"

User: "Show my high priority tasks"

todoist tasks -f "p1"

Filter Syntax

Todoist supports powerful filter queries:

  • p1, p2, p3, p4 - Priority levels
  • today, tomorrow, overdue
  • @label - Tasks with label
  • #project - Tasks in project
  • search: keyword - Search

Notes

  • Task IDs are shown in task listings
  • Due dates support natural language ("tomorrow", "next monday", "jan 15")
  • Priority 1 is highest, 4 is lowest
  • Use --order <n> (1-based) or --order top to insert a task at a specific position within a project/section

Top skills in this category

API Gateway

@byungkyu

Connect to external services through Maton-managed API routes. Use this skill only after the user names the target app, account, and task. Start with read/list calls when possible and follow the app-specific reference before any change.

39385k

Nano Pdf

@steipete

Edit PDFs with natural-language instructions using the nano-pdf CLI.

269119k

Word / DOCX

@ivangdavila

Create, inspect, and edit Microsoft Word documents and DOCX files with reliable styles, numbering, tracked changes, tables, sections, and compatibility check...

35288k

Excel / XLSX

@ivangdavila

Create, inspect, and edit Microsoft Excel workbooks and XLSX files with reliable formulas, dates, types, formatting, recalculation, and template preservation...

29278k

Markdown Converter

@steipete

Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.

18747k