Google Keep笔记管理

技能简介

通过非官方gkeepapi库，在终端直接操作Google Keep笔记。支持列出、搜索、创建、归档、删除、置顶等完整生命周期管理，无需打开浏览器或手机应用。

业务背景

无需切换浏览器或手机，在终端即可管理Google Keep笔记。适合高频使用命令行的技术人员快速记录灵感、整理待办，减少上下文切换成本，保持工作流连贯性。

落地案例：开发者在代码调试时突然想到优化方案，直接在终端输入命令创建笔记记录思路；每日站会前快速列出最近10条笔记回顾昨日进展；项目结束后批量归档已完成的事项笔记，让主界面保持清爽。

能做什么

• 快速浏览所有笔记，支持数量限制过滤
• 按关键词全文搜索笔记内容
• 新建文本笔记，指定标题与正文
• 归档已完成事项，减少主界面干扰
• 将重要笔记置顶，优先展示
• 移入回收站清理过期备忘

使用说明

安装准备

首次运行会自动创建本地虚拟环境（skills/gkeep/.venv），需确保系统已安装Python 3。

登录授权

gkeep login your.email@gmail.com

必须使用Google应用专用密码登录，普通账户密码无法通过验证。前提条件：Google账号已开启两步验证。

常用操作

查看最近10条笔记：

gkeep list --limit 10

搜索购物相关备忘：

gkeep search "shopping"

创建新笔记：

gkeep create "会议记录" "周三下午三点讨论Q3预算"

归档指定笔记：

gkeep archive <note_id>

访问令牌默认存储于~/.config/gkeep/token.json。

输入与输出

见下方输入与输出表格。

风险提示

• 基于逆向工程的非官方API，Google随时可能调整接口导致功能失效
• 应用专用密码泄露将导致Google账号数据暴露风险
• 令牌文件本地明文存储，多人共用设备需额外注意权限设置
• 网络异常时可能出现笔记同步延迟或冲突

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/vacinc/gkeep/SKILL.md
来源类型：开源社区技能仓库