A lightweight, direct integration for managing Todoist tasks, projects, and sections using standard shell tools and API endpoints.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install todoist-api-rest
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-api-rest 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 API REST Skill?
The Todoist API REST skill provides a robust and minimalist way to interact with your Todoist workspace without the need for heavy CLI wrappers. By leveraging curl and jq, this skill ensures that Openclaw Skills can perform complex task management operations with high reliability and low overhead. It is designed to bridge the gap when official CLIs are unavailable or failing, providing a direct pipeline to Todoist's backend infrastructure.
This skill is particularly valuable for developers who need to automate their productivity workflows within a scriptable environment. It handles both the modern REST v2 API and provides necessary fallbacks to API v1 for legacy compatibility, ensuring that your automation remains functional even as the external platform evolves. This flexibility makes it a staple for anyone looking to extend their Openclaw Skills library with professional task management capabilities.
Todoist API REST Skill Use Cases
- Automating task creation during CI/CD pipeline runs or code commits.
- Programmatically closing tasks when specific development milestones are reached.
- Fetching and displaying active tasks within a developer dashboard or terminal UI.
- Synchronizing Todoist projects and sections with external project management tools.
- Generating automated reports of completed tasks for daily or weekly standups.
How Todoist API REST Skill Works
- The skill initializes by sourcing the TODOIST_API_TOKEN from the environment or a secure local configuration file.
- It executes curl commands to interact with specific Todoist REST v2 endpoints for tasks, projects, and sections.
- Results are processed through jq to filter and format the JSON output for human or machine readability.
- If the REST v2 endpoint returns a 410 Gone error, the workflow automatically utilizes the API v1 fallback commands.
- Post-request actions, such as task completion or section filtering, are handled through targeted POST and GET requests.
Todoist API REST Skill Setup
To get started with this skill, ensure that curl and jq are installed on your system. You will also need to configure your authentication token.
# Install dependencies (example for Debian/Ubuntu)
sudo apt-get install curl jq
# Set your API token as an environment variable
export TODOIST_API_TOKEN="your_token_here"
# Alternatively, ensure the token is available in the secrets directory
mkdir -p ~/.openclaw/.secrets/
echo '{"token": "your_token_here"}' > ~/.openclaw/.secrets/todoist_token.json
Todoist API REST Skill Data Schema & Taxonomy
The skill interacts with Todoist data objects following the standard API schema. Key entities include:
| Entity | Key Attributes | Purpose |
|---|---|---|
| Task | id, content, due_string, project_id | Individual to-do items |
| Project | id, name, color, is_favorite | High-level containers for tasks |
| Section | id, project_id, name | Organizational splits within projects |
| Completed | items, results, completion_date | Historical task records for reporting |
Todoist API REST Skill Advanced Features
- Multi-version API support (REST v2 and API v1) for maximum uptime and compatibility.
- Advanced date-based filtering for fetching completed tasks across specific time ranges.
- Deep integration with project sections, allowing for granular task organization via CLI.
- Secure token management compatible with Openclaw Skills secret handling standards.
- Lightweight footprint with zero dependencies beyond standard Unix utilities.
SKILL.md
Loading
Related Openclaw Skills
Signal Generator Skill
An automated trading signal generator that analyzes technical indicators and broadcasts alerts to communication channels.
Sheet Cog
An advanced AI coding agent skill that generates complex, formula-heavy spreadsheets and financial models using Python-powered automation.
Nano Banana Cog
A sophisticated image generation skill that brings Google DeepMind's Nano Banana model to AI agents for photorealistic creation and character consistency.
Safe Email
A secure, extraction-only skill for processing forwarded emails through a dedicated IMAP inbox with zero automatic background activity.
Todolist-MD Clawdbot
An AI-powered agent skill that manages Markdown todo files using line-stable edits and specific bot markers for seamless task synchronization.
Todolist MD Clawdbot
A specialized AI skill for managing Markdown-based todo lists across local storage, Google Drive, and S3 while maintaining line stability and minimal token usage.
Featured*
