mcp-readwise

MCP-Server für Readwise, basierend auf FastMCP. Bietet 17 Tools für Highlights, Bücher, Tags, Reader-Dokumente und Massenexport.

Installation

uv sync

Oder mit pip:

pip install .

Related MCP server: Kiseki-Labs-Readwise-MCP

Konfiguration

Setzen Sie die folgenden Umgebungsvariablen:

Variable	Erforderlich	Standard	Beschreibung
`READWISE_TOKEN`	Ja	-	Readwise API-Zugriffstoken
`TRANSPORT`	Nein	`stdio`	Transportmodus: `stdio` oder `http`
`HOST`	Nein	`127.0.0.1`	HTTP-Server-Host
`PORT`	Nein	`8000`	HTTP-Server-Port
`MCP_API_KEY`	Nein	-	Bearer-Token für MCP Portal-Authentifizierung
`READWISE_BASE_URL`	Nein	`https://readwise.io`	Readwise API-Basis-URL

Sie erhalten Ihr Readwise-Zugriffstoken unter: https://readwise.io/access_token

Verwendung

Lokal (stdio)

READWISE_TOKEN=your_token uv run mcp-readwise

HTTP-Modus

READWISE_TOKEN=your_token TRANSPORT=http uv run mcp-readwise

Docker

cp .env.example .env  # Add your READWISE_TOKEN
docker compose up -d

Verfügbare Tools

Highlights

Tool	Beschreibung
`search_highlights`	Suche im semantischen, Volltext- oder Hybrid-Modus
`list_highlights`	Auflistung mit Filtern (Buch, Tag, Datum) und Paginierung
`get_highlight`	Abrufen nach ID mit Buch-Metadaten
`create_highlight`	Erstellen in einem Buch mit optionaler Notiz/Tags
`update_highlight`	Text oder Notiz aktualisieren
`delete_highlight`	Löschen nach ID
`export_highlights`	Massenexport mit Cursor-Paginierung

Bücher

Tool	Beschreibung
`list_books`	Auflistung mit Kategorie-/Quellen-/Anmerkungsfiltern
`get_book`	Abrufen nach ID

Reader

Tool	Beschreibung
`list_documents`	Reader-Dokumente mit Standort-/Kategoriefiltern auflisten
`get_document`	Abrufen nach ID mit vollständigem Inhalt
`save_url`	Eine URL im Reader speichern
`update_progress`	Lesefortschritt aktualisieren (0.0-1.0)

Projektstruktur

mcp_readwise/
  server.py      # FastMCP app, tool registration, entry point
  config.py      # pydantic-settings configuration
  client.py      # Centralized httpx client (auth, retries, rate limits)
  auth.py        # Bearer token verifier for MCP Portal
  models/        # Pydantic response models
  tools/         # Tool functions by domain

Bereitstellung

Bereitgestellt über Komodo auf ubuntu-smurf-mirror, erreichbar über das Cloudflare MCP Portal unter mcp-readwise.cdit-dev.de.

Lizenz

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Tool	Beschreibung
`list_tags`	Alle Tags auflisten
`create_tag`	Einen neuen Tag erstellen
`delete_tag`	Löschen nach ID
`tag_highlight`	Einen Tag zu einem Highlight hinzufügen oder entfernen

Readwise MCP HTTP Server