Awesome Open Source
Awesome Open Source


Documentation Status Build Status Gitter chat Test Coverage

NOTICE: Google now offers an official API for Google Keep! 🎉

An unofficial client for the Google Keep API.

import gkeepapi

keep = gkeepapi.Keep()
success = keep.login('[email protected]', 'password')

note = keep.createNote('Todo', 'Eat breakfast')
note.pinned = True
note.color = gkeepapi.node.ColorValue.Red

gkeepapi is not supported nor endorsed by Google.

The code is pretty stable at this point, but you should always make backups. The project is under development, so feel free to open an issue if you have questions, see any bugs or have a feature request. PRs are welcome too!


pip install gkeepapi


The docs are available on Read the Docs.

Todo (Open an issue if you'd like to help!)

  • Reminders
    • reminders
  • Figure out all possible values for TaskAssist._suggest (Same as CategoryValue?)
  • Figure out all possible values for NodeImage._extraction_status (integer)
  • Blobs (Drawings/Images/Recordings)

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (1,123,251
Google Api (643
Related Projects