# gutenberg-mcp-server

MCP server for searching and reading books from Project Gutenberg's library of 78,000 public-domain titles. Searches by title, author, topic, language; returns book text in chunks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1987 installs · ★ 6 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/gutenberg-mcp-server
- Updated: 2026-10-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gutenberg-mcp-server

## What it does

The server exposes four tools: `gutenberg_search_books` for catalog queries (filters by author, topic, language, author lifespan, copyright status), `gutenberg_get_book` for fetching full book metadata (authors, translators, available formats, subjects, 30-day download counts), `gutenberg_get_text` for reading book text with license boilerplate stripped and offset-limit chunking (default 20,000 characters, capped at 50,000), and `gutenberg_browse_popular` for browsing top downloads with optional filters.

Searches and lookups run against a local SQLite catalog with full-text indexing; when a record is missing, the server queries Gutendex. Book text is fetched from a Project Gutenberg mirror as UTF-8 plain text or HTML converted to text. Every search result includes `is_readable`, which signals whether `gutenberg_get_text` can read that edition. No API key required.

You can run the server locally via `npx` or connect to a remote instance over HTTPS. The package includes a `gutenberg-guide` skill with rules for edition selection, paging long texts, and handling search gaps.

## Requirements
- Remote server: `https://gutenberg-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http gutenberg-mcp-server https://gutenberg-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add gutenberg-mcp-server --url https://gutenberg-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gutenberg-mcp-server": {
            "url": "https://gutenberg-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gutenberg-mcp-server": {
            "type": "http",
            "url": "https://gutenberg-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http gutenberg-mcp-server https://gutenberg-mcp-server--cyanheads.run.tools
```

## When to use it
- search books by author, title, topic, or language across 78,000 editions
- read full book text from Project Gutenberg in 20,000-character chunks
- fetch book metadata: authors, translators, formats, subjects, download stats
- browse popular books filtered by language or topic
- check if a book's text is readable via the `is_readable` flag

## Example prompts
- Find books by Mark Twain in English from the Gutenberg catalog
- Read the first 20,000 characters of book ID 1342 from Project Gutenberg
- Show the 10 most popular German-language books from Gutenberg

## Similar
- [libgen-mcp](https://affpapa.org/en/nevibecode/mcp/libgen-mcp.md) — MCP server · 637 installs
- [Anna's Archive and OpenAlex](https://affpapa.org/en/nevibecode/mcp/annas-archive-and-openalex.md) — MCP server · ★ 9 repo stars
- [deep-reader](https://affpapa.org/en/nevibecode/skills/deep-reader.md) — skill · ★ 117 repo stars
- [Markdown Vault MCP](https://affpapa.org/en/nevibecode/mcp/markdown-vault-mcp.md) — MCP server · ★ 41 repo stars
- [Gnosis MCP](https://affpapa.org/en/nevibecode/mcp/gnosis-mcp.md) — MCP server · ★ 32 repo stars
- [RTFM](https://affpapa.org/en/nevibecode/mcp/rtfm.md) — MCP server · ★ 27 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
