/int-todoist

name: int-todoist
description: Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.
homepage: https://todoist.com
metadata:
  clawdbot:
    emoji: "✅"
    requires:
      bins: ["todoist"]
      env: ["TODOIST_API_TOKEN"]

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