Google Keep to Joplin Importer – README

Overview

This guide explains how to export your notes from Google Keep and import them into Joplin using the Google Keep to Joplin Importer plugin. Follow each step for a smooth migration, including handling attachments and tags.

1. Export Your Notes from Google Keep

  A. Use Google Takeout

1. Go to Google Takeout.
2. Under “Select data to include,” click Deselect all.
3. Scroll down and check Keep.
4. Click Next step at the bottom.
5. Choose your export options (default settings are fine).
6. Click Create export.
7. Wait for the export to complete. You’ll receive a download link via email or on the Takeout page.
8. Download the exported .zip file to your computer.

  B. Unzip the Takeout Archive

1. Locate the downloaded .zip file (e.g., takeout-YYYYMMDD.zip).
2. Extract it. Inside, you’ll find a folder named Takeout, and within it, a Keep folder.
3. The Keep folder contains:

• One .json file per note
• One .html file per note
• Image and attachment files (if present)

2. Prepare for Import

• Ensure all your Keep note files are accessible on your computer.
• If you plan to import attachments, keep them in the same folder as their corresponding .json files.

3. Install Joplin and the Importer Plugin

  A. Install Joplin

• Download Joplin from joplinapp.org.
• Install and open Joplin.

  B. Install the Google Keep to Joplin Importer Plugin

• Download or build the plugin .jpl file.
• In Joplin, go to Joplin > Preferences > Plugins (macOS) or Tools > Options > Plugins (Windows/Linux).
• Click the gear icon and choose Install from file.
• Select the .jpl plugin file.
• Restart Joplin when prompted.

4. Import Your Google Keep Notes into Joplin

  A. Start the Import Process

1. In Joplin, go to the Tools menu and select Import Google Keep Notes (or use the Command Palette and search for the command).
2. A dialog will appear asking you to select your Google Keep .json files.

• Navigate to the extracted Keep folder.
• Select one or more .json files to import (use Shift or Cmd/Ctrl to select multiple files).

  B. Complete the Import

• The plugin will process each .json file:
• The note’s title and body are imported.
• Labels (if present) are imported as tags.
• Attachments (if present and in the same folder) are imported and embedded in the note.
• When finished, a message will confirm how many notes were imported.

5. After Import

• Review your imported notes in Joplin.
• Check that attachments and tags have been imported as expected.
• If some notes or attachments are missing, ensure the files were selected and in the correct location, then try importing again.

Troubleshooting:

| Issue | Solution | |------------------------------|--------------------------------------------------------------------------| | No notes imported | Check that you selected the correct .json files and their structure. | | Attachments not imported | Confirm attachments are in the same folder as their .json files. | | Tags missing | Only notes with labels fields will have tags imported. | | Plugin not appearing | Make sure you installed from file and restarted Joplin. | | Errors during import | Open Help > Toggle Development Tools > Console in Joplin for logs. |

Sources

Notes

•	The plugin uses the `title`, `textContent`, `labels`, and `attachments` fields from each Keep JSON file.
•	For best results, use the latest version of both Joplin and this plugin.
•	For support or to report issues, visit the Joplin Forum.

Enjoy your notes in Joplin!