gws-keep Skill for Claude: What It Does and How to Install It

Lets your AI agent create, read, list and delete Google Keep notes by running the gws command-line tool.

Installs: 39.1K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

This skill lists the Keep API calls the gws tool can make: create, get, list and delete notes, manage a note's permissions and download attachments. It tells the agent to check a method with gws schema before calling it.

It does nothing alone. You need the gws program installed and signed in with a Google Cloud project, and the companion gws-shared skill, which the skill tells the agent to read first.

Good for

People who keep notes in Google Keep and want an agent to find or add them
Developers already using the gws tool for Drive, Gmail or Calendar
Gemini CLI users, since the repo ships a Gemini extension

Install gws-keep

Claude Code

Copy this prompt.

Install the gws-keep skill in Claude Code. Run this command:

npm install -g @googleworkspace/cli
gws auth setup
gws auth login
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-keep
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-shared

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18+, gcloud CLI (for gws auth setup), Google Cloud project, Google account.

Install the gws program and sign in with Google before you use the skill. The README needs Node.js 18+ for the npm route (or a prebuilt binary), a Google Cloud project for OAuth and a Google account. gws-keep tells the agent to read gws-shared first, so install both. No Claude app upload tab is listed because the skill runs the gws program on your computer.

From the project README. Source.

What's in the skill

When it loads

Manage Google Keep notes.

Sections in SKILL.md

API Resources
media
notes
Discovering Commands

Key facts

Author: googleworkspace/cli (repo owner)
Official status: The README says it is not an officially supported Google product
License: Apache-2.0
Installs on skills.sh: 39,116 (Nov 2, 2026)
GitHub stars: 32,038 for the whole googleworkspace/cli repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
Skill version: 0.22.5
What it includes: 1 file: SKILL.md. It calls the gws program and reads the gws-shared skill
Needs: The gws program on your PATH, the gws-shared skill, a Google account and a Google Cloud project for OAuth
Project status: Under active development. The README says to expect breaking changes before v1.0
Works in: The README installs skills with npx skills add and also documents an OpenClaw setup and a Gemini CLI extension. It lists no other clients

What it includes

Loads auth, global flags and security rules
The skill's prerequisite. If the file is missing, SKILL.md says to run gws generate-skills to create it.
Read · Read gws-shared first
Creates a new note
Runs gws keep notes create with your JSON body.
Try: “Add a Keep note called Groceries with milk, eggs and bread.”
Write · notes create
Lists notes or fetches one
List returns pages of results and a next-page token. Get returns a single note.
Try: “List my 10 newest Google Keep notes.”
Network · notes list / get
Deletes a note
SKILL.md says deleting removes the note immediately, cannot be undone, needs the OWNER role and removes access for collaborators.
Delete · notes delete
Works on a note's permissions
SKILL.md lists a permissions resource for notes and describes it only as operations on the permissions resource. Run gws schema keep.permissions.<method> to see what each method does.
Write · notes permissions
Downloads a note attachment
Needs the alt=media query parameter and returns an error if the attachment is not available in the requested type.
Files · media download
gws keep --help and gws schema keep.<resource>.<method>
Before any call, the agent inspects the method to build the right params and JSON.
Read · Discover commands

From the official docs

Permissions

Medium risk

The skill can read, share and permanently delete your Google Keep notes. Ask the agent to show each write or delete command and use --dry-run first.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can delete notes for good
SKILL.md says deleting a note cannot be undone and collaborators lose access. The gws-shared skill says to confirm write and delete commands first and to use --dry-run. Hold the agent to that. github.com
It has a permissions resource for notes
SKILL.md lists a permissions resource but does not describe its methods. Ask the agent to show the command before it runs any permissions call. github.com
It signs in with your Google account
The README says credentials are encrypted at rest, with the key in your OS keyring. When your OAuth app is unverified, pick only the scopes you need. github.com
gws is unofficial and still changing
The README says it is not an officially supported Google product and to expect breaking changes. Pin a version if you script it. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. The gws --dry-run flag validates a request locally without calling the API.
Talks to	Google APIs, through the gws program. Google sign-in (OAuth) when you run gws auth login
Sign-in and keys	Credentials are encrypted at rest (AES-256-GCM) with the key stored in your OS keyring, or in ~/.config/gws/.encryption_key when the file backend is chosen (README).
Scopes	Reads, creates and deletes your Google Keep notes Can run operations on a note's permissions resource Runs gws commands in your shell after you sign in with Google

Questions

What does the gws-keep skill do?

It teaches an agent to manage Google Keep notes with the gws command-line tool. It can create, get, list and delete notes, work on note permissions and download attachments.

How do I install gws-keep?

Use the install box at the top of this page. It installs the gws program, signs you in and adds both gws-keep and gws-shared, because the skill reads gws-shared first.

Does it work in the Claude app?

There is no Claude app upload tab on this page because the skill runs the gws program on your computer and the README documents no Claude app route. Use Claude Code, Codex or another coding agent that can run commands.

What do I need besides the skill?

The gws program, a Google account and a Google Cloud project for OAuth. The README lists Node.js 18+ for the npm install, or you can download a prebuilt binary.

Can it delete my notes?

Yes. Deleting a note is permanent and collaborators lose access. The gws-shared skill tells the agent to confirm write and delete commands first and to prefer --dry-run.

Is gws-keep safe?

It can change or delete your Keep notes after you sign in with your Google account, so review each write or delete command. Deleting a note cannot be undone. The README also says gws is not an officially supported Google product.

How is it different from the other gws skills?

The repo ships one skill per Google Workspace API, such as gws-drive and gws-gmail. This one covers only Keep. The README says the full list is in its Skills Index.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-keep

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

gws-keep SKILL.md · github.com
googleworkspace/cli README · github.com
gws-shared SKILL.md · github.com