todoist

What This Skill Does

The todoist skill integrates the Todoist CLI directly into OpenClaw, allowing you to manage your entire task workflow without leaving the terminal. Whether you need to list, add, modify, or complete tasks, this skill provides a powerful, programmatic interface for your Todoist account. It supports advanced filtering (including priority, date-based, project-based, and label-based filtering), allowing you to query exactly what you need to focus on. With native support for natural language task entry via the quick command, you can add complex tasks with due dates, priorities, and labels in a single line. It also allows for bulk actions, such as completing multiple tasks at once.

Installation

To get started, follow these steps:

1. Install the CLI tool via Homebrew: brew install todoist-cli.
2. Obtain your API token from the Todoist Developer settings.
3. Create the configuration directory and file: mkdir -p ~/.config/todoist && echo '{"token": "YOUR_API_TOKEN"}' > ~/.config/todoist/config.json.
4. Run todoist sync to initialize your local cache.
5. Install the skill: clawhub install openclaw/skills/skills/2mawi2/todoist-task-manager.

Use Cases

• Project Management: Organize tasks by project and filter by labels like @work or @home.
• Daily Planning: Use todoist list --filter "today" to view your schedule for the day.
• Task Prioritization: Quickly view your most urgent items using p1 filters.
• Automated Reporting: Generate CSV lists of completed tasks for productivity tracking.
• Rapid Entry: Use natural language commands to quickly dump tasks into your inbox while in the middle of a development flow.

Example Prompts

1. "What do I have on my plate for today that is priority 1?"
2. "Add a new task to my Work project: Submit quarterly report tomorrow at 5pm."
3. "Mark tasks 12345 and 67890 as complete."

Tips & Limitations

• Syncing: Always run todoist sync if you have made changes on other devices to ensure your local view is current.
• Filter Syntax: Leverage the power of the standard Todoist filter language to chain complex queries with &, |, and ! operators.
• Limitations: This skill relies on the local CLI cache. If the local state is out of sync, ensure your internet connection is active and perform a manual sync. The modify command requires a known TASK_ID, which can be retrieved via the list command.