Todo4Agent

为 Agent 设计的 MCP 任务清单：Agent 可以通过 MCP 直接管理你的任务，你也能在界面里手动维护。

功能

• 任务分组与任务管理：新建、编辑、完成、截止时间、排序
• 清单锁定：按清单（分组）锁定，锁定的清单 Agent 无法通过 MCP 编辑（界面编辑不受影响），适合只允许自己维护的清单
• 回收站：误删可恢复
• 多用户：每人的任务数据互相独立
• 导入 / 导出 JSON（含任务清单与提示词），方便备份与迁移
• 桌面应用（Windows / macOS / Linux）与浏览器 WebUI（默认 http://127.0.0.1:3000）
• WebUI 默认监听 0.0.0.0，局域网内其他设备可直接访问；可在「设置 → 服务」关闭对外访问（仅本机）或修改端口
• 新用户注册默认开启，可在「设置 → 用户」关闭
• MCP 服务：Agent 通过标准 MCP 协议直接操作任务清单
• 提示词：AGENTS.md 式的 Agent 协作规范，默认为空、由用户自行填写，界面可编辑/复制/清空，Agent 也可通过 MCP 读写（数据按用户隔离）

安装

在 GitHub Releases 下载对应平台的安装包即可。 服务端口与对外监听可在「设置 → 服务」中修改（默认 3000 / 监听 0.0.0.0）。

命令行

命令	说明
todo4agent	启动桌面应用（后台同时提供 WebUI 服务）
todo4agent serve	无界面运行 WebUI / HTTP API
todo4agent mcp	启动 MCP Server（stdio，供 Agent 客户端连接）
todo4agent help	查看完整帮助（含 MCP 客户端配置示例与初始账号说明）
todo4agent version	查看版本号
--port <端口>	指定 WebUI/API 监听端口（1024-65535），本次运行有效、优先于设置页保存的端口，如 todo4agent serve --port 8080；适用于桌面与 serve 模式

首次使用

系统自带初始账号：

• 用户名：admin
• 密码：admin123

登录后请尽快在「设置 → 用户」中修改密码；也可以直接注册自己的新账号（注册按钮默认开启）。

Agent 接入（MCP）

在支持 MCP 的 Agent 客户端中配置：

{
  "mcpServers": {
    "todo4agent": {
      "command": "todo4agent",
      "args": ["mcp"],
      "env": {
        "TODO4AGENT_USERNAME": "你的用户名",
        "TODO4AGENT_PASSWORD": "你的密码"
      }
    }
  }
}

Agent 即可对你自己的任务清单执行增删改查、重排、导入导出等操作。软件界面「Agent 接入」页可一键复制客户端配置。可用工具：

工具	说明
app_version / app_release	查询应用版本号 / 发布页地址
group_list / group_create / group_rename / group_delete	任务分组管理（删除分组其下任务一并进回收站）
task_list / task_create / task_update	任务查询与编辑（支持移动分组、改状态、截止时间）
task_complete / task_delete	完成切换 / 删除（软删除进回收站）
task_export / task_import	导出任务清单与提示词 JSON（与界面导出同构）/ 导入（同名分组并入，提示词随 prompt 字段迁移）
user_password	修改当前账号密码（原密码 + 新密码；改后该用户已登录会话失效，需同步更新客户端 env 中的 TODO4AGENT_PASSWORD）
prompt_get / prompt_update	读取 / 全量更新当前用户的 Agent 提示词（默认为空；prompt_update 传空字符串即清空）

凭据说明：MCP 启动时必须通过 TODO4AGENT_USERNAME / TODO4AGENT_PASSWORD 指定并验证账号 （首次运行数据库会自动创建初始账号 admin / admin123），验证失败将拒绝启动。

锁定说明：某个清单（分组）被锁定后（界面侧边栏分组 ⋮ 菜单或右键菜单切换），Agent 对该清单的 写操作（该组任务的增删改、把任务移入该组、改名/删除该组、导入文档含该组）会被拒绝并提示； 读取该清单、以及未锁定清单的一切操作不受影响。group_list 返回的 locked 字段可查看锁定状态。

数据

任务数据保存在本机 SQLite 数据库中，界面「设置 → 数据」可导出/导入 JSON，并可在系统文件管理器中定位数据库文件。

文档

• 开发者文档：DEVELOPMENT.md
• 更新日志：CHANGELOG.md
• 许可证：GNU AGPL-3.0