gutenberg-mcp-server — Claude Code MCP server: what it does
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.
Apache-2.0 1,987 installs ★ 6 updated 2026-10-17
claude mcp add --transport http gutenberg-mcp-server https://gutenberg-mcp-server--cyanheads.run.toolsWhat gutenberg-mcp-server 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.
What it helps with
- 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_readableflag
Example prompts for the agent
- 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
How to install gutenberg-mcp-server
Platform CLI: remote server
claude mcp add --transport http gutenberg-mcp-server https://gutenberg-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add gutenberg-mcp-server --url https://gutenberg-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"gutenberg-mcp-server": {
"url": "https://gutenberg-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"gutenberg-mcp-server": {
"type": "http",
"url": "https://gutenberg-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http gutenberg-mcp-server https://gutenberg-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about gutenberg-mcp-server
How do I install gutenberg-mcp-server in Claude Code?
Run claude mcp add --transport http gutenberg-mcp-server https://gutenberg-mcp-server--cyanheads.run.tools to connect the remote server over HTTPS without local setup.
What does gutenberg-mcp-server do?
The server connects your agent to the Project Gutenberg catalog: searches books by author, title, topic, language; fetches edition metadata; reads book text in chunks up to 50,000 characters. No API key needed.
Can I read any book from search results?
Not all editions are readable via gutenberg_get_text. The is_readable flag in search results indicates whether the server can retrieve that book's text — it supports UTF-8 and HTML; audiobooks are not supported.