A robust command-line interface for managing TickTick tasks and projects with OAuth2 authentication and batch processing support.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ticktick
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 ticktick 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 TickTick CLI Skill?
The TickTick CLI Skill provides a seamless bridge between your terminal and one of the world's most popular task management platforms. As part of the ecosystem of Openclaw Skills, it enables developers and AI agents to programmatically handle task lifecycles, organize projects, and execute batch operations without leaving the command line.
This skill is designed for high-efficiency workflows, offering features like rate limit handling and automated token refreshing to ensure consistent performance. By leveraging this integration within the Openclaw Skills framework, users can build sophisticated automation scripts that interact directly with their personal or professional task lists.
TickTick CLI Skill Use Cases
- Automating daily task creation from build scripts or CI/CD pipelines.
- Integrating task management into AI agent workflows using Openclaw Skills.
- Managing project structures and bulk-archiving tasks using high-performance batch commands.
- Quick task entry and status updates directly from the terminal to avoid context switching.
- Synchronizing local development milestones with TickTick project boards.
How TickTick CLI Skill Works
- The user registers a developer application in the TickTick Developer Center to obtain secure API credentials.
- Authentication is handled via a secure OAuth2 flow, supporting both local browser redirects and manual headless modes for remote servers.
- The CLI interacts with the TickTick Open API v1 to fetch, create, or modify tasks and lists based on user input.
- Data is processed and can be output as human-readable text or machine-readable JSON for further integration with other Openclaw Skills.
- The system automatically manages API rate limits and token expiration to maintain a stable, persistent connection.
TickTick CLI Skill Setup
1. Register a TickTick Developer App
- Go to the TickTick Developer Center and create a new application.
- Set the redirect URI to
http://localhost:8080. - Note your Client ID and Client Secret.
2. Authenticate with Openclaw Skills
# Start the OAuth flow
bun run scripts/ticktick.ts auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET
# For headless environments, use manual mode
bun run scripts/ticktick.ts auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --manual
TickTick CLI Skill Data Schema & Taxonomy
The TickTick CLI Skill organizes data using a local configuration file and standardized JSON outputs for API interactions.
| Component | Location / Format | Purpose |
|---|---|---|
| Configuration | ~/.clawdbot/credentials/ticktick-cli/config.json |
Stores OAuth tokens and client credentials securely. |
| Task Schema | JSON Object | Includes fields for title, content, priority (none to high), and due dates. |
| Project Schema | JSON Object | Includes project names, IDs, and color hex codes. |
Priority Taxonomy
none: Default prioritylow: Low urgencymedium: Medium urgencyhigh: High urgency
TickTick CLI Skill Advanced Features
- Support for batch-abandoning multiple tasks in a single API call to optimize rate limits within the Openclaw Skills ecosystem.
- Comprehensive JSON output mode specifically designed for seamless integration with AI agents and automated scripts.
- Automated token refresh logic that prevents session interruptions during long-running automation tasks.
- Flexible due-date parsing supporting natural language inputs like 'today', 'tomorrow', or 'in 7 days'.
- Headless authentication support for running Openclaw Skills on remote servers or CI/CD environments.
SKILL.md
Loading
Related Openclaw Skills
Pocket Casts YouTube Uploader
Automatically sync YouTube content directly to your Pocket Casts cloud library for cross-platform offline access.
Linear
A comprehensive bash-based integration to manage Linear issues, project progress, and Git workflows within Openclaw Skills.
PharmGx Reporter
A bioinformatics tool that converts raw consumer genetic data into actionable pharmacogenomic reports using CPIC guidelines.
NutriGx Advisor
A local AI agent skill for generating science-backed personalised nutrition reports from consumer genetic data.
Redis LangCache Semantic Caching
A high-performance semantic caching skill that stores LLM responses to slash API costs and accelerate agent reaction times.
Kaspa Wallet CLI
A professional command-line interface for the Kaspa blockchain that enables secure wallet management, balance tracking, and KAS transactions.
Featured*
