Skip to main content

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)

Release files for gkeepapi 0.17.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for gkeepapi 0.17.1
File Interpreter ABI Platform
gkeepapi-0.17.1-py3-none-any.whl Python 3 none any Details

Release files / gkeepapi-0.17.1-py3-none-any.whl

Download URL gkeepapi-0.17.1-py3-none-any.whl
Size 23.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8e242bc745640c809d21eb3f95c7182ac340a8cc2b84e5d78b9d692c2c2d35dc
BLAKE2b-256 checksum
How to use checksums
8861f33bb386feb726ed98560ca8b69b589a95095b4090ba32dab43e62c385e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release history Release notifications | RSS feed

This release

0.17.1 This release

1 release file

0.17.0

1 release file

0.16.0

1 release file

0.15.1

1 release file

0.15.0

1 release file

0.14.2

1 release file

0.14.1

1 release file

0.14.0

1 release file

0.13.7

1 release file

0.13.6

1 release file

0.13.5

1 release file

0.13.4

1 release file

0.13.3

1 release file

0.13.2

1 release file

0.13.1

1 release file

0.13.0

1 release file

0.12.2

1 release file

0.12.1

1 release file

0.12.0

1 release file

0.11.15

1 release file

0.11.13

1 release file

0.11.12

1 release file

0.11.11

1 release file

0.11.9

1 release file

0.11.8

1 release file

0.11.7

1 release file

0.11.6

1 release file

0.11.5

1 release file

0.11.4

1 release file

0.11.3

1 release file

0.11.2

1 release file

0.11.1

1 release file

0.11.0

1 release file

0.10.10

1 release file

0.10.9

1 release file

0.10.8

1 release file

0.10.7

1 release file

0.10.6

1 release file

0.10.5

1 release file

0.10.4

1 release file

0.10.3

1 release file

0.10.2

1 release file

0.10.1

1 release file

0.10.0

1 release file

0.9.8

1 release file

0.9.7

1 release file

0.9.6

1 release file

0.9.5

1 release file

0.9.4

1 release file

0.9.3

1 release file

0.9.2

1 release file

0.9.1

1 release file

0.9.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page