7.9
/ 10
1 evaluations
4.6k Downloads
Overview
Command-line interface for managing TickTick tasks and projects via TickTick’s Open API v1, with OAuth2 authentication, JSON output, and support for batch operations and rate limit-aware usage.
Key Advantages
1.Full CRUD-style management of tasks and projects (create, list, update, complete/abandon, batch abandon).
2.OAuth2-based authentication with automatic token refresh after initial manual setup.
3.Machine-readable output via --json, making it well-suited for automation and AI agent workflows.
4.Support for TickTick’s batch task endpoint to reduce API calls and help stay within rate limits during bulk operations.
5.Flexible due date parsing (natural language like “tomorrow”, “in 3 days”, weekdays, ISO dates).
Use Cases
- Automating personal or team task management workflows in TickTick from scripts or agents.
- Building AI agents that create, update, and complete TickTick tasks reliably using JSON output and IDs.
- Bulk maintenance operations, such as abandoning multiple obsolete tasks using the batch endpoint.
- Integrating TickTick with other CLI-based tools or CI jobs (e.g., auto-creating tasks for failed builds or PR reviews).
- Headless server environments where TickTick tasks must be managed without a GUI, using manual OAuth URL flow once and then stored tokens.
Evaluation Scores
7.9
/ 10
Reliability
7.7
Functionality
8.8
Usability
7.8
Safety
7.0
Performance
8.0
Compatibility
8.2
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
7.9/103/19/2026▼
OS: linux-x64LLM: google/gemini-2.5-flash-lite
**Judgement:** Solid and feature-complete TickTick CLI well-suited for automation and AI agents once OAuth is configured, with good JSON support and batch operations. Best for users who already rely on TickTick and want programmable task/project management.
**Strengths:**
- Covers core task and project operations (create/list/update/complete/abandon) plus batch abandon via TickTick’s batch API.
- Designed for agent use: consistent CLI interface, `--json` output, and recommendations to use project IDs and task IDs.
- Handles OAuth2 with token refresh and basic rate-limit awareness; supports headless/manual auth flow.
**Key Risks / Limitations:**
- Initial OAuth app registration and authentication require manual steps and user involvement; not plug-and-play for new users.
- Credentials and tokens are stored in plaintext on disk (even if with restrictive permissions), which is a local security risk if the host is compromised.
- TickTick API rate limits (100 req/min, 300/5min) plus multi-call operations mean aggressive bulk operations can still hit limits.
- Some advanced TickTick features (e.g., focus time, habits) are not supported by the underlying API and thus unavailable.
**Recommended Scenarios:**
- Power users and developers who already use TickTick and want to integrate it into automation, scripts, or AI workflows.
- Agents that need to reliably manage tasks/projects with structured JSON I/O, particularly when using IDs to avoid ambiguity.
- Systems that periodically sync or clean up TickTick data (e.g., batch abandoning old tasks) while staying within API limits.
**Less Ideal For:**
- Users unwilling or unable to perform the TickTick Developer app setup and OAuth flow.
- Highly security-sensitive environments where storing OAuth credentials in plaintext on disk is not acceptable.
Comments (0)
No comments yet. Be the first!