A powerful 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-cli
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-cli 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?
The TickTick CLI is a robust integration for Openclaw Skills that brings the full power of TickTick task management directly to your terminal. It allows developers and AI agents to programmatically create, update, and organize tasks and projects using a streamlined command-line interface. By leveraging the TickTick Open API v1, this skill provides high-level commands for everything from simple task creation to complex batch operations.
Designed for speed and automation, the skill supports various authentication modes, including a headless manual flow for servers. Whether you are building an automated personal assistant or just want to stay in flow while coding, this tool bridges the gap between your development environment and your task manager.
TickTick CLI Use Cases
- Automating task creation from shell scripts or CI/CD pipelines.
- Managing daily to-do lists without leaving the terminal or IDE.
- Performing bulk operations like abandoning multiple outdated tasks in a single call.
- Integrating TickTick task tracking into autonomous AI agent workflows.
- Filtering and exporting task data in JSON format for custom data analytics or reporting.
How TickTick CLI Works
- The user authenticates the CLI via OAuth2, which secures an access token stored locally in the user's home directory.
- Commands are issued through the script using the Bun runtime, passing arguments for tasks, lists, or authentication.
- The CLI interacts with the TickTick Open API v1 to fetch, create, or modify user data.
- For complex operations, the CLI resolves human-readable project names into unique IDs before executing task-specific actions.
- Results are returned as human-readable text or structured JSON, allowing for further piping into other tools.
TickTick CLI Setup
1. Register Application
Register a developer app at the TickTick Developer Center and set the redirect URI to http://localhost:8080 to obtain your credentials.
2. Authenticate
Run the following command to start the OAuth flow:
bun run scripts/ticktick.ts auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET
For headless environments, append the --manual flag to copy-paste the authorization code.
3. Verify Connection
Check your authentication status to ensure the Openclaw Skills integration is active:
bun run scripts/ticktick.ts auth --status
TickTick CLI Data Schema & Taxonomy
The skill stores configuration and sensitive credentials in ~/.clawdbot/credentials/ticktick-cli/config.json. Data returned via the --json flag follows the TickTick API v1 schema.
| Field | Description |
|---|---|
clientId |
Your TickTick OAuth2 Client ID |
accessToken |
Bearer token used for authenticated requests |
priority |
Priority levels: none, low, medium, or high |
status |
Task lifecycle state: pending or completed |
dueDate |
ISO 8601 formatted date or relative strings like "today" |
TickTick CLI Advanced Features
- Full JSON output support for every command to facilitate seamless AI agent integration.
- Batch operation support via the batch-abandon command to minimize API round-trips and handle rate limits efficiently.
- Support for natural language due date processing (e.g., "next monday", "in 7 days").
- Automatic token refresh logic to ensure long-term persistent authentication without user intervention.
- Multi-tag support and priority filtering for granular task management within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Better Polymarket
A high-performance interface for querying real-time prediction market data from Polymarket using the Gamma API.
Better Polymarket
Better Polymarket is a powerful integration for querying prediction market data, tracking odds, and analyzing trending events on the Polymarket platform.
Greet Skill
A context-aware interaction skill that provides personalized, time-of-day greetings for AI agents.
Noopolis
A digital citizenship skill that allows AI agents to participate in governance, elections, and constitutional processes within the Noopolis ecosystem.
Basic Helper Agent
A versatile personal productivity assistant designed to decompose complex tasks into actionable steps and synthesize multi-source information.
OpenClaw Team Collaboration Server
A secure, multi-user web interface for OpenClaw featuring zero-knowledge encryption and local network accessibility.
Featured*
