keepsake-mcp 是 Keepsake（keepsake.place）的 MCP 服务器。Keepsake 被描述为面向创作者和独立创业者的应用，帮助他们“清空大脑”：将想法、任务和重要的人集中并关联在一个地方，一直延续到发布环节。
用途 通过该 MCP 服务器，用户可以把 AI 助手（Claude、Cursor 或任何兼容 MCP 的客户端）连接到自己的 Keepsake 数据，涵盖联系人、互动、任务、笔记、每日意图、公司和标签。官方说明指出，AI 助手在不同对话之间会遗忘，而 Keepsake 会记住。
主要能力 可让 AI 助手执行的操作示例包括：将想法捕获到 #newsletter# 标签、查询最近在 Acme Corp 联系过谁、添加一条关于在会议上遇到 Sarah 的笔记、查看哪些任务逾期、展示与 #house-project 标签相关的所有内容、为下周与 John 的会议创建跟进任务。服务器共提供 88 个工具，涉及条目（互动）、笔记评论（页边注）、日子（每日意图或问题）、日块（日记视图时间线）、重复块（理想的一天/理想的一周、习惯）、任务标题（分区）、联系人与公司关联等。笔记评论用于把材料保留在笔记旁而不进入正文，可锚定到某个段落或整条笔记，按设计是临时的、永不发布，值得保留的内容应转为笔记或关联任务。
使用方式 首先在 keepsake.place 注册，然后前往 Account > API Keys 生成 API Key。 连接方式有两种：
- 远程方式，无需安装，适用于 Claude iOS、Claude Web、Claude Desktop Connectors 以及任何支持 Streamable HTTP 的 MCP 客户端。端点为 https://app.keepsake.place/api/mcp，认证方式为在 Authorization 请求头中以 Bearer token 传递 API Key。在 Claude Desktop 设置中添加远程 MCP 服务器时填写该 URL，并使用以 ksk_ 开头的 API Key 作为 Bearer token。
- 本地方式，通过 npx 运行，适用于 Claude Code、Cursor 和本地开发。对于 Claude Desktop，可在 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json 中添加配置，然后在环境中设置 KEEPSAKE_API_KEY。对于 Cursor，可在项目中的 .cursor/mcp.json 添加配置。
服务器指令 连接时，服务器会发送 MCP 指令，这些指令会被注入客户端的系统提示中。官方说明称，这是代理在寻找能力之前唯一能触达的通道，因此保持简短，并指向其余内容：调用 get_agent_instructions 获取完整准则，并将编辑性备注放在笔记的页边注中（create_note_comment），而不是放在会消失的聊天里。官方建议在每个会话开始时调用 get_agent_instructions 以获取完整最佳实践指南。
安全标注与活动记录 所有工具都包含 MCP 安全标注：只读工具（list_、get_、search_*）标记 readOnlyHint: true；创建工具标记 destructiveHint: false；更新工具标记 destructiveHint: false、idempotentHint: true；删除工具标记 destructiveHint: true、idempotentHint: true。 通过 API 执行的每一次写操作（创建、更新、删除）都会记录在 Keepsake 内用户可见的 Activity Feed 中，显示实体类型、内容预览以及使用了哪个 API Key。官方提示用户可以看到所有操作，因此应保持透明和精确；如果出错，应告知用户以便其在活动流中核实。
限制与数据说明 速率限制为每个 API Key 每分钟 60 次请求，响应中包含速率限制标头。环境变量相关说明在官方文本中未完整展开，仅提到需设置 KEEPSAKE_API_KEY。完整的 REST API 文档位于 keepsake.place/api。官方声明 Keepsake MCP 服务器仅与 Keepsake API（app.keepsake.place）通信，不向任何第三方服务发送数据，数据保留在用户的 MCP 客户端与 Keepsake 账户之间；所有 API 调用都使用个人 API Key 认证，并通过行级安全（Row Level Security）限定在用户账户范围内，无法访问其他用户的数据。隐私政策见 keepsake.place/privacy。