Skip to content

kiwiz/gkeepapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Apr 13, 2024
d56a9e3 ยท Apr 13, 2024
May 23, 2023
Apr 13, 2024
Apr 13, 2024
Apr 13, 2024
Jan 22, 2024
Dec 26, 2019
Apr 5, 2023
Jan 1, 2024
Jan 4, 2024
Nov 5, 2017
Jan 22, 2024
Apr 13, 2024
Apr 13, 2024

Repository files navigation

gkeepapi

Documentation Status Gitter chat Test Coverage

NOTICE: Google offers an official API which might be an option if you have an Enterprise account. ๐ŸŽ‰

An unofficial client for the Google Keep API.

import gkeepapi

# Obtain a master token for your account (see docs)
master_token = '...'

keep = gkeepapi.Keep()
success = keep.authenticate('user@gmail.com', master_token)

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

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!

Installation

pip install gkeepapi

Documentation

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)