Power GWS Keep

Manage Google Keep notes, lists, and reminders programmatically from the command line.

When to Use This Command

Run this command when you need to:

• Create, update, or search Google Keep notes and checklists from your terminal or automation scripts
• Sync notes between Keep and other systems like project management tools or documentation platforms
• Bulk manage Keep content: archive old notes, export for backup, or tag organization

Consider alternatives when:

• You need rich formatting with images, drawings, and voice notes which require the Keep mobile or web app
• You are managing a small number of notes where the Keep app interface is faster and more intuitive

Quick Start

Configuration

Copy
name: power-gws-keep
type: command
category: google-workspace

Example Invocation

Copy
claude command:run power-gws-keep --action create --title "Sprint 14 Tasks" --type checklist --items "Review PRs,Update docs,Deploy staging"

Example Output

Creating Google Keep note...
  Type: checklist
  Title: Sprint 14 Tasks

Note created successfully.
  Note ID: note_8f2a1b3c
  Items:
    [ ] Review PRs
    [ ] Update docs
    [ ] Deploy staging

  Labels: none
  Pinned: no
  Color: default

Link: https://keep.google.com/#NOTE/note_8f2a1b3c

Core Concepts

Keep Operations Overview

Aspect	Details
Notes	Create, read, update, delete text notes with titles and body content
Checklists	Manage checklist items: add, remove, check, uncheck, reorder
Labels	Organize notes with labels: create, assign, remove, list by label
Reminders	Set time-based or location-based reminders on notes
Archive	Archive completed notes and manage archived note retrieval

Note Management Workflow

Create or Search Note
        |
        v
Modify Content
  |       |        |
  v       v        v
Text   Checklist  Labels
  |       |        |
  v       v        v
Set Reminder (optional)
        |
        v
Pin or Archive
        |
        v
Sync Across Devices

Configuration

Parameter	Type	Default	Description
action	string	(required)	Operation: create, update, search, archive, export
title	string	(none)	Note title for create or search operations
type	string	note	Note type: note or checklist
items	string	(none)	Comma-separated checklist items for checklist type
label	string	(none)	Label to assign or filter by

Best Practices

1. Use labels for organization - Create a consistent label taxonomy like "work", "personal", "ideas", "follow-up" to keep notes organized and searchable across devices.

2. Convert completed checklists to archive - Once all items in a checklist are checked, archive the note to keep your active notes clean while preserving the record.

3. Set reminders for action items - Notes without reminders often get forgotten. Attach a time-based reminder to any note that requires follow-up action.

4. Export notes regularly - Google Keep does not have built-in export functionality. Use the export action periodically to back up your notes to local files in case of data loss.

5. Use pinning sparingly - Pinned notes stay at the top of your Keep interface. Pin only truly important active notes; too many pinned notes defeat the purpose of prioritization.

Common Issues

1. Keep API access limited - The Google Keep API has restricted access. Ensure your Google Cloud project has the Keep API enabled and your service account has the necessary permissions.

2. Checklist items not syncing - Changes made through the API may take a few seconds to appear in the Keep app. Force a sync by opening the Keep app or refreshing the web interface.

3. Search returns too many results - Keep search is full-text across all notes. Use label filters combined with text search to narrow results to a manageable set. Apply date-based filters when looking for recently created notes.

4. Note color and formatting not preserved - The Keep API supports a limited set of formatting options compared to the mobile and web apps. Notes created via the API may appear without custom colors or background images. Apply colors explicitly using the color parameter for important notes.

5. Reminder timezone incorrect - Time-based reminders use the timezone specified in your Google account settings. If reminders trigger at unexpected times, verify your account timezone matches your actual location by checking Google Account preferences.