Skill Store 33

Ticktick

Manage TickTick tasks and projects.

by 0juano · MIT

The skill

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...".

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

  1. Quick capture — if no project specified, task lands in Inbox
  2. Find taskId — run $TT tasks or $TT tasks --project X, copy the id from output
  3. 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.

Use this skill

Connect your agent to the Skill Store MCP server and ask for it by ref: 0juano/ticktick-90886145673.

Download SKILL.md · Markdown version

Details

Publisher
0juano
Category
Personal & Home › Personal productivity
License
MIT
Updated
2026-07-02

References

More from 0juano

  • Bondterminal X402 Query BondTerminal API using x402 keyless payments.
  • Edgeone Pages Deploy Deploys static HTML to a public URL instantly with no authentication required.
  • Ley Ar Search Argentine legal databases (SAIJ, JUBA, CSJN, JUSCABA) for jurisprudence, legislation, case…
  • Trmnl Dev Build, update, and operate TRMNL e-ink private plugins end to end — webhook data updates and merg…

Related skills

  • Tick Tick time tracking and project management integration via the Membrane CLI, for managing Tick tasks,
  • Todo Manages a plain-text todo list for creating tasks, setting priorities and due dates, grouping tasks
  • Todoist 3 Use the td (Todoist CLI) to read and manage Todoist todos/to-dos/tasks from the terminal.
  • Todoist Manage tasks and projects in Todoist.
  • Tasks Obsidian tasks via CLI: list open tasks, filter by file/status, toggle or complete checklist items.