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