Demerzels-lab TickTick Integration
Manage tasks via TickTick's Open API.
Setup
First time only:
- Go to https://developer.ticktick.com and create an app
- Add redirect URI:
http://127.0.0.1:8765/callback - Run setup:
ticktick-setup <client_id> <client_secret>
- Open the auth URL in browser, authorize, paste the callback URL
Usage
# List projects
ticktick projects
# List all tasks
ticktick tasks
# List tasks from specific project
ticktick tasks <project_id>
# Add task (inbox)
ticktick add "Buy milk"
# Add task to project with due date
ticktick add "Buy milk" --project <id> --due 2026-01-30
# Complete task
ticktick complete <project_id> <task_id>
# Delete task
ticktick delete <project_id> <task_id>
API Reference
Base URL: https://api.ticktick.com/open/v1
| Endpoint | Method | Description |
|---|---|---|
| /project | GET | List all projects |
| /project/{id}/data | GET | Get project with tasks |
| /task | POST | Create task |
| /task/{id} | POST | Update task |
| /project/{pid}/task/{tid}/complete | POST | Complete task |
| /task/{pid}/{tid} | DELETE | Delete task |
Task Object
{
"title": "Task title",
"content": "Description",
"projectId": "project-id",
"dueDate": "2026-01-25T12:00:00+0000",
"priority": 0,
"tags": ["tag1"]
}
Priority: 0=none, 1=low, 3=medium, 5=high