Agent skill · writing content · sundial-org
ticktick
Manage TickTick tasks and projects from the command line with OAuth2 auth, batch operations, and rate limit handling.
Why this skill is useful
Adds specific commands and batch operations for managing TickTick tasks that the AI wouldn't reliably generate on its own.
What it needs
Requires bun installed locally. Requires ticktick account access. About 4k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
TickTick CLI Skill Manage TickTick tasks and projects from the command line. Setup 1. Register a TickTick Developer App 1. Go to TickTick Developer Center 2. Create a new application 3. Set the redirect URI to http://localhost:8080 4. Note your Client ID and Client Secret 2. Authenticate Headless / Manual Authentication This prints an authorization URL. Open it in a browser, approve access, then copy the full redirect URL (it looks like http://localhost:8080/?code=XXXXX&state=STATE) and paste it back into the CLI. The CLI will open your browser to authorize access. After approving, tokens are stored in ~/.clawdbot/credentials/ticktick-cli/config.json. Commands List Tasks Create Task Update Task Complete Task Abandon Task (Won't Do) Batch Abandon (Multiple Tasks) Note: batch-abandon requires task IDs (24-character hex strings), not task names. Use tasks --json to get task IDs first. List Projects Create Project Update Project Options Reference Priority Levels none - No priority (default) low - Low priority medium - Medium priority high - High priority Due Date Formats today - Due today tomorrow - Due tomorrow in N days - Due in N days (e.g., "in 3 days") next monday - Next occurrence of weekday ISO date - YYYY-MM-DD or full ISO format Global Options --json - Output results in JSON format (useful for scripting) --help - Show help for any command Agent Usage Tips When using this skill as an AI agent: 1. Always use --json flag for machine-readable output 2. List projects first with lists --json to get valid project IDs 3. Use project IDs rather than names when possible for reliability 4. Check task status before completing to avoid errors Example agent workflow: Configuration Tokens are stored in ~/.clawdbot/credentials/ticktick-cli/config.json: Note: Credentials are stored in plaintext. The CLI attempts to set file permissions to 700/600; treat this file as sensitive. The CLI automatically refreshes tokens when they expire. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/ticktick