Skip to content

tuliosousapro/Kindle-To-Notion-Extension

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

400 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Kindle To Notion Extension Banner

Kindle To Notion Extension v1.9.2

Export Kindle highlights to Notion with automatic chapter grouping, Notion OAuth integration, and page references

Don't just clone it! Gives a star if it helped you...

Kindle2notion extension - An extension easy save your kindle highlights into Notion | Product Hunt

Follow and Upvote us on Product Hunt


Have you ever used a Kindle to read your books? Have you ever tried to work on your notes? Maybe tried to organize for further reference?

Well, I have. And it happens to be the most boring task in the world. Copy and pasting just sucks. It's time-consuming and definitely gives you more work than organization.

Kindle To Notion was created to solve your note-taking problems.

It's your ultimate tool for organizing reading insights. It exports highlights and notes from your Kindle notebook pages directly to your Notion database. With just a few clicks, it extracts book titles, authors, cover images, and colored annotations.

๐Ÿง™โ€โ™‚๏ธYOU... SHALL TAKE NOTES!!!โญ


โšกQuick Installation

Get it from the Chrome Web Store for Chrome, Brave, Arc, Orion, and other Chromium-based browsers.

Chrome Extension Badge

Get it from Edge Add-ons for Edge LoL โ†’ Who cares? Just use Chrome Web Store.

Edge Extension Badge

By the way, I do use Edge :)

Get it from the Mozilla Add-ons

Mozilla Extension Badge

๐Ÿง  Clone our Free Notion Template

To make the most of your Kindle highlights, use this free Notion template built by Us:

๐Ÿ‘‰ Click here and clone it

This template helps you:

  • Organize your books and highlights
  • Track reading progress
  • Capture insights and tasks from your reading

Preview of Notion Template


๐Ÿ› ๏ธInstallation

  1. Clone or download this repository.
  2. Open Chrome and navigate to chrome://extensions/.
  3. Enable "Developer mode" (top right).
  4. Click "Load unpacked" and select the folder containing the extension files.
  5. Voilร  โ€” The extension will appear in your Chrome toolbar.

๐Ÿ’ก Prefer a one-click install? Get it from the Chrome Web Store for Chrome, Brave, Arc, Orion, and other Chromium-based browsers.

