gkeep_skill

Overview

This skill provides a command-line wrapper for Google Keep using the gkeepapi unofficial client. It lets you list, search, create, archive, pin, unpin, and delete notes from the terminal. It is focused on quick, scriptable note management and small-scale automation.

How this skill works

The skill talks to Google Keep via the reverse-engineered gkeepapi library and performs CRUD operations on notes. Authentication uses your Google account with an App Password (2FA required) and stores credentials locally. Commands map directly to common Keep actions (list, search, get, create, archive, pin, delete).

When to use it

• Quickly search or list Google Keep notes from a terminal or script
• Create notes programmatically or from shell scripts
• Archive/pin/manage notes without opening a web browser or mobile app
• Back up or export note metadata as part of a workflow
• Automate simple reminder or note-tracking tasks

Best practices

• Use an App Password rather than your main Google password; enable 2FA on the account
• Keep the token file (~/.config/gkeep/token.json) secure and backed up if needed
• Run the first-auth step on a safe machine; the tool bootstraps a local virtual environment for isolation
• Expect occasional breakage because this relies on an unofficial API that mirrors Google’s internal endpoints
• Limit automated bulk operations and test commands on a small set of notes first

Example use cases

• Run gkeep list --limit 10 to get recent notes for daily standup summaries
• Search for project-related notes: gkeep search "project-name" and pipe results to scripts
• Create notes from CI hooks or cron jobs: gkeep create "Backup" "Backup completed at $(date)"
• Archive or delete old notes in bulk as part of housekeeping scripts
• Pin an important note from the command line during a deployment or incident