Kindle Highlights → Obsidian Sync

Automatically sync Kindle highlights into your Obsidian vault as formatted markdown, with chapter grouping and full customization.

Quick Start

1. Deploy Infrastructure

cd infra
cp terraform.tfvars.example terraform.tfvars
# Edit terraform.tfvars with your settings
terraform init
terraform apply

2. Install the Bookmarklet

Copy the contents of web/bookmarklet.js, create a new browser bookmark, and paste as the URL. Update the API_URL and API_KEY constants with your deployed values (from terraform output).

3. Extract Highlights

1. Go to read.amazon.com/notebook
2. Select a book
3. Click the bookmarklet
4. Highlights are sent to your backend

4. Set Up Local Agent

cd agent
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp config.yaml.example config.yaml
# Edit config.yaml with your API URL, key, and vault path
python sync_agent.py

5. Run as Daemon (optional)

cd agent
./install.sh

File Upload (Phase 2)

For sideloaded books, upload My Clippings.txt via the web UI or use the auto-mount detection.

Configuration

See agent/config.yaml for all options. The markdown template is fully customizable via Jinja2 (agent/templates/default.md.j2).

Architecture

See ARCHITECTURE.md for full system design.