gws-keep

Manage Google Keep notes through the gws CLI and Keep API.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-keep-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-keep
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-keep
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-keep-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google Keep notes programmatically requires learning the Keep API's resources, methods, and pagination rules, which slows down automation and scripting work. ## Core Features & Use Cases - Note Management: Create, read, list, and delete Google Keep notes via the gws keep command line. - Attachment Downloads: Retrieve note attachments using the media download method with the alt=media parameter. - Schema Discovery: Inspect any method's required parameters, types, and defaults with gws schema before building requests. - Use Case: A user wants to back up all their Keep notes. They list notes with pagination via page_token, then download each note's attachments for local archival. ## Quick Start Ask the assistant to list your Google Keep notes using the gws keep notes list command.

Frequently Asked Questions about gws-keep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list all my Google Keep notes from the command line?

Run gws keep notes list to retrieve a page of notes. If the response includes a next_page_token, pass it as page_token in the next request to continue paginating through all results.

How do I create a Google Keep note programmatically?

Use gws keep notes create with the appropriate --params or --json flags. First run gws schema keep.notes.create to inspect the required parameters, types, and defaults before building your request.

Can I download attachments from Google Keep notes?

Yes, use the media download method with the alt=media query parameter. The API returns a 400 error if the attachment media is not available in the requested MIME type.

What permissions are needed to delete a Google Keep note?

The caller must have the OWNER role on the note to delete it. Deletion is immediate and irreversible, and all collaborators lose access to the note.

Why does gws keep fail with authentication errors?

The skill requires the gws-shared skill for authentication and global configuration. If it is missing, run gws generate-skills to create it, then verify your credentials are set up correctly.