Notes

Notes — 由你的 AI 撰写的笔记本

为 Notes 打造的每日项目符号笔记本——可作为 Claude Code 插件、供其他所有客户端使用的独立 Agent Skill，以及供任何能读取 MCP URL 的工具使用的纯 MCP URL。

你的 AI 会主动在你的笔记本中记笔记：写在当天的页面上，标记并归入与你写下的所有内容相同的实体图谱中，并注明每条项目符号是谁写的，让你一眼就能分辨。几周后，你打开某个项目的页面，就能按日期顺序在同一页上看到你的笔记和它的笔记。下一次会话还会读回这些内容，因此你不必重新解释。

它不是一个记忆数据库。没有向量索引，没有淘汰策略，没有钩子，也不需要自带 Postgres。记忆就是你本来就在读的笔记本中的一条项目符号，你可以手动更正，并能链接回产生它的对话。

安装

Claude Code

/plugin marketplace add jpwilliams/notes-skill
/plugin install notes@notes-skill

Cursor、VS Code、Codex、Gemini CLI、Antigravity、Amp、OpenCode、Warp……

这里的 Skill 和连接是分开的，因为这些客户端都支持开放的 Agent Skills 格式，并且各自使用 MCP 服务 URL。

gh skill install jpwilliams/notes-skill

这会安装到 .agents/skills/，这是它们共同使用的厂商中立路径——因此无论你使用哪个客户端，都只需一条命令。（如果你更愿意使用 GitHub CLI，也可以运行 npx skills add jpwilliams/notes-skill，效果相同。）然后添加 MCP 服务：

https://notes.jpwilliams.dev/api/v1/mcp

其他任何客户端

任何支持远程 MCP 的客户端都可以直接使用该 URL，无需安装软件包，也无需安装任何内容——它会自行发现其余配置。notes.jpwilliams.dev/install 提供了各客户端的具体说明。

无论你采用哪种方式，接下来都会发生什么

浏览器会打开。登录你已有的账号，查看该连接可以执行哪些操作，然后为它命名——这个名称会显示在它写下的每条项目符号上，所以请取一个你愿意在一天的笔记中看到的名字。“工作笔记本电脑”就比“Claude”好。

设置就这么简单。不必创建密钥、不必粘贴密钥、不必使用钥匙串、不必运行 claude mcp add，也不需要 URL。你可以随时在 notes.jpwilliams.dev 的 🔑 机器访问页面断开连接，断开后会立即停止工作。

桌面应用和网站

无需插件，也可以使用同一个连接。使用 URL https://notes.jpwilliams.dev/api/v1/mcp 将 Notes 添加为自定义连接器——应用会自行发现其余配置，并引导你前往同一个页面进行授权和命名。在终端中安装插件很有价值，因为它会携带一项 Skill，教 Claude _何时_使用笔记本；连接器本身则只提供工具和一份更精简的同类指南，由服务端直接发送。

它能做什么

四个工具，以及一项教 Agent 何时使用这些工具的 Skill。

工具	功能
list_entities	目录：所有项目、人物和主题，按最近提及时间从近到远排列。
get_entity	某个实体的页面——包括描述、带有子项目符号的近期提及、与其共同出现的内容，以及未完成的待办事项。
get_day	某一天的 Markdown 页面，以及带有 ID 的项目符号。
append_note	向某一天添加项目符号。

它刻意不能做的事

• 仅追加。 它永远不能编辑或删除任何内容——无论是你的文字、其他 Agent 的文字，还是它自己的文字。更正方式是新增一个条目，这本来也是笔记本的做法。
• 仅限已有实体。 如果 #tag 指向一个不存在的实体，整个调用都会被拒绝，而不是悄悄丢弃该标签。目前还不能重命名或合并实体，因此拼写错误会在你实际查看的索引中留下一个永久错误的分类。你需要手动为项目创建一次实体。
• 不搜索语料。 每次读取都受内容结构限制，而不是受数量上限限制，因此无论项目笔记积累了十年还是一个月，读取成本都一样。

它会读取什么

你的整个笔记本——每天的内容、每个实体、每个待办事项，包括从会议记录中摘出的笔记。这就是你在同意屏幕上批准的内容，屏幕上也明确写明了这一点。

它只能追加和读取；这些权限由服务端在读取数据时强制执行，而不是仅写在工具描述中，让模型自行决定是否遵守。

你会看到什么

Agent 写入的每个条目都会显示在你的每日视图中，并标注你为该连接指定的名称。将鼠标悬停即可查看凭据、写入时间，以及 Agent 对自身的说明——包括其供应商、模型和对话来源。后几项由 Agent 自行报告，并会明确标示；名称和时间戳则由我们记录，这正是让你为它命名、而非由应用自行命名的全部理由。

标记会记录来源，且永远不会消失。 手动编辑 Agent 的条目并不会让它变成你的内容——整理条目很常见，而如果标记第一次修改后就消失，那么大多数标记一周内就会消失。删除条目才是更正方式。

如果你更愿意在查看每日内容时隐藏这些条目，🔑「机器访问」中有一个开关。隐藏的运行仍会在原位置留下计数，因此某一天不会悄悄假装什么都没写过。同一页面会列出每个连接，你可以立即断开任意连接——它已经写入的笔记会原样保留，并继续标注你为它指定的名称。

要求

需要一个 Notes 账户。应用位于 notes.jpwilliams.dev。

许可证

MIT。