ZLibrary2KindleSkill

Search Z-Library books and send them to your Kindle via email. Supports both CLI and Claude Code MCP mode.

Features:

• Search Z-Library by title, author, ISBN
• Download books (EPUB preferred, PDF fallback)
• Send directly to Kindle email
• Session cookies persisted — login once, reuse automatically
• Two-factor auth supported via app password

Language: English | 中文

Prerequisites

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

Setup

1. Install

Simplest — no install needed:

uvx zlibrary2kindle --help

Or install locally:

pip install zlibrary2kindle
z2k --help

2. Configure credentials

Method A — ~/.zshrc (recommended)

Add to ~/.zshrc:

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

Then source ~/.zshrc.

Method B — mcp.json env

Edit mcp.json and fill in the env block.

Security: Method A keeps credentials out of your project directory. Method B stores them in plaintext.

Step-by-Step Guide

• Beginner Guide (English)
• 傻瓜指南（中文）

Quick Start

# 1. Login (once) — use uvx directly
uvx zlibrary2kindle login

# 2. Search
uvx zlibrary2kindle search "Harry Potter"

# 3. Download (copy book_id from search results)
uvx zlibrary2kindle download <book_id>

# 4. Send to Kindle
uvx zlibrary2kindle send /tmp/zlibrary2kindle/downloads/book.epub "Book Title"

Or after local install:

z2k login
z2k search "Harry Potter"
z2k download <book_id>
z2k send /path/to/book.epub "Book Title"

CLI Reference

Command	Description
uvx zlibrary2kindle login	Authenticate to ZLibrary. Session is saved automatically.
uvx zlibrary2kindle search "query" --limit 10	Search books. Returns [book_id] title | author.
uvx zlibrary2kindle download <book_id>	Download book to /tmp/zlibrary2kindle/downloads/.
uvx zlibrary2kindle send <file> "Title"	Email file to Kindle.

MCP Integrations

Load as a local MCP server for AI-assisted book search and sending. Works with Claude Code, Cursor, and OpenClaw.

Claude Code

// mcp.json
{
  "mcpServers": {
    "zlibrary2kindle": {
      "command": "uvx",
      "args": ["zlibrary2kindle"]
    }
  }
}

Cursor

// ~/.cursor/mcp.json (global) or .cursor/mcp.json (project)
{
  "mcpServers": {
    "zlibrary2kindle": {
      "command": "uvx",
      "args": ["zlibrary2kindle"]
    }
  }
}

OpenClaw

// ~/.openclaw/mcp_servers.json
{
  "mcpServers": {
    "zlibrary2kindle": {
      "command": "uvx",
      "args": ["zlibrary2kindle"]
    }
  }
}

Then you can ask in natural language:

帮我下载莫言的书发送到Kindle
Search for books by Yu Hua and send them to my Kindle

The AI will automatically use zlibrary_login, zlibrary_search, zlibrary_download, and kindle_send_email tools to complete the task.

Architecture

src/
├── mcp_tools/          # MCP tool definitions
│   ├── zlibrary_login.py
│   ├── zlibrary_search.py
│   ├── zlibrary_download.py
│   └── kindle_send_email.py
├── services/           # Business logic
│   ├── playwright_service.py    # Browser lifecycle
│   ├── zlibrary_service.py      # ZLibrary flows
│   └── email_service.py        # SMTP sending
├── server.py           # MCP server entry
└── cli.py             # CLI entry point

Troubleshooting

"Session expired" or download fails : Run uvx zlibrary2kindle login again to refresh session cookies.

Login page changed / Cloudflare challenge : Try uvx zlibrary2kindle login --no-headless to see the browser and solve CAPTCHA manually.

Email too large for Kindle : Google/Gmail limits attachments to ~25MB. PDFs often exceed this. Try searching for EPUB format instead.

PDF Chinese fonts missing on Kindle : EPUB format renders Chinese better on Kindle. Download EPUB when available.