โš™๏ธManual Setup

  1. Create a Notion integration:

    • Go to Notion's Integrations page.
    • Create a new integration and copy the "Internal Integration Token."
    • Share your target database with the integration (via the database's "Share" menu).
  2. Create or open your Notion database:

    • Go to Notion, create or select your destination page.
    • Certify that you have a database with at least the properties for Author and Book Title.
    • Open your database as a page and copy the Notion database ID
      • Database Link: https://www.notion.so/f7979b5axerequinha2f8fa?v=796edexemplokabal79a096
      • Database Id: f7979b5axerequinha2f8fa
  3. Open the extension's pop-up (click the extension icon in Chrome).

  4. Enter:

    • Notion API Token: Your integration token. (e.g.,ย ntn_300224xerequinhadepilada7Xm).
    • Notion Database ID: Found in the database URL (e.g., f7979b5axerequinha2f8fa).
    • Title Property Name: The exact name of your database's title property (e.g., Tรญtulo do Livro).
    • Author Property Name: The exact name of your database's author property (e.g., Autor).
    • Kindle Region: Select your Amazon region (e.g., US, UK, Canada, Germany, etc.).
  5. Click "Save Settings."๐ŸŽ‰

๐Ÿ‘‰Need a step-by-step help? FULL DOCUMENTATION

๐Ÿ“ฝ๏ธ Tutorial - How to setup and use Kindle to Notion Extension

Kindle To Notion โ€“ Watch Video

Watch the video to learn:

  • How to set up the extension
  • How to connect your Notion database
  • How to export your Kindle highlights

๐Ÿš€Getting Started

  1. Open the extension popup and click "Go to Highlights"
  • Alternatively, navigate to your region's Kindle notebook page (see supported regions below).

  1. Once in the highlights page, open the extension popup and click "Export to Notion."
  2. Check the status message in the pop-up for success or errors.
  3. Verify the new page in your Notion database.

Supported Kindle Regions

Country URL
๐Ÿ‡ฆ๐Ÿ‡บ Australia read.amazon.com.au/notebook
๐Ÿ‡ง๐Ÿ‡ท Brazil ler.amazon.com.br/notebook
๐Ÿ‡จ๐Ÿ‡ฆ Canada read.amazon.ca/notebook
๐Ÿ‡ซ๐Ÿ‡ท France read.amazon.fr/notebook
๐Ÿ‡ฉ๐Ÿ‡ช Germany read.amazon.de/notebook
๐Ÿ‡ฎ๐Ÿ‡ณ India read.amazon.in/notebook
๐Ÿ‡ฎ๐Ÿ‡น Italy read.amazon.it/notebook
๐Ÿ‡ฏ๐Ÿ‡ต Japan read.amazon.co.jp/notebook
๐Ÿ‡ฒ๐Ÿ‡ฝ Mexico read.amazon.com.mx/notebook
๐Ÿ‡ช๐Ÿ‡ธ Spain read.amazon.es/notebook
๐Ÿ‡ฌ๐Ÿ‡ง United Kingdom read.amazon.co.uk/notebook
๐Ÿ‡บ๐Ÿ‡ธ United States read.amazon.com/notebook

Note: You can select your preferred region in the extension's Settings tab.


๐Ÿง™โ€โ™‚๏ธFeatures

### โœจ v1.9.2 - Smart Feedback & Refinement

โญ Extension Feedback System:

  • Integrated a smart engagement engine with review prompts based on activity and a persistent feedback footer.

๐Ÿ“‘ Starred Highlights Browsing:

  • Dedicated view in the review tab to navigate favorited highlights with next/previous controls.

๐Ÿ” Reliability & Performance:

  • Dynamic Rate-Limiting: Replaced hardcoded delays with an intelligent mechanism for smoother batch exports.
  • Network Timeouts: Implemented AbortController timeouts for all requests to prevent hanging on slow connections.

๐ŸŽจ Polished Experience:

  • Major Landing Page overhaul with scroll animations, FAQ accordion, and glassmorphism enhancements.
  • Precise UI/UX refinements across popup and onboarding screens.
### โœจ v1.9.0 - Batch Export Power

๐Ÿ“ฆ One-Click Batch Export:

  • Export your entire Kindle library to Notion in a single operation from the notebook list page.

๐Ÿ“Š Real-time Progress Dashboard:

  • Live tracking of export progress with success/failure counters and cancel functionality.
### โœจ v1.8.0 - Major New Features

๐Ÿ” Notion OAuth Integration:

  • Connect to Notion seamlessly with one click, without needing to manually copy and paste integration tokens.

๐Ÿš€ Enhanced Onboarding:

  • New step-by-step onboarding experience to guide users through the initial setup securely.

๐ŸŒ Global & Cross-Browser:

  • Comprehensive multi-language support (i18n) and native extensions for Chrome, Edge, and Firefox.
### โœจ v1.7.0 - Major New Features

๐Ÿง  Intelligent Organization:

  • Automatically groups highlights by Chapter and extracts Bookmarks (๐Ÿ“Œ) with precise page/location references.

๐Ÿ“– Deep Kindle Integration:

  • Full support for all 12 regional domains. Extracts highlights (with color mapping), notes, ASIN links, and high-resolution book covers.

โšก Notion Sync:

  • 1-click export using quote blocks. Includes summary counts, custom property mapping, and smart de-duplication to prevent clutter.

๐Ÿ“ Precision Tracking:

  • A 5-tier location detection system ensures every highlight includes its exact page or position, supporting multiple languages.

๐Ÿ›ก๏ธ Security & Privacy:

  • Zero data collection. Your Notion API token is stored securely via chrome.storage.local and never leaves your device.

๐ŸŽจ UI/UX:

  • accessible (WCAG 2.1) compliant UI for accessibility. Smooth transitions, toast notifications, and a streamlined workflow.

THE NERD ZONE AKA DEVELOPERS AND AFFICIONADOS

Come One Of Us


๐ŸงชDevelopment

  • File Structure:
Kindle-To-Notion-Extension/
โ”œโ”€โ”€ source/                    # Main extension source code
โ”‚   โ”œโ”€โ”€ chrome/               # Chrome extension (primary)
โ”‚   โ”œโ”€โ”€ edge/                 # Edge extension
โ”‚   โ””โ”€โ”€ mozilla/              # Firefox extension
โ”œโ”€โ”€ docs/                     # Static marketing website
โ”œโ”€โ”€ gitbook/                  # Technical documentation
โ”œโ”€โ”€ assets/                   # Marketing images
โ”œโ”€โ”€ release notes/            # Version history
โ””โ”€โ”€ .github/                  # GitHub templates & config
  • Dependencies: None (no external libraries, No build process required - it's vanilla JavaScript!)
  • Debugging:
    • Open Chrome's developer tools (F12) on the Kindle page for content script logs.
    • Inspect the background page (Right-click extension icon > "Manage Extensions" > "Inspect views: background page") for API logs.

๐ŸคContributing

Roadmap

We welcome contributions to improve this extension! To contribute:

  1. Fork this repository.
  2. Create a new branch (git checkout -b feature/your-feature).
  3. Make your changes and commit (git commit -m "Add your feature").
  4. Push to your branch (git push origin feature/your-feature).
  5. Open a pull request with a clear description of your changes.

Please ensure your code follows:

  • JavaScript ES6+ standards.
  • Chrome's Content Security Policy (no inline scripts).
  • Clear commit messages and documentation.

Contributors

๐Ÿ‘พIssues

Found a bug or have a feature idea? Open an issue right here in this repo.

GitHub Issues or Pull Requests Open an Issue Request Feature Good First Issues

Common Issues

Issue Solution
"Not on Kindle page" Navigate to your Kindle notebook first
"Invalid token" Check your Notion integration token
"Database not found" Verify database ID and sharing permissions
"No highlights found" Ensure the page has loaded completely
"Connection failed" Use the "Test" button to diagnose issues

๐Ÿ”’ Privacy & Security

  • โœ… Local processing - No data sent to third parties
  • โœ… Encrypted storage - Notion token stored securely
  • โœ… Minimal permissions - Only accesses Kindle and Notion
  • โœ… HTTPS only - Secure communication
  • โœ… No tracking - Zero analytics or data collection

๐ŸŽˆFAQ

๐Ÿ’ก Curious how it works or have questions?


๐Ÿง™Kindle wizardry deserves a star

Smash that star button โ€” it costs you nothing and means the world to this humble repo. Hit that โญ and summon a tweet, post, and shout for your friends.


๐Ÿ”License

This project is licensed under the MIT License. See the LICENSE file for details.

Since 2025 | Tรบlio Sousa