核心用法
gkeep 是基于 gkeepapi 的非官方 Google Keep 命令行工具，通过反向工程 Google Keep 内部 API 实现笔记管理功能。
安装与登录
gkeep login your.email@gmail.com # 需使用 App Password，非普通密码
主要功能
gkeep list [--limit N]— 列出笔记，支持数量限制gkeep search "关键词"— 全文搜索gkeep get <note_id>— 查看单条笔记详情gkeep create "标题" "正文"— 创建新笔记gkeep archive/pin/unpin/delete <note_id>— 归档、置顶、取消置顶、删除
显著优点
1. 终端原生体验：无需打开浏览器或手机 App，适合键盘优先的工作流
2. 功能完整：覆盖笔记生命周期管理的核心操作
3. 活跃维护：项目截至 2026 年 1 月仍在更新
4. 本地隔离：首次运行自动创建独立 venv，避免依赖冲突
潜在缺点与局限性
1. API 不稳定风险：依赖非官方逆向 API，Google 随时可能变更接口导致功能失效
2. 认证复杂度：必须使用 App Password + 2FA，对普通用户门槛较高
3. 功能边界：不支持复杂格式（如图片、绘图、提醒设置）、标签管理等高级功能
4. 单点故障：无官方 SLA 保障，故障时无支持渠道
适合人群
- 习惯终端操作的开发者、系统管理员
- 需要快速笔记查询/创建的自动化场景（配合脚本）
- 对 Google Keep 有轻度依赖、追求效率优先的用户
常规风险
- 凭证泄露：Token 存储于
~/.config/gkeep/token.json，需确保目录权限安全（建议 600） - 数据一致性：非官方 API 可能在极端情况下造成笔记状态不同步
- 服务中断：Google 接口变更可能导致工具突然不可用，建议定期关注上游更新