Google Keep Transfer

A Python script based on gkeepapi for transferring Google Keep notes from one account to another.

Requirements

• Python 3.10 or higher
• A Google account master token (see Authentication section below)

Setup

1. Download your notes via Google Takeout:

   • Visit https://takeout.google.com/settings/takeout
   • Be sure you have the right account selected (click avatar in the upper right of the page to change accounts)
   • Select the checkbox for Google Keep
   • Scroll to the bottom of the page and click "Next step"
   • Choose ".zip" for file type, then click "Create export"
   • When your export is complete, download the zip and extract its contents to a directory

2. Obtain a master token for the destination account:

   The gkeepapi library requires a master token for authentication. Password-based login is no longer supported by Google.

   To obtain your master token, you can use the following Docker command:

   docker run --rm -it --entrypoint /bin/sh python:3 -c \
     'pip install gpsoauth && python3 -c "print(__import__(\"gpsoauth\").exchange_token(input(\"Email: \"), input(\"OAuth Token: \"), input(\"Android ID: \")))"'

   For detailed instructions, see the gkeepapi documentation.

   Important: Store your master token securely - treat it like a password!

Installation & Running

1. Download/clone this repo:

   git clone https://github.com/yourusername/google_keep_notes_transfer.git
   cd google_keep_notes_transfer

2. Create and activate a virtual environment:

   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Run the script and follow the prompts:

   python main.py

Notes

• Attachments: Attachments are not supported by gkeepapi. Notes with attachments will be logged so you can manually reattach them using the files from your Takeout export.
• Security: Never share your master token. It provides full access to your Google account.
• API Limitations: gkeepapi is an unofficial library and may break if Google changes their API.

License

See LICENSE file.