Back to Skills

gws-keep

Manage Google Keep notes.

24,712stars1,257forksUpdated 4/15/2026

Security Assessment

Safe(100/100)
Security Score100/100

About gws-keep

The gws-keep skill is designed to manage Google Keep notes efficiently. It allows users to interact with Google Keep through command-line commands, enabling automation and script-based workflows. This skill solves the problem of manually managing notes in Google Keep by providing a programmatic interface, making it easier to automate note creation, deletion, retrieval, and listing tasks. This is especially useful for users who want to integrate Google Keep into their broader productivity systems or automate note management within their workflows.

Main features of the gws-keep skill include the ability to create and delete notes, retrieve specific notes, and list all notes with pagination support. Additionally, it offers operations for managing permissions on notes, such as modifying who has access to them. The ability to download media attachments from notes is also supported, though it requires handling specific MIME types. The CLI commands offer flexibility and control for users who want to perform tasks quickly, without needing to open the Google Keep interface. The skill is also part of the broader gws package, which means users can leverage its functionality within larger productivity automation setups.

This skill is targeted primarily at developers, IT professionals, and advanced users who are comfortable with command-line interfaces and want to automate or manage their Google Keep notes programmatically. It's ideal for users looking to integrate note-taking into larger systems or for those who need to handle a large number of notes with precision, such as in organizational or project management contexts.

FAQ

How do I authenticate to use the gws-keep skill?

Before using the gws-keep skill, you must refer to the `../gws-shared/SKILL.md` file for authentication and global flag configurations.

What is the purpose of the `--page_size` flag?

The `--page_size` flag is used to limit the number of notes returned in a list call. Setting it to zero allows the server to decide the upper limit.

Can I recover a deleted note?

No, once a note is deleted using the `delete` method, it cannot be undone, and the note is permanently removed.

What permissions are required to delete a note?

The user must have the `OWNER` role on the note in order to delete it.

Is there any compatibility requirement for using the gws-keep skill?

Yes, the gws-keep skill requires the `gws` binary to be installed and properly configured.

Install gws-keep

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill