mcpField
T
ticktick

ticktick

github.com/0juano生产力043 次安装17 周前更新
代码仓库

关于 ticktick

通过 shell 脚本管理 TickTick 任务和项目的命令行技能，使用 TickTick 个人访问令牌进行任务整理、排期和完成操作。

主要功能

  1. 01列出项目和任务
  2. 02创建和编辑任务
  3. 03设置优先级、截止时间、备注和标签
  4. 04完成或删除任务
  5. 05创建和删除项目
  6. 06为截止时间应用本地时区偏移

适用场景

  1. 01将任务快速记入收件箱
  2. 02按项目和优先级整理任务
  3. 03更新任务的时间或详细信息
  4. 04创建或删除项目列表

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/0juano/agent-skills --skill ticktick

安装后在 Claude Code 中输入/ticktick确认已加载。

附带文件references/api.mdscripts/tt.sh

详细介绍

TickTick

通过 {baseDir}/scripts/tt.sh 管理任务和项目。完整 API 参考见 references/api.md。

身份验证： TICKTICK_TOKEN 环境变量——TickTick 个人访问令牌（tp_*）， 直接用作 Bearer 令牌；无需 OAuth 流程。从密钥管理器或 shell 配置文件中加载。

时区： 到期日期会自动附加本地 UTC 偏移量。 可通过 TICKTICK_UTC_OFFSET 覆盖（例如 -03:00），并可选设置 TICKTICK_TIMEZONE（IANA 名称，例如 America/Buenos_Aires）。

收件箱： API 会自动发现每位用户的收件箱项目 ID。 设置 TICKTICK_INBOX_ID 可跳过额外的查询调用。

快速参考

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

命令

列出项目
$TT projects
列出任务
$TT tasks                          # inbox (default)
$TT tasks --project "Work"         # by name
$TT tasks --project <projectId>    # by ID
添加任务
$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"

优先级取值：none | low | med | high

完成任务
$TT complete <taskId> --project <projectId>
# Inbox tasks: --project flag optional (defaults to inbox)
更新任务
$TT update <taskId> --project <projectId> --priority high
$TT update <taskId> --title "New title" --due "2026-02-25T09:00:00"
删除任务
$TT delete <taskId> --project <projectId>
管理项目
$TT add-project "Tennis"           # creates new list
$TT add-project "Work" --color "#FF5733"
$TT delete-project <projectId>

工作流

  1. 快速记录——如果未指定项目，任务会添加到收件箱
  2. 查找任务 ID——运行 $TT tasks 或 $TT tasks --project X，从输出中复制 ID
  3. 查找项目 ID——运行 $TT projects，复制 ID

显示格式

向用户显示任务时，使用以下格式：

📋 Inbox — 3 pending

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

排序方式：先按优先级（高优先级在前），再按到期日期。除非用户要求，否则隐藏已完成的任务。

评论

支持 Markdown