Gws Keep
- 30.2k installs
- 30.2k repo stars
- Updated August 1, 2026
- googleworkspace/cli
gws is a CLI that exposes all Google Workspace APIs (Gmail, Drive, Calendar, Sheets, Chat, Keep) with structured JSON output and agent skills.
About
gws is a unified CLI for all Google Workspace APIs (Gmail, Drive, Calendar, Sheets, Chat, Keep) built for humans and AI agents. It dynamically reads Google's Discovery Service to auto-generate the command surface, so it stays current as Google adds new endpoints. Every response is structured JSON, making it natural to pair with agent skills included in the distribution.
- Dynamic API surface reads Google Discovery Service at runtime - auto-updates as Google adds endpoints
- 40+ included agent skills pair with LLMs to manage Gmail, Drive, Calendar, Sheets, Keep without custom tooling
- Structured JSON output and --dry-run preview for both humans and AI agents
Gws Keep by the numbers
- 30,215 all-time installs (skills.sh)
- +502 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #28 of 688 Office & Documents skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
gws-keep capabilities & compatibility
- Works with
- gmail · google drive
- Use cases
- orchestration
npx skills add https://github.com/googleworkspace/cli --skill gws-keepAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 30.2k |
|---|---|
| repo stars | ★ 30.2k |
| Security audit | 3 / 3 scanners passed |
| Last updated | August 1, 2026 |
| Repository | googleworkspace/cli ↗ |
How do you manage Google Keep notes from the CLI?
CLI access to Google Workspace (Gmail, Drive, Calendar, Sheets, Keep) with structured JSON for agent automation.
Who is it for?
Developers using the Google Workspace gws CLI who want agent-driven Google Keep note CRUD and attachment downloads from the terminal.
Skip if: Developers without gws CLI installed, teams using Notion or Obsidian instead of Google Keep, or workflows needing Google Docs or Sheets management.
When should I use this skill?
The user wants to create, read, update, delete Google Keep notes or download Keep attachments via gws CLI in terminal or agent workflows.
What you get
Created or updated Keep notes, listed note metadata, and downloaded attachment media files via gws keep commands.
- Keep note records
- updated note content
- downloaded attachment media
By the numbers
- Published as version 0.22.5 in googleworkspace/cli
- Requires gws binary per openclaw metadata
Files
keep (v1)
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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 theOWNERrole 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 withpage_sizeas the upper bound of returned items. Apage_sizeof zero allows the server to choose the upper bound. The ListNotesResponse contains at mostpage_sizeentries. If there are more things left to list, it provides anext_page_tokenvalue. (Page tokens are opaque values.) To get the next page of results, copy the result'snext_page_tokeninto the next request'spage_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
Lark DocGenerate, update, and maintain structured documentation directly inside Lark/Feishu using natural language and agentic workflows.494kLark DriveLet their coding agents read, create, update and search documents stored in Lark (Feishu) Drive directly from prompts.493kLark SheetsConnect Claude, Cursor or other agents directly to Feishu/Lark spreadsheets for live data reads, writes, and structured automation.493kLark WikiGenerate, update, and sync structured knowledge bases inside Lark (Feishu) directly from code, specs, or agent output.493kLark WhiteboardGenerate, edit, and collaborate on visual diagrams and flowcharts directly inside Claude, Cursor or other agents.493kLark SlidesInstantly generate polished, professional slide decks from specs, roadmaps, or meeting notes using Lark/Feishu.493kForks & variants (1)
Gws Keep has 1 known copy in the catalog totaling 7 installs. They canonicalize to this original listing.
- jetbrains - 7 installs
How it compares
Use gws-keep for Google Keep note automation; use other gws skills for Docs, Sheets, or Drive resources.
FAQ
What commands does gws-keep support?
gws-keep documents gws keep commands for notes create, list, get, update, and delete, plus media download for attachments. Version 0.22.5 follows gws keep <resource> <method> [flags] with help via gws keep --help.
What does gws-keep require before running?
gws-keep requires the gws binary installed and authentication configured per gws-shared/SKILL.md from googleworkspace/cli. Run gws generate-skills if the shared skill file is missing.
Is Gws Keep safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.