适合谁
- 个人知识管理
- 笔记自动化
- 与 Google Keep 紧密协作的 AI 工作流
K
60FMRS · C
keep-mcp 是一个 MCP 服务器，让 AI 助手能够访问和管理 Google Keep 笔记。它支持搜索、创建、更新、删除笔记，以及管理标签、协作者和媒体文件。服务器默认限制修改操作仅对由服务器创建的笔记（带 keep-mcp 标签）生效，可通过 UNSAFE_MODE 环境变量解除限制。
工具能力
find
搜索笔记，支持按标签、颜色、置顶、归档、回收站筛选
get_note
根据 ID 获取单个笔记
create_note
创建新笔记，自动添加 keep-mcp 标签
create_list
创建清单笔记
update_note
更新笔记的标题和文本
add_list_item
向清单笔记添加项目
update_list_item
更新清单项目文本和勾选状态
delete_list_item
删除清单项目
set_note_color
设置笔记颜色
pin_note
置顶或取消置顶笔记
archive_note
归档或取消归档笔记
trash_note
将笔记移至回收站
restore_note
恢复已删除的笔记
delete_note
标记笔记以删除
list_labels
列出所有标签
create_label
创建标签
delete_label
删除标签
add_label_to_note
为笔记添加标签
remove_label_from_note
从笔记移除标签
list_note_collaborators
列出笔记的协作者邮箱
add_note_collaborator
为笔记添加协作者邮箱
remove_note_collaborator
从笔记移除协作者邮箱
list_note_media
列出笔记的媒体文件（含链接）
安装接入
- 添加 MCP 服务器配置到客户端（如上 JSON 示例）。
- 设置环境变量 GOOGLE_EMAIL 和 GOOGLE_MASTER_TOKEN，获取方法见文档链接。
- 如需修改非 keep-mcp 标签的笔记，可设置 UNSAFE_MODE=true。
claude_desktop_config.json
{
"mcpServers": {
"keep-mcp-pipx": {
"command": "pipx",
"args": [
"run",
"keep-mcp"
],
"env": {
"GOOGLE_EMAIL": "Your Google Email",
"GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
}
}
}
}
选型与风险
不适合谁
- 需要高安全级别、无法共享邮箱令牌的环境
- 完全没有 Google 账号的用户
- 需要完整官方 API 支持的高级功能（如音频笔记）
所需权限
- 需要访问 Google 账号的邮箱和主令牌（master token）以认证
- 可读写笔记、标签、协作者和媒体，具体范围取决于令牌权限和 UNSAFE_MODE 设置
风险与副作用
- 主令牌泄露可能导致账号数据被恶意访问
- 默认安全机制（keep-mcp 标签）可能限制对非服务器创建笔记的修改，若开启 UNSAFE_MODE 则风险增加
- 删除等破坏性操作可能不可逆，需谨慎使用
常见排障
- 若遇 DeviceManagementRequiredOrSyncDisabled，请在 Google Admin 中关闭移动管理
- 确保 GOOGLE_EMAIL 和 GOOGLE_MASTER_TOKEN 正确设置，且令牌未过期
- 检查 MCP 客户端配置是否使用正确的命令和参数
使用场景
自动化管理 Google Keep 笔记
通过 AI 助手快速搜索和整理笔记
集成笔记协作流程
支持客户端
Claude Desktop完整支持
Cursor完整支持
Cline完整支持
Codex完整支持
Goose完整支持