A comprehensive toolkit for AI agents to manage TickTick tasks and projects with automated OAuth2 token handling and typed API access.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ticktick-calendar
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-calendar 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 Integration?
The TickTick skill provides a robust bridge between AI agents and the TickTick platform, enabling full lifecycle management of tasks and projects. It simplifies complex OAuth2 flows with automated token refreshing and provides a standardized, typed API client designed for reliability. By incorporating this into Openclaw Skills, developers can empower their agents to organize workflows, set priorities, and track progress across the TickTick ecosystem without manual intervention.
This skill is built with strict contracts and error handling to ensure that your agent remains functional even when tokens expire or rate limits are reached. It is an essential component for any developer looking to build automated productivity assistants that leverage the power of Openclaw Skills for task management.
TickTick Integration Use Cases
- Automating task creation and updates based on AI-driven insights or code reviews.
- Synchronizing project milestones between development environments and TickTick projects.
- Building custom productivity bots that require authenticated, long-lived access to task lists.
- Managing team-wide task distributions through a centralized AI agent interface.
How TickTick Integration Works
- The skill initializes by parsing secure environment variables such as the Client ID and Secret.
- A secure OAuth2 handshake is performed to obtain an access token and a persistent refresh token.
- The runtime manages the token lifecycle, automatically refreshing expired credentials without interrupting the agent's workflow.
- Standardized actions like list_tasks or complete_task are executed via the Openclaw Skills entry point.
- API responses are mapped to a typed domain model, ensuring that the AI agent receives predictable and actionable data.
TickTick Integration Setup
To begin using this skill within the Openclaw Skills framework, follow these steps:
- Configure your environment variables in a .env file:
- TICKTICK_CLIENT_ID
- TICKTICK_CLIENT_SECRET
- TICKTICK_REDIRECT_URI
- Generate the OAuth authorization URL:
npm run ticktick:cli -- auth-url
- Exchange your callback URL for a local token file:
npm run ticktick:cli -- auth-exchange --callbackUrl "YOUR_CALLBACK_URL"
- Verify the connection by listing your projects:
npm run ticktick:cli -- list-projects
TickTick Integration Data Schema & Taxonomy
The skill organizes its data using a structured metadata taxonomy and local persistence for credentials. This is vital for maintaining state within Openclaw Skills.
| Data Component | Description |
|---|---|
| Token File | A JSON file (defaulting to ~/.config/ticktick/token.json) containing access and refresh tokens. |
| Task Object | Includes fields for id, title, content, priority, and projectId. |
| Project Object | Includes id, name, and metadata such as color or project type. |
| Error Mapping | Normalizes API errors into categories like auth_401, rate_limit_429, and network. |
TickTick Integration Advanced Features
- Runtime auto-refresh logic that prevents workflow interruption during token expiration.
- Exponential backoff and retry mechanisms for resilient handling of network or server failures.
- Webhook notification support to alert users when manual re-authorization is required.
- Support for multi-project filtering and paginated task retrieval for complex productivity workflows.
SKILL.md
Loading
Related Openclaw Skills
Daily Hot News Skill
A high-performance news aggregation skill that tracks real-time trending topics across 54 social, tech, and media platforms.
Snapbyte Digest API
A specialized skill for fetching and formatting user-scoped developer news digests from the Snapbyte API into high-signal markdown.
Lite SQLite
A high-performance, ultra-lightweight SQLite database management skill designed for efficient local data persistence in AI agents.
Input Classification System
A deterministic rule-based engine that classifies clarified user input into task categories while assessing complexity and risk for AI agents.
Komodo Skill
A comprehensive interface for managing Komodo Core resources, enabling automated deployments, monitoring, and infrastructure control.
OneMind Skill
A specialized skill for AI agents to participate in collective alignment and consensus-building through proposition submission and grid rating.
Featured*
