← Back to Skills Marketplace
9549
Downloads
13
Stars
0
Active Installs
9
Versions
Install in OpenClaw
/install todoist-api
Description
Todoist API integration with managed OAuth. Manage tasks, projects, sections, labels, and comments. Use this skill when users want to create, update, complete, or organize tasks and projects in Todoist. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Before installing, understand that this gives an agent the ability to read and, with your confirmation, modify Todoist data through Maton. Prefer OAuth, review connection creation prompts carefully, specify the intended connection if you have multiple accounts, and approve write or delete operations only after checking the exact target and payload.
Capability Assessment
Credentials
Network access, Bash commands, and optional raw HTTPS calls are proportionate to a third-party Todoist API integration and include handling guidance for sensitive responses.
Install Mechanism
Installation uses global npm or Homebrew packages for the Maton CLI, which is expected for this integration and is plainly documented.
Instruction Scope
The skill uses a generic Maton API passthrough that can technically reach more Todoist endpoints than the examples, but it discloses that limit and instructs agents to default to reads and confirm every write.
Persistence & Privilege
OAuth tokens or API keys may be stored in the OS credential store by the Maton CLI, and the skill explicitly warns not to inspect, print, export, or persist credentials elsewhere.
Purpose & Capability
The stated purpose is managing Todoist tasks, projects, sections, labels, and comments; the documented API examples and mutation capabilities match that purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install todoist-api - After installation, invoke the skill by name or use
/todoist-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
Resolve remaining audit findings: state one consistent endpoint policy instead of conflicting scope claims, qualify the local-execution and high-impact wording, note that locale examples are illustrative, and correct app-specific auth, method and upload-path documentation
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.4
- Changed all API endpoints and examples from `gateway.maton.ai` and `ctrl.maton.ai` to `api.maton.ai` for consistency.
- Added a Security & Permissions section clarifying access and user approval requirements for write operations.
- Removed obsolete reference to deleted LICENSE.txt file.
- Minor clarifications and formatting improvements in API documentation examples.
v1.0.3
- Switched API endpoints from `/rest/v2` to `/api/v1` for all Todoist requests.
- Updated base URLs and code examples to reflect the new API version.
- Adjusted response examples and field names to match the v1 API structure.
- Clarified quick start instructions and connection header usage with new endpoint paths.
v1.0.2
- Added a new clawdbot metadata section, including an emoji and required environment variable (MATON_API_KEY).
- No changes to functionality or API; documentation updated with metadata only.
v1.0.1
- No file changes detected in this release.
- Internal version increment to 1.0.1; no new features or user-facing updates included.
v1.0.0
Initial release: Todoist API integration with managed OAuth
- Enables task, project, section, label, and comment management via the Todoist REST API v2.
- Supports authentication and connection management with Maton API key and OAuth.
- Provides endpoints for creating, updating, listing, and deleting projects and tasks.
- Includes Python code samples for common API operations.
- Allows management of multiple Todoist connections through the control panel.
- Comprehensive API reference and setup instructions included.
Metadata
Frequently Asked Questions
What is Todoist?
Todoist API integration with managed OAuth. Manage tasks, projects, sections, labels, and comments. Use this skill when users want to create, update, complete, or organize tasks and projects in Todoist. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 9549 downloads so far.
How do I install Todoist?
Run "/install todoist-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Todoist free?
Yes, Todoist is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Todoist support?
Todoist is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Todoist?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.2.
More Skills