todoist

What This Skill Does

The todoist skill allows your OpenClaw AI agent to interface directly with your Todoist task manager via the Todoist REST API v2. By providing a wrapper around the Todoist CLI, this skill enables seamless management of your productivity workflow. You can perform complex operations such as listing overdue tasks, filtering by project or priority, adding new items with specific due dates, updating existing tasks, and managing your organization's projects, sections, and labels. It effectively turns your AI assistant into a personal project manager capable of handling administrative task maintenance.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/andreisuslov/todoist-manager. After installation, ensure you have a Todoist API token from the Developer section of your Todoist Integration settings. Export this token as an environment variable named TODOIST_API_TOKEN. Finally, grant execution permissions to the script located at ~/clawd/skills/todoist/scripts/todoist using the chmod +x command to ensure the agent has the necessary authority to invoke the CLI.

Use Cases

This skill is perfect for users who want to offload task management to an AI. Use it to quickly process incoming work items, organize projects by moving tasks into sections, or track urgent priorities using Todoist's powerful filter syntax. It is particularly useful for automated daily standups where the AI can report on 'today' and 'overdue' tasks. It also streamlines collaboration by allowing you to add task comments without ever leaving your terminal or chat interface.

Example Prompts

1. "List all my overdue tasks and then add a new high-priority task 'Finish project proposal' due tomorrow at 5pm."
2. "Show me all tasks in the 'Work' project that are tagged with the 'urgent' label."
3. "Mark the task with ID 12345 as complete and add a comment saying 'Done per client request'."

Tips & Limitations

• Use the filter syntax for high-precision task retrieval. You can combine operators like & and | to build sophisticated queries.
• Ensure your API token is kept secure and not hardcoded into scripts.
• The skill relies on Task IDs for updates and deletions; if you are unsure of an ID, always list your tasks first.
• While the CLI is powerful, it is intended for individual task management; ensure your network connection is stable as the skill relies on the Todoist REST API for every operation.