Dida365 AI Tools

Dida365 AI Tools

](https://www.npmjs.com/package/dida365-ai-tools)  ](https://nodejs.org/)

Dida365（滴答清单）v3.0.0 MCP Server + CLI 工具，使用私有 API + Cookie 认证：

• MCP Server - 接入 Claude Code / Cursor / Windsurf，用自然语言管理任务
• CLI - 命令行直接操作，可脚本化、可管道、可接入 OpenClaw

借鉴了 ticktick-py 的私有 API 实现。

Features

Architecture

src/
├── core/                          # 核心层（MCP 和 CLI 共享）
│   ├── api-client.ts              # 私有 API 端点
│   ├── token-store.ts             # Cookie Token 持久化
│   ├── types.ts                   # TypeScript 接口
│   └── services/
│       ├── completed.service.ts   # 已完成任务查询
│       ├── sync.service.ts        # 全量同步 + 用户设置
│       ├── tag.service.ts         # 标签 CRUD / 重命名 / 合并
│       └── batch.service.ts       # 批量任务/项目/文件夹操作
│
├── mcp/                           # MCP Server 入口（28 个工具）
│   ├── index.ts
│   └── tools/
│       ├── auth.tool.ts           # 认证（1 个工具）
│       ├── projects.tool.ts       # 项目（2 个工具）
│       ├── tasks.tool.ts          # 任务（5 个工具）
│       ├── completed.tool.ts      # 已完成任务（4 个工具）
│       ├── sync.tool.ts           # 同步（3 个工具）
│       ├── tag.tool.ts            # 标签（6 个工具）
│       └── batch.tool.ts          # 批量操作（7 个工具）
│
└── cli/                           # CLI 入口（7 个命令组，30+ 子命令）
    ├── index.ts
    ├── commands/
    │   ├── auth.cmd.ts            # auth cookie / status
    │   ├── project.cmd.ts         # project list / show
    │   ├── task.cmd.ts            # task create / show / update / complete / delete
    │   ├── completed.cmd.ts       # completed today / yesterday / week / date / range
    │   ├── sync.cmd.ts            # sync all / settings / timezone
    │   ├── tag.cmd.ts             # tag list / create / rename / color / nest / merge / delete
    │   └── batch.cmd.ts           # batch move-task / set-subtask / delete-tasks / create-project / ...
    └── utils/
        └── output.ts              # 格式化输出

Installation

Quick Start (npx)

# MCP Server - 零安装直接启动
npx dida365-ai-tools

# CLI - 零安装直接使用
npx -p dida365-ai-tools dida365 --help

Global Install

npm install -g dida365-ai-tools

# Now available as:
dida365-mcp    # MCP Server
dida365        # CLI

From Source

git clone https://github.com/YOUR_GITHUB_USERNAME/dida365-ai-tools.git
cd dida365-ai-tools
npm install
npm run build

Authentication

本项目使用 Dida365 私有 API，通过 Cookie 认证。获取步骤：

1. 打开 dida365.com 并登录
2. 按 F12 打开开发者工具
3. 切换到 Application (应用) 标签页
4. 左侧找到 Cookies → https://dida365.com
5. 复制名为 t 的 Cookie 值

然后通过 CLI 设置认证：

dida365 auth cookie 
dida365 auth status    # 验证认证状态

或在 MCP 中使用 dida365_auth 工具设置 Cookie。

Usage

MCP Server

Claude Code

# 方式一：npx（推荐）
claude mcp add dida365 -- npx dida365-ai-tools

# 方式二：全局安装后
claude mcp add dida365 -- dida365-mcp

Cursor / Windsurf

在 MCP 配置文件中添加：

{
  "mcpServers": {
    "dida365": {
      "command": "npx",
      "args": ["-y", "dida365-ai-tools"]
    }
  }
}

Smithery

Visit smithery.ai and search for dida365-ai-tools.

CLI

认证

dida365 auth cookie      # 设置 Cookie 认证
dida365 auth status             # 检查认证状态

项目

dida365 project list            # 列出所有项目
dida365 project list --json     # JSON 输出
dida365 project show        # 项目详情和任务

任务

dida365 task create "买菜" -p 

dida365 task create "开会" -p 
 -c "讨论内容" --priority 5
dida365 task show 
dida365 task update  -p 
 -t "新标题" --priority 3
dida365 task complete 
 
dida365 task delete 
 

已完成任务查询

dida365 completed today                          # 今天
dida365 completed yesterday                      # 昨天
dida365 completed week                           # 本周
dida365 completed date 2024-01-15                # 指定日期
dida365 completed range 2024-01-01 2024-01-31    # 日期范围
dida365 completed today --timezone "Asia/Shanghai"
dida365 completed today --json                   # JSON 输出

全量同步

dida365 sync all                # 同步所有项目/任务/标签
dida365 sync all --json         # JSON 输出
dida365 sync settings           # 查看用户设置
dida365 sync timezone           # 查看时区

标签管理

dida365 tag list                        # 列出所有标签
dida365 tag create "工作" --color "#ff0000"
dida365 tag rename "旧名" "新名"
dida365 tag color "工作" "#0000ff"       # 修改颜色
dida365 tag nest "子标签" "父标签"       # 设置层级
dida365 tag merge "标签A" "标签B"        # 合并（A -> B）
dida365 tag delete "标签A" "标签B"       # 删除（支持多个）

批量操作

# 任务操作
dida365 batch move-task   
dida365 batch set-subtask  
 

dida365 batch delete-tasks taskId1:projectId1 taskId2:projectId2

# 项目操作
dida365 batch create-project "新项目" --color "#ff0000" --group 
dida365 batch delete-projects 
 

# 文件夹操作
dida365 batch create-folder "工作"
dida365 batch delete-folders  

Development

npm run dev          # watch 模式，自动重编译
npm run build        # 构建
npm run mcp          # 启动 MCP Server
npm run cli --  # 运行 CLI

Publishing / Distribution

本项目支持以下发布渠道：

Why Private API?

Dida365 提供了 Open API，但其功能是私有 API 的子集，且需要注册开发者应用。本项目选择使用私有 API + Cookie 认证，覆盖更全面、配置更简单。

Credits

• 私有 API 实现借鉴自 ticktick-py
• MCP SDK: Model Context Protocol
• CLI: Commander.js

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT