Generated banner for Gws Keep
Generated logo for Gws Keep

Gws Keep

Google WorkspaceOfficialPublished by Google Workspace

  • Skill
  • Tool integration
  • Automation and integrations
  • Apache-2.0
  • No issues found

From the author

Manage Google Keep notes.
— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The gws-keep skill provides a command-line interface to interact with Google Keep. It allows users to perform CRUD operations on notes, manage permissions, and download media attachments directly from their terminal. The tool leverages the gws framework to execute API requests, requiring users to manage authentication and configuration through the shared gws environment.

What it does

  • Create new notes within Google Keep
  • Retrieve individual notes or list multiple notes
  • Delete existing notes permanently
  • Download media attachments from notes
  • Manage note permissions and access
  • Inspect API schemas for specific methods and parameters

When to use it

  • When you need to automate note creation or retrieval from the command line
  • When managing Google Keep data within a scripted workflow
  • When you need to extract media attachments from your notes programmatically

Advantages

  • Enables programmatic access to personal notes
  • Integrates Google Keep management into terminal-based workflows
  • Provides granular control over note resources and permissions

Usage examples

“Create a new note with the title 'Meeting Notes' and content 'Discuss project timeline'.”
The agent executes the gws keep notes create command with the specified parameters to add the note to your Google Keep account.
“List my recent notes.”
The agent calls the gws keep notes list command and displays the returned page of notes.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/googleworkspace/gws-keep/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip gws-keep.zip -d .agents/skills

Documentation by Google Workspace

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.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Google Workspace
Publisher
Google Workspace (Official)
Source
googleworkspace/cli · skills/gws-keep · commit cd3697e
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google Workspace.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download gws-keep.zip