Todoist Natural Language

Integrate with Todoist task management using natural language. Use when the user wants to manage Todoist tasks or projects through conversational commands li...

Security Scan

The skill's code, instructions, and required environment variables are coherent for a Todoist integration and request only the Todoist API token (and optional TZ); nothing in the package appears disproportionate or unrelated to its stated purpose.

Purpose & Capability

Name/description, SKILL.md, README, skill.json, and the included Python client all align: this is a Todoist client that needs a Todoist API token. The code talks directly to api.todoist.com and the Sync API when needed, which is appropriate for the claimed features.

Instruction Scope

Runtime instructions and CLI usage only reference the Todoist API, the TODOIST_API_KEY env var, and optional TZ. The SKILL.md does not instruct reading unrelated files, other credentials, or exfiltrating data to third-party endpoints; behavior stays within the described scope.

Install Mechanism

No install spec is provided (instruction-only), and included files are Python and docs. There are no downloads from arbitrary URLs or archive extraction steps. README suggests manual copy/CLI usage which is low-risk.

Credentials

The only required secret is TODOIST_API_KEY (declared in SKILL.md and skill.json) and optional TZ for timezone handling. These are proportional to a Todoist integration; no unrelated secrets or config paths are requested.

Persistence & Privilege

The skill does not request always:true and contains no install hooks that modify other skills or global configs. It runs as an on-demand skill or CLI script and does not demand elevated persistent privileges.

Assessment

This skill appears to do exactly what it claims: it will send requests to api.todoist.com and the Todoist Sync endpoint using the TODOIST_API_KEY you provide. Before installing, ensure you are comfortable granting the Todoist API token (it can create, update, complete, and delete tasks). Review the included scripts yourself if you want to confirm behavior, avoid running installs as root, and keep your API token scoped/rotated according to your Todoist account security practices.

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