How do I install the Ticktick skill?

Run npx skillmds@latest add 0juano/ticktick in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ticktick safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ticktick?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ticktick free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Ticktick?

0juano (@0juano) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ticktick by 0juano — Agent Skill

Name: Ticktick
Rating: 4.2 (5 reviews)
Author: 0juano

Ticktick

Manage TickTick tasks and projects. Use when the user asks to add, create, or capture a task or todo; list, show, or review pending tasks; complete or check off a task; update a task's priority, due date, notes, or tags; delete a task or list; create or manage a project/list; or see what's due today or overdue. Also handles quick captures like "remind me to..." or "don't let me forget...".

0juano Updated Sep 10, 2026

File contents

TickTick

Manage tasks and projects via {baseDir}/scripts/tt.sh. Full API reference in references/api.md.

Auth: TICKTICK_TOKEN env var — a TickTick personal access token (tp_*), used directly as a Bearer token; no OAuth flow needed. Load it from your secrets manager or shell profile.

Timezone: due dates get the local UTC offset appended automatically. Override with TICKTICK_UTC_OFFSET (e.g. -03:00) and optionally TICKTICK_TIMEZONE (IANA name, e.g. America/Buenos_Aires).

Inbox: the per-user inbox project id is auto-discovered from the API. Set TICKTICK_INBOX_ID to skip the extra lookup call.

Quick Reference

TT="bash {baseDir}/scripts/tt.sh"

Commands

List projects

$TT projects

List tasks

$TT tasks                          # inbox (default)
$TT tasks --project "Work"         # by name
$TT tasks --project <projectId>    # by ID

Add a task

$TT add "Buy tennis grip"
$TT add "Call accountant" --priority high --due "2026-02-20T10:00:00"
$TT add "Draft email" --project "Work" --priority med --notes "Reply to client"
$TT add "Review PR" --tag "work,code"

Priority values: none | low | med | high

Complete a task

$TT complete <taskId> --project <projectId>
# Inbox tasks: --project flag optional (defaults to inbox)

Update a task

$TT update <taskId> --project <projectId> --priority high
$TT update <taskId> --title "New title" --due "2026-02-25T09:00:00"

Delete a task

$TT delete <taskId> --project <projectId>

Manage projects

$TT add-project "Tennis"           # creates new list
$TT add-project "Work" --color "#FF5733"
$TT delete-project <projectId>

Workflow

Quick capture — if no project specified, task lands in Inbox
Find taskId — run $TT tasks or $TT tasks --project X, copy the id from output
Find projectId — run $TT projects, copy the id

Display Format

When showing tasks to the user, format like this:

📋 Inbox — 3 pending

  ○ [HIGH]  Call accountant            — due Feb 20
  ○ [MED]   Review analytics
  ○         Buy tennis racket grip

Sort by: priority (high first), then due date. Hide completed tasks unless asked.

---name: ticktickdescription: Manage TickTick tasks and projects. Use when the user asks to add, create, or capture a task or todo; list, show, or review pending tasks; complete or check off a task; update a task's priority, due date, notes, or tags; delete a task or list; create or manage a project/list; or see what's due today or overdue. Also handles quick captures like "remind me to..." or "don't let me forget...".license: MIT---# TickTickManage tasks and projects via `{baseDir}/scripts/tt.sh`. Full API reference in `references/api.md`.**Auth:** `TICKTICK_TOKEN` env var — a TickTick personal access token (`tp_*`),used directly as a Bearer token; no OAuth flow needed. Load it from yoursecrets manager or shell profile.**Timezone:** due dates get the local UTC offset appended automatically.Override with `TICKTICK_UTC_OFFSET` (e.g. `-03:00`) and optionally`TICKTICK_TIMEZONE` (IANA name, e.g. `America/Buenos_Aires`).**Inbox:** the per-user inbox project id is auto-discovered from the API.Set `TICKTICK_INBOX_ID` to skip the extra lookup call.## Quick Reference```bashTT="bash {baseDir}/scripts/tt.sh"```## Commands### List projects```bash$TT projects```### List tasks```bash$TT tasks # inbox (default)$TT tasks --project "Work" # by name$TT tasks --project <projectId> # by ID```### Add a task```bash$TT add "Buy tennis grip"$TT add "Call accountant" --priority high --due "2026-02-20T10:00:00"$TT add "Draft email" --project "Work" --priority med --notes "Reply to client"$TT add "Review PR" --tag "work,code"```Priority values: `none` | `low` | `med` | `high`### Complete a task```bash$TT complete <taskId> --project <projectId># Inbox tasks: --project flag optional (defaults to inbox)```### Update a task```bash$TT update <taskId> --project <projectId> --priority high$TT update <taskId> --title "New title" --due "2026-02-25T09:00:00"```### Delete a task```bash$TT delete <taskId> --project <projectId>```### Manage projects```bash$TT add-project "Tennis" # creates new list$TT add-project "Work" --color "#FF5733"$TT delete-project <projectId>```## Workflow1. **Quick capture** — if no project specified, task lands in Inbox2. **Find taskId** — run `$TT tasks` or `$TT tasks --project X`, copy the id from output3. **Find projectId** — run `$TT projects`, copy the id## Display FormatWhen showing tasks to the user, format like this:```📋 Inbox — 3 pending ○ [HIGH] Call accountant — due Feb 20 ○ [MED] Review analytics ○ Buy tennis racket grip```Sort by: priority (high first), then due date. Hide completed tasks unless asked.

Frequently asked questions