# Manage Google Keep Notes with gws

Managing Google Keep resources from an AI workflow requires precise CLI commands and API parameters. This skill guides structured note, attachment, and permission operations.

## Install

```bash
npx skillstore add googleworkspace/gws-keep
```

## Metadata

- Status: approved
- Slug: googleworkspace-gws-keep
- Version: 0.23.0
- Author version: 0.23.0
- Skillstore revision: r2
- Version status: valid
- Tree hash: a43dbbc28f20a914f4b9a8e9cabc17672370e8f7de489351dedd56758682c50f
- Author: googleworkspace
- GitHub username: googleworkspace
- License: MIT
- Repository: https://github.com/googleworkspace/cli/tree/main/skills/gws-keep/
- Ref: 286d37c9c189ddd1aafd3548415fb031d1df79d5
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 80
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/googleworkspace-gws-keep
- Manifest: https://skillstore.pages.dev/api/skills/googleworkspace-gws-keep/manifest

## Capabilities

- Create new Google Keep notes through the gws CLI.
- Retrieve individual notes and list paginated note collections.
- Delete notes when the authenticated caller has the OWNER role.
- Discover note, media, and permission methods with CLI help.
- Inspect required parameters, types, and defaults before API calls.
- Download available attachment media in supported MIME types.

## Use Cases

- Organize Personal Notes: Create and retrieve Keep notes from a guided command workflow.
- Review Shared Note Access: Inspect available permission operations before managing collaboration settings.
- Process Note Collections: List notes across pages and preserve continuation tokens for later requests.

## Prompt Templates

### List My Notes

```
Show me how to list my Google Keep notes. Inspect the method schema first and explain any pagination fields.
```

### Create a Note

```
Prepare a Google Keep note creation request for this content: {note_content}. Inspect required parameters before proposing the command.
```

### Download an Attachment

```
Help me download attachment {attachment_name} from note {note_name}. Verify media parameters and explain MIME type constraints.
```

### Plan a Paginated Review

```
Design a safe workflow to review all Keep notes, continue through page tokens, and identify permission operations without deleting anything.
```

## Limitations

- The gws CLI and its Google authentication setup must already be available.
- The adjacent gws-shared skill supplies global flags and security guidance.
- Note deletion is immediate, irreversible, and restricted to owners.
- Attachment downloads depend on media availability and the requested MIME type.

## Best Practices

- Inspect each method schema before constructing parameters or request bodies.
- Preserve opaque page tokens exactly when continuing a list operation.
- Confirm ownership and user intent before any irreversible note deletion.

## Anti Patterns

- Do not guess parameter names or types without checking the method schema.
- Do not alter, decode, or reuse pagination tokens for unrelated requests.
- Do not delete notes without confirming ownership, collaborators, and irreversible impact.

## Security Audit

- Audited at: 2026-08-05T11:16:34.652\+00:00
- Summary: All static findings are false positives caused by Markdown backticks, code fences, and one fixed adjacent-file reference. No semantic security threats or prompt injection attempts were found in SKILL.md.

## Stats

- Views: 56
- Downloads: 6
- Favorites: 0
- Popularity score: 0