ticktick cli
TypeScript CLI和MCP服务器 TickTick开放API.从终端或通过AI代理管理任务、项目和笔记。
特性
- 全面覆盖TickTick Open API（14个MCP工具，20多个CLI命令）
- 人性化的输出（表格、颜色）和
--json代理模式 - 用于直接AI代理集成的MCP服务器
- OAuth 2.0身份验证，自动刷新令牌
- 项目名称解析（使用名称而不是ID）
- 任务筛选器：
--today,--overdue,--week,--tag,--priority - 标签、提醒、子任务、重复任务、开始/截止日期
设置
1.注册TickTick应用程序
首选 developer.ticktic.com >管理应用程序>注册。
将重定向URI设置为 http://localhost:8090/callback.
2.配置
创建 ~/.ticktick/config.json:
{
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"redirect_uri": "http://localhost:8090/callback"
}3.安装
git clone https://github.com/ashark-ai-05/ticktick-cli.git
cd ticktick-cli
npm install
npm run build
npm link4.登录
ticktick login命令行用法
# Dashboard
ticktick status # Overdue, today, upcoming, project summary
# Projects
ticktick projects list # List all projects
ticktick projects get --with-tasks # Project with all tasks
ticktick projects create "My Project" --color "#FF0000" --view kanban
# Tasks
ticktick tasks list # All tasks
ticktick tasks list --today # Due today
ticktick tasks list --overdue # Past due
ticktick tasks list --week # Due this week
ticktick tasks list --project Work # By project name (no ID needed)
ticktick tasks list --tag urgent # By tag
ticktick tasks list --priority 5 # By priority
ticktick tasks create "Buy milk" --project Groceries --due tomorrow --priority 1 --tags "home,errands"
ticktick tasks create "Standup" --due "2026-04-01T09:00:00+0000" --reminder "0m,5m" --repeat "RRULE:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"
ticktick tasks create "Deploy v2" --subtasks "run tests,update docs,merge PR"
ticktick tasks update --project Work --add-tag urgent
ticktick tasks update --project Work --remove-tag urgent
ticktick tasks update --project Work --due none # Clear due date
ticktick tasks complete
ticktick tasks delete
--force
# Notes (items in NOTE-kind projects)
ticktick notes list
ticktick notes create "Meeting notes" --project Coach --content "Key takeaways..."
# JSON output (for agents/scripts)
ticktick tasks list --json
ticktick status --jsonMCP服务器
连接到克劳德代码：
claude mcp add ticktick -- node /path/to/ticktick-cli/dist/mcp.js可用工具（14）
| 工具 | 说明 |
|---|---|
ticktick_status | 仪表板：逾期、今天、即将、项目计数 |
ticktick_resolve_project | 将项目名称解析为ID |
ticktick_list_projects | 列出所有项目 |
ticktick_get_project | 按ID获取项目 |
ticktick_get_project_data | 获取包含任务和列的项目 |
ticktick_create_project | 创建项目 |
ticktick_update_project | 更新项目 |
ticktick_delete_project | 删除项目 |
ticktick_list_tasks | 列出任务（可选项目筛选器） |
ticktick_get_task | 按项目+任务ID获取任务 |
ticktick_create_task | 创建带有标题、标签、提醒等的任务。 |
ticktick_update_task | 更新任务字段 |
ticktick_complete_task | 标记任务完成 |
ticktick_delete_task | 删除任务 |
建筑
src/
types.ts # All interfaces and error classes
config.ts # Paths, URLs, constants
auth.ts # OAuth flow, token storage, refresh
client.ts # TickTickClient (shared by CLI + MCP)
date-parser.ts # Human-friendly date parsing
formatters.ts # Pretty + JSON output
cli.ts # CLI entry point (Commander.js)
mcp.ts # MCP server entry point
commands/
login.ts # login/logout
projects.ts # project subcommands
tasks.ts # task subcommands
notes.ts # note subcommands许可证
麻省理工学院