todoist

What This Skill Does

The todoist skill provides a seamless interface for interacting with the Todoist REST API v2 through OpenClaw. It abstracts the complexities of OAuth authentication by utilizing the Maton AI managed infrastructure. This skill allows users to programmatically manage their entire Todoist ecosystem, including tasks, projects, sections, labels, and comments. By acting as a secure proxy, the skill ensures that your API interactions are authenticated via your Maton API key, routing requests directly to the Todoist backend while maintaining high security standards. Whether you are building automated task management workflows or simply need to organize your daily agenda, this skill provides the necessary endpoints to perform CRUD operations efficiently.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/byungkyu/todoist-api

Ensure that you have set your MATON_API_KEY environment variable before executing the installation or using the skill to avoid authentication errors. You can obtain your key by visiting your settings page at maton.ai.

Use Cases

This skill is designed for productivity enthusiasts and developers who require deep integration with their task management system. Common use cases include:

• Automating the creation of recurring daily tasks from external triggers.
• Synchronizing project structures between different productivity platforms.
• Querying pending tasks to generate daily briefing summaries.
• Managing team collaboration by programmatically adding comments or updating task statuses based on project milestones.
• Archiving completed items to maintain a clean workspace.

Example Prompts

• "List all tasks due today in my Work project and display their priorities."
• "Create a new task titled 'Review Q1 Report' in the Finance section with a high priority label."
• "Move all completed tasks in the 'Personal' project to the 'Archive' section."

Tips & Limitations

• Authentication: Always verify your MATON_API_KEY is active and properly exported in your environment. If authentication fails, check the status of your connection at https://ctrl.maton.ai.
• Connection Management: The skill supports multiple connections; use the provided connection management endpoints if you need to switch between different Todoist accounts.
• Rate Limiting: Be aware of Todoist API rate limits when scripting high-frequency updates to avoid temporary service throttling.
• Gateway Usage: For non-Todoist integrations, ensure you utilize the api-gateway skill instead of this specific tool to keep your workspace organized.