Todoist Orbit for Openclaw

A deterministic Python CLI for advanced Todoist automation without the ambiguity of natural language parsing.

myx0m0p
v0.1.6
Mar 10, 2026
0
988
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install todoist-orbit

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install todoist-orbit 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 Orbit?

Todoist Orbit is a specialized integration designed for Openclaw Skills that allows developers and AI agents to interact with the Todoist REST API through a robust Python-based interface. By focusing on deterministic execution, it bypasses the inaccuracies of natural language agents, providing a reliable way to list, create, update, and manage task lifecycles. This skill is built using only the Python standard library HTTP primitives, making it a lightweight and efficient tool for high-speed productivity management.

Built for users who require precision, Todoist Orbit supports complex operations such as concurrent resolution of projects and sections, file attachments via comments, and structured label management. Whether you are automating a personal workflow or integrating task management into a larger DevOps pipeline, this tool provides the stability needed for professional environments using Openclaw Skills.

Todoist Orbit Use Cases

  • Automating task creation from CI/CD pipeline triggers or shell scripts.
  • Synchronizing project structures and sections across different workspaces.
  • Attaching technical logs, daily transcripts, or documentation to specific Todoist tasks via CLI.
  • Performing high-volume task updates and lookups without manual UI interaction.
  • Managing labels and project archives programmatically for cleaner workflows.

How Todoist Orbit Works

  1. Authentication: The skill uses a TODOIST_API_KEY environment variable to securely communicate with the Todoist REST API.
  2. Command Input: Users or AI agents invoke the todoist_orbit.py script with specific action groups like tasks, projects, or labels.
  3. Request Processing: The script utilizes asynchronous Python logic to send HTTP requests directly to Todoist endpoints.
  4. Data Handling: For complex data, the skill can ingest text from files or standard input (stdin) to populate task comments while preserving formatting.
  5. Output: The CLI returns pretty-printed JSON or status updates, ensuring the workflow within Openclaw Skills remains transparent and easy to debug.

Todoist Orbit Setup

To get started with this skill within the Openclaw Skills framework, follow these steps:

Set your API key in the environment:

export TODOIST_API_KEY="your_todoist_token"

Identify the installation path and verify the script location:

SKILL_DIR="$HOME/.openclaw/skills/todoist-orbit"
python3 "$SKILL_DIR/scripts/todoist_orbit.py" --pretty tasks list

Todoist Orbit Data Schema & Taxonomy

Component Fields Managed Description
Tasks content, description, due, priority, project_id Core task data; supports ID-based precision.
Projects name, view-style, favorite Organizes tasks into lists or boards.
Labels name, color, favorite Metadata for categorizing tasks across projects.
Comments task_id, attachment, text Stores multi-line notes and file uploads.
Sections project_id, name Manages task groupings within specific projects.

Todoist Orbit Advanced Features

  • Concurrent Resolution: Execute project, section, and task lookups in a single logical call for faster data retrieval.
  • Direct File Uploads: Use the uploads group to send files to Todoist and attach them to comments automatically.
  • Stdlib HTTP Primitives: Operates with zero external dependencies beyond Python 3, ensuring maximum portability for Openclaw Skills.
  • Stdin Support: Pipe logs or generated reports directly into task comments using the add-stdin command.
  • Exact Search: Narrow down API search results to specific name matches for safer automation.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*