Manage Your Todoist Tasks from Your AI Agent with the Todoist-CLI Skill

If you're a Todoist power user, you've probably wished you could tell your AI assistant "add a task for tomorrow" or "show me my overdue items" without opening the app. The todoist-cli skill brings that capability to Clawdbot, giving your agent full control over your task management system.

What This Skill Does

The todoist-cli skill wraps a fast, full-featured Go-based CLI that connects directly to Todoist's API. Your AI agent can:

• List and filter tasks — Show today's tasks, overdue items, or filter by project and priority
• Add tasks — Create tasks with due dates, priorities, labels, and project assignments
• Complete and manage tasks — Mark tasks done, reopen them, update details, or delete them
• Handle projects and sections — Create new projects, manage Kanban-style sections
• Search your tasks — Find tasks by keyword across your entire Todoist workspace
• Work with comments — View and add comments to tasks for extra context

Installation

Install the skill from ClawdHub:

clawdhub install todoist-cli

Then install the CLI itself. On macOS:

brew install buddyh/tap/todoist

Or if you prefer Go:

go install github.com/buddyh/todoist-cli/cmd/todoist@latest

Authentication

Get your API token from Todoist's developer settings, then authenticate:

# Interactive authentication
todoist auth

# Or set directly
todoist auth <your-token>

# Or use an environment variable
export TODOIST_API_TOKEN=<your-token>

For Clawdbot, add the token to your config:

clawdbot config set env.TODOIST_API_TOKEN "<your-token>"
clawdbot gateway restart

Usage Examples

Daily Task Review

Just tell your agent "show my tasks for today":

clawdhub install todoist-cli

This displays all tasks due today — the default view when no command is specified.

Adding Tasks with Natural Language

Your agent can parse your requests and construct the right command:

# Simple task
todoist add "Buy groceries"

# Task with due date
todoist add "Call mom" -d tomorrow

# High-priority task with specific time
todoist add "Submit report" -P 1 -d "today 5pm" -l urgent

# Task in a specific project
todoist add "Review PR" -p Work

Filtering and Searching

Find exactly what you need:

# All high-priority tasks
todoist tasks --filter "p1"

# Overdue tasks
todoist tasks --filter "overdue"

# Tasks in a project with descriptions
todoist tasks -p Work --details

# Search across everything
todoist search "meeting"

Managing Task Workflow

Perfect for Kanban-style workflows:

# Move task to a different section
todoist move <task-id> --section "In Progress"

# Move to another project
todoist move <task-id> --project "Personal"

# Complete a task
todoist complete <task-id>

# Reopen if you need to undo
todoist reopen <task-id>

Pro Tips

Use JSON output for complex workflows. Every command supports --json for structured data your agent can parse:

todoist tasks --json | jq '.[] | .content'

Priority mapping matters. The CLI uses -P 1 through -P 4, where 1 is highest priority (red in Todoist) and 4 is lowest.

Filter syntax is powerful. The --filter flag accepts Todoist's native filter syntax, so you can do complex queries like "p1 & today" or "@work & overdue".

Check completed tasks for accountability. See what you've done:

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

Conclusion

The todoist-cli skill transforms your AI agent into a task management powerhouse. No more context-switching to your phone or browser — just tell your agent what needs doing and it handles the rest.

Install it from ClawdHub: clawdhub install todoist-cli

Links:

• ClawdHub: todoist-cli
• Todoist Developer Settings
• GitHub: buddyh/todoist-cli