todoist

# 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:

```bash
# 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 filte...

# Todoist Skill for OpenClaw

Manage your Todoist tasks directly from OpenClaw. Add tasks, check your list, complete items — all through natural language or CLI commands.

## Features

- ✅ List tasks with filters (today, overdue, by project, by priority)
- ✅ Add new tasks with natural language due dates
- ✅ Complete tasks
- ✅ List all projects
- ✅ Full timezone support (respects your local time)
- ✅ Smart filtering — "today" actually shows today's tasks, not future recurring ones

## Prerequisites

1. **Todoist API Token**
   - Go to https://todoist.com/app/settings/integrations/developer
   - Copy your API token
   - Set it as an environment variable:
     ```bash
     export TODOIST_API_KEY="your_token_here"
     ```

2. **OpenClaw** (if using as a skill)
   - OpenClaw must be installed and running

## Installation

### Option A: Install as OpenClaw Skill (Recommended)

1. Download the latest `.skill` file from [Releases](../../releases)

2. Install to OpenClaw:
   ```bash
   # Copy to OpenClaw skills directory
   sudo cp todoist.skill /usr/lib/node_modules/openclaw/skills/
   
   # Or unzip manually
   sudo unzip todoist.skill -d /usr/lib/node_modules/openclaw/skills/
   ```

3. Restart OpenClaw

4. Done! Now you can say things like:
   - "Show me my tasks for today"
   - "Add 'call dentist' to my todo list for tomorrow"
   - "Complete my task about the meeting"

### Option B: Standalone CLI

If you just want the Python script without OpenClaw integration:

1. Clone this repo:
   ```bash
   git clone https://github.com/YOUR_USERNAME/openclaw-skill-todoist.git
   cd openclaw-skill-todoist
   ```

2. Make sure `TODOIST_API_KEY` is set in your environment

3. Run directly:
   ```bash
   python3 scripts/todoist.py list --filter today
   ```

## Usage

### Natural Language (with OpenClaw)

Once installed, just talk to OpenClaw naturally:

| What you say | What happens |
|-------------|--------------|
| "What tasks do I have today?" | Lists today's open tasks |
|...