ZLibrary2Kindle

Search Z-Library for books, download (EPUB preferred), and send to your Kindle via email.

Prerequisites

1. ZLibrary account — email and password
2. Kindle email whitelisted — Add sender in Amazon account settings
3. Gmail App Password — Required for Gmail SMTP with 2FA

Setup

# Simplest — no install needed
uvx zlibrary2kindle --help

# Or install locally
pip install zlibrary2kindle
z2k --help

# Set environment variables
export ZLIBRARY_EMAIL="your@email.com"
export ZLIBRARY_PASSWORD="your-password"
export KINDLE_EMAIL="your-name@kindle.com"
export SENDER_EMAIL="your@email.com"
export SENDER_PASSWORD="xxxx xxxx xxxx xxxx"  # Gmail App Password

Tools

zlibrary_login

Authenticate to ZLibrary. Session cookies are saved to ~/.cache/zlibrary2kindle/session.json and reused automatically.

uvx zlibrary2kindle login
# or after install: z2k login

zlibrary_search

Search for books by title, author, ISBN, etc.

uvx zlibrary2kindle search "Python programming"
# or after install: z2k search "随园食单" --limit 5

Returns: list of books with book_id for use in download.

zlibrary_download

Download a book by its book_id (from search results).

uvx zlibrary2kindle download w8n2rz2N8Q
# or after install: z2k download <book_id>

Files saved to /tmp/zlibrary2kindle/downloads/.

kindle_send_email

Send a downloaded book to your Kindle.

uvx zlibrary2kindle send /path/to/book.epub "Book Title"
# or after install: z2k send /path/to/book.epub "Book Title" --to your@kindle.com

File is deleted after sending.

Quick workflow

# 1. Login (once)
uvx zlibrary2kindle login

# 2. Search
uvx zlibrary2kindle search "随园食单"
# → [z9lRkJxQ8y] 随园食单 | [清]袁枚

# 3. Download
uvx zlibrary2kindle download z9lRkJxQ8y

# 4. Send to Kindle
uvx zlibrary2kindle send /tmp/zlibrary2kindle/downloads/随园食单.epub "随园食单"

MCP Mode

When Claude Code has this project's MCP server loaded, tools are available directly: zlibrary_login, zlibrary_search, zlibrary_download, kindle_send_email.

Configuration

Variable	Description
ZLIBRARY_EMAIL	ZLibrary account email
ZLIBRARY_PASSWORD	ZLibrary account password
KINDLE_EMAIL	Target Kindle email address
SENDER_EMAIL	SMTP sender email
SENDER_PASSWORD	SMTP password or Gmail App Password
SMTP_HOST	SMTP server (default: smtp.gmail.com)
SMTP_PORT	SMTP port (default: 587)