← 返回目录

Keep MCP Server

社区

谷歌 Keep 的 MCP 服务器，提供笔记管理和自动化操作。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 云存储第 6 / 15
Stars: ★ 105 热门
传输方式: stdio（本地进程）
运行环境: Python 3.11 · 预编译二进制
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 8 天前
工具数: 23

静态评测 · 未实际运行收录于 2026-08-07

FMRS 60/100 · C · 最弱项可靠性 10/20 — 查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

个人知识管理
笔记自动化
与 Google Keep 紧密协作的 AI 工作流

不适合谁

需要高安全级别、无法共享邮箱令牌的环境
完全没有 Google 账号的用户
需要完整官方 API 支持的高级功能（如音频笔记）

所需权限

需要访问 Google 账号的邮箱和主令牌（master token）以认证
可读写笔记、标签、协作者和媒体，具体范围取决于令牌权限和 UNSAFE_MODE 设置

风险与副作用

主令牌泄露可能导致账号数据被恶意访问
默认安全机制（keep-mcp 标签）可能限制对非服务器创建笔记的修改，若开启 UNSAFE_MODE 则风险增加
删除等破坏性操作可能不可逆，需谨慎使用

安装接入

准备工作

运行环境：Python 3.11 · 预编译二进制

GOOGLE_EMAIL 必填你的 Google 账户邮箱地址。

GOOGLE_MASTER_TOKEN 必填密钥 Google 账户主令牌，获取方法见 gkeepapi 文档（gkeepapi.readthedocs.io）及 gpsoauth 的 alternative-flow 说明。

其他可选配置项（1 个）

UNSAFE_MODE 可选设为 true 可绕过仅修改 keep-mcp 标签笔记的限制，默认应保持 false。

添加 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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add keep-mcp-pipx -e 'GOOGLE_EMAIL=Your Google Email' -e 'GOOGLE_MASTER_TOKEN=Your Google Master Token - see README.md' -- pipx run keep-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中重启后，确认工具列表中出现了 find、get_note、create_note 等工具；再用 find 提示词执行一次搜索，若能返回 Google Keep 的笔记即证明连接成功。

常见排障

若遇 DeviceManagementRequiredOrSyncDisabled，请在 Google Admin 中关闭移动管理
确保 GOOGLE_EMAIL 和 GOOGLE_MASTER_TOKEN 正确设置，且令牌未过期
检查 MCP 客户端配置是否使用正确的命令和参数

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索带有 TODO 标签的所有笔记
创建一条标题为"购物清单"的清单笔记
把我的笔记颜色改成黄色并置顶
列出 ID 为 xxx 的笔记中的媒体文件

工具能力 23

find 只读

搜索笔记，支持按标签、颜色、置顶、归档、回收站筛选

get_note 只读

根据 ID 获取单个笔记

create_note 写入

创建新笔记，自动添加 keep-mcp 标签

create_list 写入

创建清单笔记

update_note 写入

更新笔记的标题和文本

add_list_item 写入

向清单笔记添加项目

update_list_item 写入

更新清单项目文本和勾选状态

delete_list_item 破坏性

删除清单项目

展开其余 15 个工具

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 只读

列出笔记的媒体文件（含链接）

使用场景

自动化管理 Google Keep 笔记

通过 AI 助手快速搜索和整理笔记

集成笔记协作流程

支持客户端

Claude Desktop

Cursor

Cline

Codex

Goose

依据项目文档列出，未经本站实测。

详细介绍

keep-mcp 是一个 MCP 服务器，让 AI 助手能够访问和管理 Google Keep 笔记。它支持搜索、创建、更新、删除笔记，以及管理标签、协作者和媒体文件。服务器默认限制修改操作仅对由服务器创建的笔记（带 keep-mcp 标签）生效，可通过 UNSAFE_MODE 环境变量解除限制。