TickTick Tasks

TickTick task manager integration. List projects and tasks, create new tasks, complete tasks, delete tasks. Use when the user wants to manage their to-do list, add reminders, check pending tasks, or mark tasks as done. Requires OAuth setup via `ticktick-setup`.

Security Scan

The skill claims to integrate with TickTick but its runtime instructions require a separate ticktick CLI and OAuth secrets while the declared metadata lists no binaries, no credentials, and no install — that mismatch is suspicious and warrants caution.

Purpose & Capability

The SKILL.md repeatedly instructs the agent/user to run a 'ticktick-setup' command and to use a 'ticktick' CLI (e.g., ticktick projects, ticktick add), and it requires creating a TickTick app (client_id/client_secret). However the skill metadata declares no required binaries, no primary credential, and no required env vars or config paths. That is an explicit inconsistency: a TickTick integration plausibly needs OAuth credentials and a client binary or library, but the skill does not declare or provide them.

Instruction Scope

The instructions themselves stay within TickTick API usage (creating tasks, listing projects, completing tasks) and the OAuth flow is standard (create app, redirect URI, authorize). The concerning part is that the instructions require interactive steps (running ticktick-setup, opening a browser, pasting a callback URL) and the skill gives no guidance about where 'ticktick-setup' comes from or how tokens are stored. There is no instruction to read unrelated files or exfiltrate data, but the lack of provenance for the external CLI raises risk.

Install Mechanism

This is an instruction-only skill with no install spec and no code files (lowest install risk). However, the runtime depends on an external CLI ('ticktick' and 'ticktick-setup') that is neither provided nor referenced by a trusted install source. The absence of an install mechanism for that CLI is a gap: the skill cannot function as described unless the user/agent obtains that binary from elsewhere, so you should verify its source before running.

Credentials

The SKILL.md requires creating a TickTick app and supplying client_id and client_secret to ticktick-setup, but the skill metadata declares no required credentials or primaryEnv. Sensitive credentials are therefore implicitly needed but not declared; that mismatch prevents automated vetting and is disproportionate to the declared requirements. You should confirm how/where OAuth tokens and client secrets will be stored and who (which process) will have access.

Persistence & Privilege

The skill does not request always:true and does not attempt to modify other skills or system-wide settings. It is user-invocable and allows autonomous invocation (platform default), which is expected for skills. There is no explicit persistence or elevated privilege requested in the metadata.

What to consider before installing

Before installing or using this skill: 1) Understand the mismatch — the skill's instructions require a 'ticktick' CLI and an OAuth client_id/client_secret, but the package metadata lists no binaries or credentials. 2) Do not run or install any third-party 'ticktick-setup' binary unless you can verify its source (official repo, GitHub release, or vendor). 3) Ask the skill publisher for the origin of the CLI and for an explicit install spec and token storage policy (where access tokens/client secrets are saved and who can read them). 4) If you must provide client_secret or paste a callback URL, ensure you trust the tool and inspect its code or release artifacts; avoid pasting secrets into untrusted prompts. 5) If you cannot verify the CLI, decline to install the skill — the skill as published is incomplete and cannot be safely vetted.

TickTick Integration

Manage tasks via TickTick's Open API.

Setup

First time only:

1. Go to https://developer.ticktick.com and create an app
2. Add redirect URI: http://127.0.0.1:8765/callback
3. Run setup:

ticktick-setup <client_id> <client_secret>

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