# gkeep

> Manage Google Keep notes from the command line: list, search, create, archive, delete, pin, and unpin notes using the gkeepapi library.

- Skill: `kbarbel640-del/gkeep` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds add kbarbel640-del/gkeep`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/gkeep/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity, Note-taking
- Tags: Cli, Gkeepapi, Google Keep, Note Taking, Notes
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/kbarbel640-del/gkeep

---


# gkeep

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

## Setup

Login with your Google account:
```bash
gkeep login your.email@gmail.com
```

**Important:** Use an [App Password](https://myaccount.google.com/apppasswords), not your regular password. 2FA must be enabled.

## Commands

List notes:
```bash
gkeep list
gkeep list --limit 10
```

Search:
```bash
gkeep search "shopping"
```

Get a specific note:
```bash
gkeep get <note_id>
```

Create a note:
```bash
gkeep create "Title" "Body text here"
```

Archive:
```bash
gkeep archive <note_id>
```

Delete (trash):
```bash
gkeep delete <note_id>
```

Pin:
```bash
gkeep pin <note_id>
```

Unpin:
```bash
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)