
A command-line interface for Google Keep that lets you manage notes programmatically through the gws tool. You can create, delete, list, and retrieve notes, plus download attachments and manage permissions. Useful when you need to automate note-taking workflows, bulk export your Keep data, or integrate note management into scripts. The pagination support handles large note collections well, and the schema inspection commands help you understand the API parameters before making calls. It's essentially the Keep web interface translated into CLI commands, which is handy for developers who live in the terminal.
$ npx -y skills add googleworkspace/cli --skill gws-keep --agent claude-codeInstalls into .claude/skills of the current project.
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws keep <resource> <method> [flags]
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.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' resourceBefore 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.
Sponsors