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#

bash

# 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.

bash

uvx zlibrary2kindle login
# or after install: z2k login

zlibrary_search#

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

bash

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).

bash

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.

bash

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#

bash

# 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#

VariableDescriptionZLIBRARY_EMAILZLibrary account emailZLIBRARY_PASSWORDZLibrary account passwordKINDLE_EMAILTarget Kindle email addressSENDER_EMAILSMTP sender emailSENDER_PASSWORDSMTP password or Gmail App PasswordSMTP_HOSTSMTP server (default: smtp.gmail.com)SMTP_PORTSMTP port (default: 587)