Skip to main content
Glama
yeah529

Dida Todo Agent

by yeah529
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Dida Todo Agent

Dida365（滴答清单）MCP Server + Agent Skill，让 AI Agent 用自然语言管理你的待办事项。

核心是一个规则引擎：通过可配置的路由规则，自动将自然语言任务分配到正确的项目、设定优先级和标签，避免 AI 自由发挥导致分类混乱。

核心特性

🎯 规则引擎驱动的任务路由

不再依赖 AI 的"直觉"来分类任务。通过 Routing Profile 定义明确规则：

  • 项目路由：为每个 Dida365 项目定义用途、正例、反例和优先级，语义匹配 + 优先级裁决

  • 优先级策略：基于截止时间、阻塞性、关键交付等维度设定优先级（0/1/3/5），规则独立于项目名称

  • 标签管理：自动匹配已有标签；新标签与任务合并确认，并通过任务 tags 字段 inline 写入

  • 路由锁定：每次写操作必须携带当前 routing revision，配置过期时自动重新读取，防止错误分类

示例路由配置：

分类顺序：
1. 个人事务和生活提醒 → 个人提醒项目
2. 影响结果的工作、领导要求或关键交付 → 重要工作项目
3. 不重要且近期没有截止时间的工作 → 非紧急工作项目
4. 其余日常工作 → 一般工作项目

优先级规则（独立于项目）：
- 紧急、阻塞或 24 小时内的关键交付 = 5
- 近期普通交付 = 3
- 可延后的规划 = 1
- 日常生活提醒 = 0

🔒 安全写入流程

所有状态变更操作都经过两步确认：

  1. Prepare：服务端返回 5 分钟有效、绑定请求参数的一次性 confirmation token

  2. Confirm：用户明确确认后，Agent 才用该 token 提交操作

适用于：完成任务、删除任务、创建带新标签的任务、保存路由配置等。Dida365 Open API 的独立标签创建端点不可靠，因此新标签不单独调用 POST /tag。

🔐 凭证隔离

Client Secret 和 OAuth Token 只存 OS Keyring，不落盘、不进日志、不进聊天记录。

Related MCP server: Todoist MCP Server

架构

┌─────────────────────────────────────────────┐
│              Agent Framework                 │
│  (OpenClaw / Claude Desktop / Cursor / ...) │
├─────────────────────────────────────────────┤
│         Skill (dida-todo-agent)             │
│  自然语言理解 · 规则匹配 · 确认交互        │
├─────────────────────────────────────────────┤
│         MCP Server (dida365-mcp)            │
│  OAuth · 凭证 · 路由校验 · 任务 CRUD       │
│  确认令牌 · 操作日志 · 并发冲突检测         │
├─────────────────────────────────────────────┤
│              Dida365 Open API               │
│         api.dida365.com/open/v1             │
└─────────────────────────────────────────────┘

  • MCP Server：规则引擎的执行层。负责 OAuth、凭证存储、路由配置校验、任务读写、确认令牌、操作日志和并发冲突检测。通过标准 stdio MCP 协议与宿主 Agent 通信。

  • Agent Skill：规则引擎的决策层。负责自然语言理解、项目路由匹配、优先级判定、标签匹配和用户确认交互。适配任何支持 MCP 的 Agent 框架。

快速开始

1. 安装

cd dida-todo-agent
uv sync --frozen --extra dev

2. 配置 Dida365 应用凭证

.venv/bin/dida365-mcp-admin configure-app

按提示输入 Dida365 开放平台的 Client ID 和 Client Secret。凭证只保存在操作系统 Keyring 中，不要粘贴到聊天或提交到 README、Agent 配置文件。

3. OAuth 授权

启动 MCP 服务后调用 start_oauth，工具返回授权 URL。在浏览器中打开 URL 完成授权，然后调用 auth_status 验证授权确实成功。

4. 在宿主 Agent 中注册 MCP Server

标准 stdio 启动配置：

{
  "command": ".venv/bin/python",
  "args": ["-m", "dida365_mcp.server"],
  "cwd": "."
}

服务端预期暴露 16 个工具（MCP tools）。不同 Agent 框架只需映射 command、args 和 cwd；不要把本机绝对路径、令牌或密钥提交到配置文件。

5. 注册 Agent Skill

将 skill/ 目录复制到 Agent 框架的技能目录中。以 OpenClaw 为例：

cp -r skill/ ~/.openclaw/skills/dida-todo-agent/

6. 配置路由规则

参考 Routing Profile Guide 编写你的路由配置，通过 save_routing_profile 工具写入。路由配置定义了项目用途、优先级策略和标签规则。

项目结构

dida-todo-agent/
├── src/dida365_mcp/        # MCP Server
│   ├── server.py            #   MCP 工具入口 + _parse JSON 修复
│   ├── credentials.py       #   OS Keyring 凭证存储
│   ├── oauth.py             #   OAuth 2.0 回调流程
│   ├── dida_client.py       #   Dida365 API 客户端
│   ├── routing.py           #   路由配置校验
│   ├── confirmations.py     #   确认令牌管理
│   ├── ledger.py            #   操作日志
│   └── ...
├── skill/                   # Agent Skill
│   ├── SKILL.md             #   技能定义（路由决策、确认流程）
│   └── references/          #   适配器契约、行为用例、路由指南
├── tests/                   # 测试套件
└── scripts/                 # OAuth 授权辅助脚本

开发

uv run pytest -q             # 运行测试
uv run ruff check src tests  # 代码检查
uv run mypy src              # 类型检查

License

MIT

Install Server
A
license - permissive license
D
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yeah529/dida-todo-agent'

If you have feedback or need assistance with the MCP directory API, please join our Discord server