# gutenberg-mcp-server MCP server

MCP server for Project Gutenberg — 75,000+ public-domain ebooks with full plain-text retrieval.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-cyanheads-gutenberg-mcp-server
- Repository: https://github.com/cyanheads/gutenberg-mcp-server

## Install
- Command: `npx -y @cyanheads/gutenberg-mcp-server`
- Endpoint: https://gutenberg.caseyjhand.com/mcp
- Auth: Not captured

## Setup notes
- Package: Npm @cyanheads/gutenberg-mcp-server v0.1.6
- Environment variable: MCP_LOG_LEVEL (default info)
- Package: Npm @cyanheads/gutenberg-mcp-server v0.1.6
- Environment variable: MCP_HTTP_HOST (default 127.0.0.1)
- Environment variable: MCP_HTTP_PORT (default 3010)
- Environment variable: MCP_HTTP_ENDPOINT_PATH (default /mcp)
- Environment variable: MCP_AUTH_MODE (default none)
- Environment variable: MCP_LOG_LEVEL (default info)
- Remote endpoint: https://gutenberg.caseyjhand.com/mcp

## Tools
- gutenberg_search_books (Search Gutenberg Books) - Search the Project Gutenberg catalog of 78,000+ public-domain books. Matches title and author name with query words; filters by topic (subject or bookshelf keyword), language, author lifespan, or a specific list of Gutenberg IDs. Results are ordered by popularity (download count) by default. Returns book ID, title, authors, languages, subjects, and download count — use gutenberg_get_book for the full formats map before fetching text. Endpoint: https://gutenberg.caseyjhand.com/mcp
- gutenberg_get_book (Get Gutenberg Book) - Fetch complete metadata for a Project Gutenberg book by ID — title, authors (with birth/death years), translators, editors, subjects, bookshelves, languages, copyright status, and the full formats map with download URLs for each available format (plain text, HTML, EPUB, cover image, etc.). Use this before gutenberg_get_text to confirm a plain-text format is available and to get the direct download URL. Endpoint: https://gutenberg.caseyjhand.com/mcp
- gutenberg_get_text (Get Gutenberg Book Text) - Retrieve the plain-text content of a Project Gutenberg book, stripped of the standard license header and footer so the response contains only the literary work. For long works — novels routinely run 500KB–2MB — use offset and limit to read in chunks rather than fetching the whole book at once. The response reports totalChars and remainingChars for reliable pagination. Prefers UTF-8 plain text; falls back to an HTML edition converted to text; refuses audio books (media_type "Sound") with a clear error. Endpoint: https://gutenberg.caseyjhand.com/mcp
- gutenberg_browse_popular (Browse Popular Gutenberg Books) - Browse the most-downloaded Project Gutenberg books, ordered by popularity. Returns up to 32 titles with their Gutenberg IDs, authors, languages, and download counts. Optionally filter by language or topic. Use this as a discovery entry point — "what are the most popular classics in French?" — or as a heartbeat check that the catalog is reachable. Endpoint: https://gutenberg.caseyjhand.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.cyanheads
- Version: 0.1.6
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 11, 2026
- Source: https://registry.modelcontextprotocol.io