Google Keep Notes Skill 📝#

WHEN TO USE#

Use this skill when users ask to:

• List Google Keep notes
• Search notes by keyword
• Create new notes
• Add items to notes
• Get specific note details
• Archive/pin/delete notes

"List" = Google Keep note (not a bullet list)

SETUP (First Run Only)#

1. Creates venv + installs requirements automatically
2. Manual call of generate_token.py from the shell, then copy & paste token to file $HOME/.config/gkeep/token.json.

text

gkeep.py list [--limit 10]                    # List notes
gkeep.py search "note_name"                   # Search notes
gkeep.py get <note_id>                        # Get note details
gkeep.py create "note_name" "note_body"       # Create note
gkeep.py add <note_id> "new item"             # Add item to note
gkeep.py archive <note_id>                    # Archive note
gkeep.py delete <note_id>                     # Trash note
gkeep.py pin <note_id>                        # Pin note
gkeep.py unpin <note_id>                      # Unpin note

USAGE FLOW#

text

1. User: "Show my <note_name>"
2. → gkeep.py list | grep <note_name> → note_id
3. → gkeep.py get <note_id> → show content
4. User: "Add milk to <note_name>"
5. → gkeep.py list | grep <note_name> → note_id
6. → gkeep.py add <note_id> "milk"

EXECUTION TEMPLATE#

bash

cd ~/.openclaw/workspace/skills/gkeep-notes
source venv/bin/activate
python gkeep.py [command] [args]

TROUBLESHOOTING#

text

❌ "No token" → manually generate token with generate_token.py and copy token into token.json
❌ "Module not found" → setup properly
❌ "API changed" → Check GitHub issues

NOTES#

• Unofficial API (may break if Google changes)
• venv auto-created during setup
• Note IDs from gkeep list output
• Active project (updated March 2026)

text