kindle-mcp

An MCP (Model Context Protocol) server that turns your Kindle highlights into structured personal book memory summaries saved directly to Notion.

Zero external AI API calls. All reasoning is performed by the host model (Claude Desktop) in its own context window. The server parses files, builds prompts, and writes to Notion — nothing else.

---

What it does

1. You share a Kindle highlight export file in Claude Desktop
2. Claude parses your highlights, generates a personal memory summary, and saves it to your Notion database
3. You get back a Notion page URL — nothing else shown in chat

All automatic. No copy-pasting. No manual steps.

---

Requirements

• Claude Desktop
• Notion account
• Node.js 18+ installed
• Notion MCP server running alongside this one (for first-run auto-setup)

---

Installation

1. Get a Notion API key

• Go to https://www.notion.so/my-integrations
• Click New integration → give it a name → click Submit
• Copy the Internal Integration Secret (starts with secret_...)

2. Add to Claude Desktop config

Open your Claude Desktop config file:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following inside "mcpServers":

"kindle-mcp": {
  "command": "npx",
  "args": ["-y", "kindle-mcp"],
  "env": {
    "NOTION_API_KEY": "secret_..."
  }
}

3. Restart Claude Desktop

Fully quit (Cmd+Q on Mac) and reopen. You should see the tools available via the hammer icon in the chat input.

---

First-time use

On first run, the server needs a Notion page to create the Kindle Book Summaries database under. If you also have the Notion MCP running, this happens automatically — Claude will create the page and database without asking you anything.

If you don't have the Notion MCP, create any page in Notion and connect your integration to it first:

1. Open a Notion page → click ... top right → Connections → select your integration

After the first run, the database ID is saved locally at ~/.kindle-mcp/config.json and never needs to be set up again.

---

Usage

In Claude Desktop:

1. Attach your Kindle export file (.html from the Kindle app, or My Clippings.txt from a Kindle device)
2. Say: "Use the process_kindle_export tool on this file"
3. Claude processes everything and returns your Notion page URL

---

Supported Kindle export formats

Format	How to get it
HTML	Kindle app (iOS/Android/Mac) → open book → Notes → Export
Plain text	My Clippings.txt on Kindle device via USB

Both formats are auto-detected — no configuration needed.

---

Summary output structure

Each book gets a Notion page with:

Field	Description
personal_thesis	One sentence capturing the core insight from your highlights
core_themes	3–5 recurring themes
key_ideas	5–8 distinct ideas drawn from your highlights
actionable_takeaways	3–5 concrete actions implied by your highlights
reflection_questions	3–5 questions your highlights raise
memory_capsule	A 3–4 sentence personal narrative distilling everything

Summaries are generated only from your highlights — the model uses no external knowledge about the book.

---

Tools

Tool	Description
process_kindle_export	Primary tool. Parses a Kindle file and orchestrates the full flow
initialize_notion_database	Creates the Notion database on first run (called automatically)
push_to_notion	Pushes a generated summary to Notion as a structured page
parse_kindle_clippings	Parses a Kindle file and returns raw highlights grouped by book
generate_personal_summary	Builds a prompt package for the host model to generate a summary

---

Notion database schema

The Kindle Book Summaries database is created automatically with:

Property	Type
Name	Title
Author	Rich Text
Title	Rich Text

All summary content (thesis, themes, ideas, etc.) is written as page body blocks.

---

License

MIT