Petodo

本地服务

petodoapp.com生产力02 天前更新

代码仓库访问官网

关于 Petodo

Petodo 提供任务清单服务、CLI 和 MCP 服务，面向使用 AI 助手的人群。AI 助手可操作与桌面宠物应用相同的账户清单，包括周期任务和报告。

主要功能

01列出并筛选任务
02添加、编辑和删除任务
03完成任务或撤销完成
04识别截止时间和重复安排
05报告逾期任务及连续记录

适用场景

01通过 AI 助手管理任务
02从标题中的时间安排任务
03设置每日或每周重复任务
04查看逾期和即将到期任务

MCP 相关

`petodo mcp` 命令通过 stdin 和 stdout 运行 MCP 服务。连接的助手可在用户账户中列出、添加、完成、编辑、删除和汇总任务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "gaby3637-petodo": {
      "command": "npx",
      "args": [
        "-y",
        "petodo-cli"
      ]
    }
  }
}

启动命令npx -y petodo-cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmpetodo-cli1.1.1stdio

工具

收录的工具列表 · 更新于 1 天前

参数	类型	必填	说明
day	enum	否	默认为 all。today \| tomorrow \| all
status	enum	否	默认值为 open。open \| done \| all

详细介绍

petodo-cli

在终端中管理你的 Petodo 待办清单：它也是一个 MCP 服务，因此 Claude Code、Claude Desktop 和 Cursor 可以直接使用同一份清单。

Petodo 本身是一只承载待办清单的桌面宠物。这里使用的也是同一份清单，只是通过网络访问，因此无论你正在使用的设备上是否运行着该应用，都可以使用。

npx petodo-cli login
npx petodo-cli add "call Sam 2pm"

如果你不止使用一次，请正确安装：

npm install -g petodo-cli
petodo list

需要 Node 18 或更高版本。无依赖项。

日常使用

petodo list [--all|--done] [--today|--tomorrow]
petodo add "call Sam 2pm"        times in the text are understood
petodo done <id>                 an id prefix, or part of the title, is enough
petodo undo <id>
petodo rm <id>
petodo edit <id> [--title "..."] [--due "3pm"] [--clear-due] [--today|--tomorrow]
petodo report                    what is overdue, due soon, and your streak
petodo whoami

ID 是 UUID，petodo list 会显示前 8 个字符，这就是你需要输入的全部内容。如果仍有歧义，命令会明确提示，而不会猜测：

$ petodo done bbbb
"bbbb" matches 2 tasks. Use more of the id.

表示时间的词语会根据你本地的时钟从标题中解析出来： petodo add "call Sam 2pm" 会将任务安排在今天下午 2 点，并启用提醒。只有在你想覆盖该时间时，才传入 --due。

表示“重复”的词语也一样：

$ petodo add "gym every weekday at 6pm"
repeating  4f2a91cc  gym
           Every weekday at 6:00 PM
           first one 6:00 PM

重复任务每天显示一次。petodo list 会用 ↻ 标记今天的任务，并在下方列出重复规则。对某项任务运行 petodo done 会完成当天的任务；对规则运行 petodo rm 会停止重复，并移除之后的任务。

与助手配合使用

petodo mcp 会通过标准输入和标准输出运行一个 MCP 服务。通常无需自行运行；只需注册一次：

petodo connect claude-code       # or claude-desktop, or cursor
petodo connect --print           # the config, to paste yourself

之后，助手便可以列出、添加、完成、编辑、删除和汇总你的任务。它执行的所有操作都在你的账户下进行，并会立即显示在应用中。

如果助手需要 HTTP 而不是 MCP，请为它单独创建密钥：

petodo keys create "Claude"
petodo keys list
petodo keys revoke <id>

密钥只能访问清单，不能访问其他内容。它无法读取你的电子邮件地址、创建其他密钥或移除设备。撤销密钥后，只有该助手会失去访问权限。

环境变量

变量	作用
`PETODO_TOKEN`	仅对当前命令使用此令牌，而不是已登录的令牌。
`PETODO_ENDPOINT`	指定其他 API 地址。默认为 `https://app.petodoapp.com/api`。
`PETODO_HOME`	配置文件所在位置。默认为 `~/.petodo`。

环境变量始终优先于已保存的配置，因此一次性覆盖只会生效一次。