A powerful integration for programmatically managing Todoist tasks, projects, and sections via the REST API v1.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install todoist-v1
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install todoist-v1 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Todoist?
The Todoist skill for Openclaw Skills provides a robust interface to interact with one of the world's most popular task management platforms. By utilizing the Todoist REST API v1, this skill allows AI agents to perform complex organizational tasks such as creating action items from conversation context, updating project statuses, and moving tasks between different workflow sections. It bridges the gap between your development environment and your personal productivity stack, ensuring that every actionable item is tracked and organized without manual data entry.
Todoist Use Cases
- Automatically converting GitHub issues or Slack messages into Todoist tasks.
- Synchronizing sprint milestones by creating projects and sections programmatically.
- Setting recurring reminders using natural language strings like "every monday".
- Organizing daily stand-up notes into prioritized tasks based on urgency levels.
- Managing project backlogs by moving tasks across different organizational sections.
How Todoist Works
- The skill initializes by retrieving a secure Bearer token from the environment variables.
- It connects to the Todoist API v1 endpoints to fetch current project or task state.
- User or agent requests are translated into JSON payloads, including parameters like content, priority (1-4), and natural language due dates.
- The skill executes the appropriate HTTP method (GET, POST, or DELETE) to modify task data on the Todoist servers.
- Confirmation of the operation is returned, providing the agent with updated task IDs and metadata for subsequent actions.
Todoist Setup
To get started with this skill in your Openclaw Skills environment, you must first obtain your personal API token from the Todoist Developer Settings.
Export the token as an environment variable:
export TODOIST_TOKEN=your-token-here
You can verify the installation by running a simple list command:
curl -s "https://api.todoist.com/api/v1/tasks" -H "Authorization: Bearer $TODOIST_TOKEN"
Todoist Data Schema & Taxonomy
The skill manages data across three primary objects within the Todoist ecosystem:
| Object | Key Attributes | Purpose |
|---|---|---|
| Task | content, due_string, priority, project_id | Represents individual work items and their deadlines. |
| Project | name, id | High-level containers for grouping related tasks together. |
| Section | name, project_id, order | Sub-categories within projects for kanban or phase-based workflows. |
Priority levels are handled as integers where 1 represents normal priority and 4 represents urgent (P1 in the Todoist UI).
Todoist Advanced Features
- Natural Language Processing: Supports due date strings like "next Friday at 2pm" or "every 3rd Wednesday".
- Section-Based Workflows: Ability to move existing tasks between sections for automated pipeline management.
- Priority Mapping: Programmatically assign urgency levels based on task metadata.
- Project Discovery: Built-in methods to list all active projects and sections to ensure tasks are filed correctly.
- Lightweight Integration: Optimized for Openclaw Skills using standard Bearer token authentication without the overhead of OAuth for personal scripts.
SKILL.md
Loading
Related Openclaw Skills
Mobula - Crypto Market Data & Wallet Intelligence
A comprehensive multi-chain intelligence skill providing oracle-grade crypto market data and deep wallet portfolio tracking across 88+ blockchains.
Timesheet CLI Skill
A professional command-line interface for timesheet.io that enables seamless time tracking and project management for developers.
YouTube Transcript Generator
A specialized utility designed to extract, clean, and format readable text transcripts from any YouTube video URL while removing messy metadata.
Netatmo Smart Home Control
A CLI-based skill to manage Netatmo thermostats and monitor comprehensive environmental sensor data for smarter home automation.
ClawSea Market
A non-custodial automation skill for ClawSea that enables AI agents to interact with NFT marketplaces across Base and Ethereum chains.
Competitor Monitor
An automated AI intelligence tool for tracking competitor pricing, features, and marketing moves in real-time.
Featured*
