dida365 Agent Mcp

dida365-agent

让 AI Agent 管理你的 Dida365 / TickTick — 命令行 · Skill · MCP

English | 中文

通过自然语言让 AI Agent 管理 Dida365 / TickTick 中的任务、项目、标签和习惯。提供三种形式：轻量级命令行工具、可直接安装的 Agent Skill，以及标准的 MCP 服务。

无需安装 — 直接使用 uvx 运行。同时支持 Dida365（中国）和 TickTick（国际版），可通过一个环境变量切换。

---

功能

完整的任务管理	创建、更新、完成、删除和移动任务，并设置优先级、标签、日期、提醒、重复规则和清单项 — 还支持批量操作。
项目与查询	对项目执行增删改查（列表 / 看板 / 时间线视图），按项目、日期、优先级、标签和状态筛选，并查看已完成的任务。
V2 高级功能	服务端全文搜索、标签管理、习惯打卡、项目文件夹、父子任务、任务置顶 — 这些功能不受官方 Open API 支持。
三种使用形式	命令行工具（运行后退出，节省资源和上下文）、Agent Skill（一个命令即可安装，内置方法指南）、MCP 服务（长期运行，调用工具）。
双平台	通过 DIDA365_REGION 在 Dida365（中国）和 TickTick（国际版）之间切换。
便于 Agent 使用	默认将结构化 JSON 输出到 stdout，将错误输出到 stderr，并使用非零退出码 — 方便 Agent 解析和编排。

---

快速开始

选项 1：直接使用命令行工具

无需安装 — 使用 uvx 运行（需要 uv）。先按照配置指南准备凭据，并将其写入 .env：

# Browser OAuth (saves token, ~180 days)
uvx dida365-agent dida auth login

# List all projects
uvx dida365-agent dida project list

# Create a high-priority task due tomorrow
uvx dida365-agent dida task create --title "Review PR" --project <projectId> \
  --priority 5 --due-date "2026-05-30T18:00:00+0800"

# Full-text search (V2)
uvx dida365-agent dida search "meeting"

本地安装后（uv tool install dida365-agent），可使用更短的 dida 命令。

选项 2：作为 Agent Skill 使用

在任何兼容 Skill 的 AI 工具（Claude Code、Cursor 等）中安装 Skill，并通过自然语言使用：

# Install the Skill
npx skills add linhai0872/dida365-agent

然后只需在 AI 聊天中描述你的需求：

整理我今天尚未完成的任务，列出优先级高的任务，并将逾期任务移到“Later”项目

Skill 会识别意图、补全缺失信息，并自动组合 dida 命令 — 无需手动设置参数。

选项 3：作为 MCP 服务使用

提供 44 个工具，作为标准 MCP 服务供 Claude Code、Cursor、Windsurf 等使用。请参阅 MCP 服务集成。

---

文档

文档	内容
命令行参考	所有命令、参数和约定
配置	凭据、启用 V2、环境变量、令牌生命周期
MCP 服务	本地 / 源码 / Docker 部署，AI 工具配置

---

开发

uv sync                              # Install dependencies
uv run python -m pytest tests/       # Run tests
uv run ruff check src/ tests/        # Lint
uv run dida --help                   # Run the CLI locally

许可证

MIT

致谢

• Dida365 / TickTick Open API
• FastMCP · Typer · Model Context Protocol