Skip to main content

Package description

Project description

Google Keep Cli

Work with Google Keep on your terminal. To install this module:

pip install gkeep

Create a file with your Google credentials called auth.txt in the current directory:

<username> <password>

For example:

nekmo mypassword1234

You can also use the --auth parameter to set the path to the file with the credentials:

gkeep --auth /path/to/auth.txt


Notes can have multiple items with checkboxes. The common parameters for the items are:

  • <note id>: note identificator. For example, 75e4202b0c1.9fc0b868a7b34952. You can obtain the identifier using the web version of Google Keep. Click on the note and look at the url. Example: .com/#NOTE/75e4202b0c1.9fc0b868a7b34952.
  • <item name>: value of the element. For exemple, Milk.
  • --check/--uncheck: Item is checked or not.

Add item on note

This command allows you to add items to an existing note. By default if the element already exists, it is not duplicated. If you want duplicate the element, use the --duplicate parameter. If the element does not exist, by default it is unchecked.

gkeep add-item <note id> "<item name>"[ --check/--uncheck][ --duplicate/no-duplicate]

For example:

gkeep add-item 75e4202b0c1.9fc0b868a7b34952 "Chip cookies" --check

Edit item on note

Modify an existing entry. It allows to change if it is checked and the text.

gkeep edit-item <note id> "<item name>"[ --check/--uncheck][ --new-text <new text>]


gkeep edit-item 75e4202b0c1.9fc0b868a7b34952 "Chip cookies" --uncheck
gkeep edit-item 75e4202b0c1.9fc0b868a7b34952 "Chip cookies"
                  --new-text "Chocolate orange cookies"

Delete item on note

Delete an existing entry.

gkeep delete-item <note id> "<item name>"


gkeep delete-item 75e4202b0c1.9fc0b868a7b34952 "Chip cookies"

Is checked item on note

Returns True if the element is checked. If it is unchecked, it returns False.

gkeep delete-item <note id> "<item name>"


gkeep delete-item 75e4202b0c1.9fc0b868a7b34952 "Chip cookies"


This module is a command-line interface of the module gkeepapi. Thanks to Kiwiz for maintaining the module.

This module does not use an official Google API to work with Google Keep. As this module does not use an official API, its operation is not guaranteed for a production environment.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
gkeep-0.1.2.tar.gz (7.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page