Todoist Skill — Natural Language Task Management

Manage your Todoist tasks conversationally. No need to remember CLI syntax — just talk naturally about your tasks.

Natural Language Examples

This skill understands conversational requests:

List tasks:

• "What tasks do I have today?"

• "Show me my Todoist list for this week"

• "What do I have overdue?"

• "Show priority 1 tasks"

Add tasks:

• "Add 'buy milk' to my todo list"

• "Create a task to call the dentist tomorrow"

• "I need to review the Q4 report by Friday"

• "Add 'weekly standup' due every Monday"

Complete tasks:

• "Complete my task about the dentist"

• "Mark the milk task as done"

• "I finished the report"

Manage projects:

• "What projects do I have in Todoist?"

• "Show tasks from my Work project"

Prerequisites

• TODOIST_API_KEY environment variable must be set with your Todoist API token

• Get your token at: https://todoist.com/app/settings/integrations/developer

Technical Usage

If you prefer CLI commands or need to script operations, use the Python script directly:

# List today's tasks
python3 todoist/scripts/todoist.py list --filter "today"

# Add a task
python3 todoist/scripts/todoist.py add "Buy milk" --due "tomorrow" --priority 2

# Complete a task by ID
python3 todoist/scripts/todoist.py complete "TASK_ID"

# List all projects
python3 todoist/scripts/todoist.py projects

Filter Syntax

When filtering tasks (via natural language or CLI):

• today — tasks due today

• overdue — overdue tasks

• tomorrow — tasks due tomorrow

• p1, p2, p3, p4 — priority filters

• 7 days — tasks due in next 7 days

• @label — tasks with specific label

• #project — tasks in project

• Combine with & (and) and | (or): today & p1

Priority Levels

• 1 — Urgent (red)

• 2 — High (orange)

• 3 — Medium (blue)

• 4 — Low (white/gray, default)

Features

• ✅ Natural language task management

• ✅ Timezone-aware "today" filtering

• ✅ Smart filtering (excludes completed tasks)

• ✅ Recurring task support

• ✅ Full Todoist API v1 coverage

Response Format

The script outputs JSON for programmatic use. See references/api.md for full API documentation.

Notes

• The skill automatically filters out completed tasks

• "Today" uses your local timezone (set TZ environment variable if needed)

• Natural language dates ("tomorrow", "next Friday") use Todoist's built-in parsing