← Back to Notes & PKM
Notes & PKM by @vacinc

gkeep

Google Keep notes via gkeepapi. List, search, create, and manage notes

gkeep

CLI wrapper for Google Keep using gkeepapi (unofficial API).

Setup

Login with your Google account:

gkeep login your.email@gmail.com

Important: Use an App Password, not your regular password. 2FA must be enabled.

Commands

List notes:

gkeep list
gkeep list --limit 10

Search:

gkeep search "shopping"

Get a specific note:

gkeep get <note_id>

Create a note:

gkeep create "Title" "Body text here"

Archive:

gkeep archive <note_id>

Delete (trash):

gkeep delete <note_id>

Pin:

gkeep pin <note_id>

Unpin:

gkeep unpin <note_id>

Notes

  • This uses an unofficial API that reverse-engineers Google Keep
  • Could break if Google changes their internal API
  • Token stored in ~/.config/gkeep/token.json
  • First run bootstraps a local venv at skills/gkeep/.venv
  • Active project with recent updates (as of Jan 2026)