PluginBench
Skill
Pass
Audit score 90

gws-keep

googleworkspace/cli

Manage Google Keep notes via CLI with create, delete, get, list, and permission operations.

View on skills.sh

What is gws-keep?

Interact with Google Keep notes programmatically through the Google Workspace CLI. Use this skill to create, retrieve, delete, and list notes, as well as manage note permissions and download attachments.

  • Create new notes in Google Keep
  • Delete notes (owner role required)
  • Retrieve individual notes by ID
  • List notes with pagination support
  • Manage note permissions and collaborators
  • Download note attachments in various MIME types

How to install gws-keep

npx skills add null --skill gws-keep
Prerequisites
  • Google Workspace CLI (gws) installed and configured
  • Authentication credentials set up via gws-shared SKILL.md
  • Owner or appropriate permissions on notes to be modified
Claude Code
Cursor
Windsurf
Cline

How to use gws-keep

  1. 1.Run `gws keep --help` to browse available resources and methods
  2. 2.Use `gws schema keep.<resource>.<method>` to inspect required parameters and types
  3. 3.Build commands with `gws keep <resource> <method> [flags]` using discovered parameters
  4. 4.Use `--params` or `--json` flags to pass method arguments
  5. 5.For paginated results, capture `next_page_token` and pass it to subsequent list calls

Use cases

Good for
  • Automate note creation from external data sources
  • Bulk delete or archive notes programmatically
  • Retrieve note content for processing or backup
  • List all notes with filtering and pagination
  • Grant or revoke collaborator access to notes
Who it's for
  • Google Workspace administrators
  • Automation engineers building workflows
  • Developers integrating Keep with other systems
  • Teams managing shared note repositories

gws-keep FAQ

What authentication is required?

You must set up Google Workspace authentication through the gws-shared SKILL.md. Refer to that file for auth configuration and security rules.

Can I delete notes I don't own?

No. You must have the OWNER role on a note to delete it. Deletion is immediate and cannot be undone.

How do I handle large result sets?

The list method returns paginated results. Use the `next_page_token` from the response in subsequent requests to fetch additional pages.

What MIME types are supported for attachment downloads?

The API supports multiple MIME types for attachment media. Use the alt=media query parameter and specify your desired MIME type in the request.

How do I discover available parameters for a method?

Run `gws schema keep.<resource>.<method>` to inspect the method's required parameters, types, and defaults before building your command.

Full instructions (SKILL.md)

Source of truth, from googleworkspace/cli.

name: gws-keep description: "Manage Google Keep notes." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws keep --help"

keep (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws keep <resource> <method> [flags]

API Resources

media

  • download — Gets an attachment. To download attachment media via REST requires the alt=media query parameter. Returns a 400 bad request error if attachment media is not available in the requested MIME type.

notes

  • create — Creates a new note.
  • delete — Deletes a note. Caller must have the OWNER role on the note to delete. Deleting a note removes the resource immediately and cannot be undone. Any collaborators will lose access to the note.
  • get — Gets a note.
  • list — Lists notes. Every list call returns a page of results with page_size as the upper bound of returned items. A page_size of zero allows the server to choose the upper bound. The ListNotesResponse contains at most page_size entries. If there are more things left to list, it provides a next_page_token value. (Page tokens are opaque values.) To get the next page of results, copy the result's next_page_token into the next request's page_token.
  • permissions — Operations on the 'permissions' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws keep --help

# Inspect a method's required params, types, and defaults
gws schema keep.<resource>.<method>

Use gws schema output to build your --params and --json flags.

Related skills

More from googleworkspace/cli and the wider catalog.

GW

gws-gmail

googleworkspace/cli

Send, read, and manage Gmail emails via Google Workspace CLI.

40k installs
GW

gws-drive

googleworkspace/cli

Manage Google Drive files, folders, and shared drives via CLI.

37k installs
GW

gws-docs

googleworkspace/cli

Read and write Google Docs via command line.

37k installs
GW

gws-calendar

googleworkspace/cli

Manage Google Calendar events, calendars, and access control via CLI.

36k installsAudited
GW

gws-sheets

googleworkspace/cli

Read and write Google Sheets spreadsheets via CLI.

35k installs
GW

gws-gmail-send

googleworkspace/cli

Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.

31k installsAudited