todoist

What This Skill Does

The todoist-rs skill allows the OpenClaw AI agent to interface directly with your Todoist account using the td CLI. This provides a robust, terminal-based way to manage tasks without leaving your workspace. The skill supports comprehensive task management, including creating, reading, updating, deleting, and completing tasks. It handles natural language task entry via quick-add functionality, structured task creation with priorities and labels, and deep integration with Todoist projects and sections. By leveraging local caching for read operations, the skill remains highly performant, while providing dedicated flags to force synchronizations when up-to-the-minute data is required.

Installation

To enable this skill, you must first ensure the td CLI tool is installed on your system. You can install it via Homebrew on macOS using brew install LuoAndOrder/tap/todoist-cli or via Cargo by running cargo install todoist-cli-rs. Once the tool is installed, the OpenClaw agent can be configured to execute commands against your account. Ensure your Todoist API token is properly set in your environment variables as required by the td CLI.

Use Cases

• Daily Planning: Quickly audit your schedule by pulling your 'today' view with a single command to see what is on your plate.
• Project Management: Organize tasks into specific projects (e.g., 'Work', 'Personal') and utilize complex filters to isolate high-priority items.
• Efficient Task Capture: Use the 'quick add' feature to ingest tasks from meeting notes or brainstorms, including deadlines and tags, in one go.
• Workflow Automation: Automate status updates by moving tasks between projects or updating their metadata as progress is made in other development tools.

Example Prompts

1. "Check my tasks for today and list only the high-priority ones that are due."
2. "Add a task to the 'Work' project: Prepare quarterly report for next Friday with priority 1, and add a note to include sales metrics."
3. "I just finished the documentation task, can you mark it as done for me?"

Tips & Limitations

Always remember to use the --sync flag if you have just completed a task elsewhere and need the agent to see the updated state immediately, as the agent relies on a local cache for performance. Use the 'quick add' feature for the most natural experience when defining tasks with dates and labels simultaneously. Note that the skill performs direct API writes, so exercise caution when batch-completing tasks to avoid accidental deletions of important to-dos.