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

Todoist Natural Language

AI Skill Market Insights

Be Part of the 2,443+ Developer Community

Todoist Skill — Natural Language Task Management

Natural Language Examples

Prerequisites

Technical Usage

Add a task

Complete a task by ID

List all projects

Filter Syntax

Priority Levels

Features

Response Format

Notes

Quick Start

Manual Installation

TEAR & SHARE

Tags

writing-plans

executing-plans

plan-ceo-review

Office Automation

Todo Manager

Channels

Learn

Compare

Company