gogkeep 0.2.1

CLI interface for Google Keep matching gog style

gogkeep

gogkeep is a Google Keep CLI matching the gogcli interface. It enables access for personal Gmail accounts, bypassing the "Workspace-only" restriction of the official Keep API.

Installation

From PyPI

pip install gogkeep

Via pipx

pipx install gogkeep

Authentication

gogkeep automates Master Token extraction using the Chrome DevTools Protocol (CDP), removing the need for manual cookie surfing.

Login

gogkeep login

This automatically launches an isolated browser. Log in, and gogkeep will capture the token. Press Ctrl+C at any time to skip to manual cookie extraction.

[!NOTE] This approach is based on the alternative flow for gpsoauth by julianpitt.

Usage

Root Flags

• -a, --account EMAIL: Set the account email (also can be set via GOG_ACCOUNT env var).
• -j, --json: Output as JSON.
• -p, --plain: Output as tab-separated values.
• -n, --dry-run: Do not make changes.

Commands

List Notes

gogkeep list

Get Note

gogkeep get <note_id>

Search Notes

gogkeep search "query text"

Create Note

gogkeep create --title "My Title" --text "My body text"

Delete Note

gogkeep delete <note_id>

Download Attachment

gogkeep attachment <attachment_name> --out local_filename.jpg

Attachment names follow the format notes/<note_id>/attachments/<attachment_id>.

Keyring Storage

gogkeep securely stores your Master Token using the system keyring:

• macOS: Keychain
• Linux: Secret Service (D-Bus)
• Fallback: Encrypted file in ~/.config/gogkeep/

You can force specific behavior using environment variables:

• GOGKEEP_ACCOUNT: Default account email.
• GOGKEEP_KEYRING_BACKEND: auto, keychain, file, or secret-service.
• GOGKEEP_KEYRING_PATH: Custom path for the encrypted file backend.
• GOGKEEP_KEYRING_PASSWORD: Password for the encrypted file (if not in a TTY).