Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-keep — Claude skill: manage Google Keep notes from the CLI

This skill wires Google Keep into your agent: create, read, list and delete notes, plus download attachments through the gws CLI.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add googleworkspace/cli --skill gws-keep -a claude-code
Open on GitHub

What gws-keep does

The skill maps Google Keep onto gws keep [flags]. Two resources are covered: notes and media. You get create, get, list and delete for notes, and a download call for attachments. Listing is paged — the response carries a next_page_token that you copy into the next request as page_token.

Before calling anything, the skill tells the agent to inspect the method: gws keep --help for the resource list, gws schema keep.. for required params and types. Those flags feed --params and --json. Deleting is immediate and cannot be undone, and the caller needs the OWNER role on the note; collaborators lose access once it's gone.

You need the gws binary installed and the ../gws-shared/SKILL.md file, which holds auth, global flags and security rules. Missing it? Run gws generate-skills. Worth installing if Keep is where your notes live and you want the agent touching them. For editing one note by hand, the web UI is faster.

What it helps with

  • create a Google Keep note without leaving the terminal
  • page through a long list of notes
  • download an attachment from a note
  • delete a note you own
  • check a method's schema before calling it

Example prompts for the agent

  • Create a Keep note titled "Sprint retro"
  • List my Keep notes and show the first page
  • Download the attachment on that note

How to install gws-keep

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-keep -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-keep/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-keep/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

marketing-plan coreyhaines31 Generates an AARRR-structured 12-month marketing plan with an audit score and a 90-day roadmap. Outputs a single Markdown document ready for Notion. Claude Code CX Codex Cursor +1 67,400installs prospecting coreyhaines31 The skill turns an ICP into a scored prospect list: sources candidates, checks emails, ranks accounts before outreach. Useful when you need a list you can actually send to. Claude Code CX Codex Cursor +1 64,800installs ultracave JuliusBrussee Compresses AI agent replies into short fragments while keeping code, commands, paths, and critical limits intact. Useful for terse coding sessions. Claude Code CX Codex Cursor +1 25,100installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. Claude Code 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. Claude Code 979,543installs

Questions about gws-keep

How do I install gws-keep in Claude?

Run npx skills add googleworkspace/cli --skill gws-keep -a claude-code. The skill lands in ~/.claude/skills/gws-keep/SKILL.md.

What does gws-keep do?

It gives the agent Google Keep commands through gws keep: create, get, list and delete notes, and download attachment media.

What does gws-keep need to run?

The gws binary and the ../gws-shared/SKILL.md file for auth and global flags. If that file is missing, run gws generate-skills.

Source text

SKILL.md · Apache-2.0 
---
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.

```bash
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:

```bash
# 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.

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor