← Back to Skills Marketplace
2443
Downloads
3
Stars
3
Active Installs
9
Versions
Install in OpenClaw
/install todoist-natural-language
Description
Integrate with Todoist task management using natural language. Use when the user wants to manage Todoist tasks or projects through conversational commands li...
Usage Guidance
This skill appears to do exactly what it claims: it will send requests to api.todoist.com and the Todoist Sync endpoint using the TODOIST_API_KEY you provide. Before installing, ensure you are comfortable granting the Todoist API token (it can create, update, complete, and delete tasks). Review the included scripts yourself if you want to confirm behavior, avoid running installs as root, and keep your API token scoped/rotated according to your Todoist account security practices.
Capability Analysis
Type: OpenClaw Skill
Name: todoist-natural-language
Version: 1.0.8
The OpenClaw Todoist skill bundle is benign. The `scripts/todoist.py` script correctly uses the `TODOIST_API_KEY` environment variable for authentication and communicates exclusively with official Todoist API endpoints (`api.todoist.com`). User inputs are handled as data payloads or URL parameters, preventing shell injection or other command execution vulnerabilities. Neither `SKILL.md` nor `README.md` contain any prompt injection attempts or instructions for the AI agent to perform actions outside the stated purpose of Todoist task management. The installation instructions, while mentioning `sudo` for system-wide installation in `README.md`, are standard for such deployments and do not indicate malicious intent.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, README, skill.json, and the included Python client all align: this is a Todoist client that needs a Todoist API token. The code talks directly to api.todoist.com and the Sync API when needed, which is appropriate for the claimed features.
Instruction Scope
Runtime instructions and CLI usage only reference the Todoist API, the TODOIST_API_KEY env var, and optional TZ. The SKILL.md does not instruct reading unrelated files, other credentials, or exfiltrating data to third-party endpoints; behavior stays within the described scope.
Install Mechanism
No install spec is provided (instruction-only), and included files are Python and docs. There are no downloads from arbitrary URLs or archive extraction steps. README suggests manual copy/CLI usage which is low-risk.
Credentials
The only required secret is TODOIST_API_KEY (declared in SKILL.md and skill.json) and optional TZ for timezone handling. These are proportional to a Todoist integration; no unrelated secrets or config paths are requested.
Persistence & Privilege
The skill does not request always:true and contains no install hooks that modify other skills or global configs. It runs as an on-demand skill or CLI script and does not demand elevated persistent privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install todoist-natural-language - After installation, invoke the skill by name or use
/todoist-natural-language - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.8
- Major documentation overhaul: SKILL.md updated for clarity, concise usage, and improved natural language guidance.
- Added detailed credential metadata for `TODOIST_API_KEY`.
- Expanded and reorganized natural language command examples.
- Clarified technical usage and filter syntax.
- Added three new files: README.md, references/api.md, and scripts/todoist.py.
- Removed legacy api.md (superseded by references/api.md).
v1.0.7
- Major documentation refresh: SKILL.md now provides clearer step-by-step setup, usage, CLI and natural language examples, troubleshooting, and environment variable guidance.
- Added new files: api.md (Todoist API reference), skill.json.
- Removed redundant or outdated files: README.md, references/api.md, scripts/todoist.py.
- Instructions tailored for both OpenClaw integration and standalone CLI usage.
- Enhanced troubleshooting and environment variable setup documentation.
v1.0.6
Version 1.0.6 of todoist-natural-language
- No file changes detected in this release.
- Functionality and documentation remain unchanged.
v1.0.5
- Added a new credentials block specifying TODOIST_API_KEY as a required, sensitive credential.
- Removed mention of TODOIST_API_KEY from the general description and placed details in the credentials section for clarity.
v1.0.4
- Duration added to scheduled tasks.
- Project name now usable
v1.0.3
Summary: This update enables managing Todoist tasks and projects using natural language commands.
- Natural language commands like "add 'buy milk'" or "show tasks for today" are now supported
- Skill description and documentation revised to focus on conversational task management
- Technical CLI usage and advanced filter syntax remain available for scripting
- New features highlighted, including timezone-aware filtering and smart exclusion of completed tasks
- Clarified prerequisites and improved examples for easier onboarding
v1.0.2
New skill.md
v1.0.1
Updating display name.
v1.0.0
Initial release of the Todoist skill for task and project management:
- Integrates with the Todoist API v1 using a Todoist API key.
- Supports listing, adding, updating, completing, and deleting tasks.
- Allows filtering tasks by date, priority, project, and labels with Todoist’s filter syntax.
- Includes project listing functionality.
- All commands output structured JSON for easy integration and error handling.
Metadata
Frequently Asked Questions
What is Todoist Natural Language?
Integrate with Todoist task management using natural language. Use when the user wants to manage Todoist tasks or projects through conversational commands li... It is an AI Agent Skill for Claude Code / OpenClaw, with 2443 downloads so far.
How do I install Todoist Natural Language?
Run "/install todoist-natural-language" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Todoist Natural Language free?
Yes, Todoist Natural Language is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Todoist Natural Language support?
Todoist Natural Language is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Todoist Natural Language?
It is built and maintained by Art Mills (@hail2skins); the current version is v1.0.8.
More Skills