This script lets you scrape and convert Google Keep notes into sensible, reusable file formats, such as JSON and CSV.
Installation:
- Install Node.js on your machine
- Run
npm install -g google-keep-converter - Get your Google Keep data via Google Takeout -- there is no other way for now -- and extract the folder.
- Run the script somewhere within that folder structure.
This script first checks if the subdirectories ./Takeout/Keep/ or ./Keep/ exist, and prefers them if so. The output is saved to keep-notes-[timestring].json: to the current dir, in chronological order, UTF8-encoded, with \n linebreaks.
google-keep-converter [options]
| Command | Description |
|---|---|
| -h, --help | output usage information |
| -f, --fix | fix naming of HTML files (workaround for Google Takeout bug) |
| -c, --csv | save to keep-notes-[timestring].csv (in addition to JSON) |
If you have a bunch of files without proper file extension in your Keep folder, you have run into a Google Takeout bug: It seems that if a note title ends in a period and digit (e.g. "Ideas for Industry 5.0"), the filename is truncated.
Use the --fix option to give those files an ".html" extension, to be properly processed by this script.