todoist

What This Skill Does

The Todoist skill for OpenClaw transforms your task management workflow into a fluid, conversational experience. By integrating directly with the Todoist API, this agent-based skill allows you to interact with your to-do lists, projects, and deadlines using natural language. Instead of navigating complex web interfaces or memorizing CLI flags, you can simply tell your agent what needs to be done. The skill is context-aware, meaning it respects your local timezone for "today" calculations, understands recurring due dates like "every Monday," and allows for sophisticated filtering using Todoist’s native query syntax. Whether you are adding a quick grocery item or organizing complex professional projects, this skill acts as an intelligent layer between your intent and your task database.

Installation

To enable this skill, ensure you have the OpenClaw CLI installed and configured. First, retrieve your API token from the Todoist developer settings at https://todoist.com/app/settings/integrations/developer. Once you have your token, set the TODOIST_API_KEY environment variable in your terminal session or your OpenClaw configuration file. Finally, install the skill by running the following command in your terminal: clawhub install openclaw/skills/skills/hail2skins/todoist-natural-language. Once installed, the agent will be able to interpret Todoist-related intents automatically.

Use Cases

This skill is designed for power users who want to minimize friction in their productivity workflows. It is ideal for hands-free task entry while working, quick status checks on overdue items during meetings, and managing high-priority workloads by filtering tasks via urgency levels. Developers can also leverage the underlying Python script for automated batch updates or recurring scheduled cleanup tasks via cron jobs.

Example Prompts

1. "Add 'prepare slides for the product demo' with a priority of 1 for next Friday."
2. "Show me all my overdue tasks from the Work project and mark the ones about the Q4 report as complete."
3. "What do I have on my plate for today? Only show me tasks that are high priority."

Tips & Limitations

To get the best results, use specific language when assigning priorities or due dates. Remember that the skill requires the TODOIST_API_KEY to be active. If the agent does not respond as expected, verify your environment variables. Note that while natural language parsing is robust, it relies on Todoist’s internal engine, so complex relative date strings might occasionally require clarification. Always ensure your TZ environment variable is set correctly if you are working across multiple timezones to ensure "today" remains accurate.