# Send Google Keep to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "google-keep",
    "name": "Google Keep",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/tag-assistant/google-keep",
    "canonicalUrl": "https://clawhub.ai/tag-assistant/google-keep",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/google-keep",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-keep",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "gkeep.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "google-keep",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T21:51:32.710Z",
      "expiresAt": "2026-05-10T21:51:32.710Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-keep",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=google-keep",
        "contentDisposition": "attachment; filename=\"google-keep-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "google-keep"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/google-keep"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/google-keep",
    "downloadUrl": "https://openagent3.xyz/downloads/google-keep",
    "agentUrl": "https://openagent3.xyz/skills/google-keep/agent",
    "manifestUrl": "https://openagent3.xyz/skills/google-keep/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/google-keep/agent.md"
  }
}
```
## Documentation

### Google Keep CLI Skill

Manage Google Keep notes and lists from the command line using the unofficial gkeepapi.

### Setup

After installing, the CLI lives in the skill directory. Set up a convenience alias or wrapper:

SKILL_DIR="<path-to-this-skill>"  # e.g. skills/google-keep
alias gkeep="$SKILL_DIR/.venv/bin/python3 $SKILL_DIR/gkeep.py"

Or create a global wrapper:

cat > ~/.local/bin/gkeep << 'EOF'
#!/bin/bash
SKILL_DIR="$(dirname "$(readlink -f "$0")")/../.openclaw/workspace/skills/google-keep"
exec "$SKILL_DIR/.venv/bin/python3" "$SKILL_DIR/gkeep.py" "$@"
EOF
chmod +x ~/.local/bin/gkeep

### First-time setup (OAuth token exchange):

Go to https://accounts.google.com/EmbeddedSetup in your browser
Log in with your Google account
Click "I agree" on the consent screen (page may spin forever — ignore it)
Open DevTools: F12 → Application tab → Cookies → accounts.google.com
Copy the value of the oauth_token cookie
Run:

gkeep auth <email> <oauth_token>

### With pre-obtained master token:

gkeep auth-master <email> <master_token>

Credentials are stored in <skill-dir>/.config/ (chmod 600). The master token has full account access — treat it like a password. It does not expire (unlike standard OAuth refresh tokens).

### List notes

gkeep list                    # Active notes
gkeep list --archived         # Include archived
gkeep list --pinned           # Pinned only
gkeep list --label "Shopping" # Filter by label
gkeep list --json             # JSON output
gkeep list -v                 # Show IDs

### Search

gkeep search "grocery"
gkeep search "todo" --json

### Get a specific note

gkeep get <note-id>
gkeep get "Shopping List"     # By title (case-insensitive)
gkeep get <id> --json

### Create notes

gkeep create --title "Ideas" --text "Some thoughts"
gkeep create --title "Groceries" --list --items "Milk" "Eggs" "Bread"
gkeep create --title "Important" --pin --color Red --label "Work"

### Edit notes

gkeep edit <id-or-title> --title "New Title"
gkeep edit <id-or-title> --text "Updated text"
gkeep edit <id-or-title> --pin true
gkeep edit <id-or-title> --archive true
gkeep edit <id-or-title> --color Blue

### List operations

gkeep check "Groceries" "milk"           # Check off an item
gkeep check "Groceries" "milk" --uncheck # Uncheck
gkeep check "Groceries" "m" --all        # Check all matching
gkeep add-item "Groceries" "Butter" "Cheese"  # Add items

### Delete (trash)

gkeep delete <id-or-title>

### Labels

gkeep labels              # List all labels
gkeep labels --json

### Export / backup

gkeep dump                # All notes as JSON
gkeep dump > backup.json

### Colors

Valid colors: White, Red, Orange, Yellow, Green, Teal, Blue, DarkBlue, Purple, Pink, Brown, Gray

### How it works

Uses gkeepapi (1,600+ stars, actively maintained) — an unofficial reverse-engineered Google Keep client
Auth via gpsoauth — Google Play Services OAuth flow to obtain a master token
State is cached locally (.config/state.json) for fast startup after the initial sync
Master tokens don't expire, so no re-auth dance
Unofficial API — Google could break compatibility at any time (but gkeepapi has been stable for years)

### Security notes

The master token grants full access to the associated Google account
Credentials are stored with 600 permissions in .config/
Never commit .config/ to version control
delete moves notes to trash (recoverable) — it does not permanently delete
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: tag-assistant
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T21:51:32.710Z
- Expires at: 2026-05-10T21:51:32.710Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/google-keep)
- [Send to Agent page](https://openagent3.xyz/skills/google-keep/agent)
- [JSON manifest](https://openagent3.xyz/skills/google-keep/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/google-keep/agent.md)
- [Download page](https://openagent3.xyz/downloads/google-keep)