Agent skill

todoist

Manage Todoist tasks, projects, labels, and sections via the `todoist` CLI. Use when a user asks to add/complete/list tasks, show today's tasks, search tasks, or manage projects.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/todoist-cli

Metadata

Additional technical details for this skill

clawdbot
{
    "emoji": "\u2705",
    "install": [
        {
            "id": "brew",
            "bins": [
                "todoist"
            ],
            "kind": "brew",
            "label": "Install todoist (brew)",
            "formula": "buddyh/tap/todoist"
        },
        {
            "id": "go",
            "bins": [
                "todoist"
            ],
            "kind": "go",
            "label": "Install todoist-cli (go)",
            "module": "github.com/buddyh/todoist-cli/cmd/todoist@latest"
        }
    ],
    "requires": {
        "bins": [
            "todoist"
        ]
    }
}

SKILL.md

Todoist CLI

Use todoist to manage tasks, projects, labels, and sections via the Todoist REST API.

Tasks

bash
# Today's tasks (default)
todoist

# List tasks
todoist tasks --all
todoist tasks --filter "p1"           # High priority
todoist tasks --filter "overdue"      # Overdue
todoist tasks -p Work                 # By project

# Add task
todoist add "Buy groceries"
todoist add "Call mom" -d tomorrow
todoist add "Urgent" -P 1 -d "today 5pm" -l urgent

# Complete / reopen
todoist complete <task-id>
todoist done <task-id>
todoist reopen <task-id>

# Update task
todoist update <task-id> --due "next monday"
todoist update <task-id> -P 2

# Move task (Kanban)
todoist move <task-id> --section "In Progress"
todoist move <task-id> --project "Work"

# Delete task
todoist delete <task-id>

# View / search
todoist view <task-id>
todoist search "meeting"

Projects

bash
todoist projects
todoist projects add "New Project" --color blue

Labels

bash
todoist labels
todoist labels add urgent --color red

Sections

bash
todoist sections -p Work
todoist sections add "In Progress" -p Work

Comments

bash
todoist comment <task-id>
todoist comment <task-id> "This is a note"

Completed Tasks

bash
todoist completed
todoist completed --since 2024-01-01 --limit 50

Command Reference

Command Description
todoist Show today's tasks
todoist tasks List tasks with filters
todoist add Create a new task
todoist complete Mark task complete
todoist done Alias for complete
todoist reopen Reopen completed task
todoist move Move task to section/project
todoist update Update a task
todoist delete Delete a task
todoist view View task details
todoist search Search tasks
todoist projects List/manage projects
todoist labels List/manage labels
todoist sections List/manage sections
todoist comment View/add comments
todoist completed Show completed tasks

Priority Mapping

CLI Todoist
-P 1 p1 (highest)
-P 2 p2
-P 3 p3
-P 4 p4 (lowest)

Notes

  • All commands support --json for machine-readable output
  • Auth: todoist auth or set TODOIST_API_TOKEN

Didn't find tool you were looking for?

Be as detailed as possible for better results