Skip to content
MCP server

Project Gutenberg MCP

Read Project Gutenberg books via MCP. Search, fetch metadata, and retrieve text in…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.2.0
Listing updated
5 days ago

About Project Gutenberg MCP

Project Gutenberg MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Read Project Gutenberg books via MCP. Search, fetch metadata, and retrieve text in passages.

Install

Run in a terminal

claude mcp add project-gutenberg-mcp --env GUTENBERG_BASE_URL='<GUTENBERG_BASE_URL>' --env GUTENBERG_TOOLS='<GUTENBERG_TOOLS>' -- docker run -i --rm -e GUTENBERG_BASE_URL -e GUTENBERG_TOOLS roberthouse224/project-gutenberg-mcp:1.2.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "project-gutenberg-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GUTENBERG_BASE_URL",
        "-e",
        "GUTENBERG_TOOLS",
        "roberthouse224/project-gutenberg-mcp:1.2.0"
      ],
      "env": {
        "GUTENBERG_BASE_URL": "<GUTENBERG_BASE_URL>",
        "GUTENBERG_TOOLS": "<GUTENBERG_TOOLS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "project-gutenberg-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GUTENBERG_BASE_URL",
        "-e",
        "GUTENBERG_TOOLS",
        "roberthouse224/project-gutenberg-mcp:1.2.0"
      ],
      "env": {
        "GUTENBERG_BASE_URL": "<GUTENBERG_BASE_URL>",
        "GUTENBERG_TOOLS": "<GUTENBERG_TOOLS>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "project-gutenberg-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GUTENBERG_BASE_URL",
        "-e",
        "GUTENBERG_TOOLS",
        "roberthouse224/project-gutenberg-mcp:1.2.0"
      ],
      "env": {
        "GUTENBERG_BASE_URL": "<GUTENBERG_BASE_URL>",
        "GUTENBERG_TOOLS": "<GUTENBERG_TOOLS>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "project-gutenberg-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GUTENBERG_BASE_URL",
        "-e",
        "GUTENBERG_TOOLS",
        "roberthouse224/project-gutenberg-mcp:1.2.0"
      ],
      "env": {
        "GUTENBERG_BASE_URL": "<GUTENBERG_BASE_URL>",
        "GUTENBERG_TOOLS": "<GUTENBERG_TOOLS>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "project-gutenberg-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GUTENBERG_BASE_URL",
        "-e",
        "GUTENBERG_TOOLS",
        "roberthouse224/project-gutenberg-mcp:1.2.0"
      ],
      "env": {
        "GUTENBERG_BASE_URL": "<GUTENBERG_BASE_URL>",
        "GUTENBERG_TOOLS": "<GUTENBERG_TOOLS>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GUTENBERG_BASE_URLBase URL of your Gutenberg mirror. Run the mirror from the mirror/ directory and point this at it. See the README for setup instructions.Required
  • GUTENBERG_TOOLSComma-separated list of tools to expose. Available: search_books, get_book_metadata, fetch_book_text, list_passages, get_passageRequired
  • GUTENBERG_BOOK_IDProject Gutenberg book ID to use as the default for all tools. Find IDs via search_books. Example: 2680 for Meditations by Marcus Aurelius.
  • GUTENBERG_CHUNK_SIZESize in bytes of each passage returned by get_passage.
  • GUTENBERG_LANGUAGEDefault ISO 639-1 language code filter for search_books. Used when the caller omits the language parameter.

Pricing

Open source

Project Gutenberg MCP FAQ

Is Project Gutenberg MCP free?

Yes. Project Gutenberg MCP is open source, so you can use and self-host it for free.

How do I add Project Gutenberg MCP to Claude Code?

Run this command in your terminal: claude mcp add project-gutenberg-mcp --env GUTENBERG_BASE_URL='<GUTENBERG_BASE_URL>' --env GUTENBERG_TOOLS='<GUTENBERG_TOOLS>' -- docker run -i --rm -e GUTENBERG_BASE_URL -e GUTENBERG_TOOLS roberthouse224/project-gutenberg-mcp:1.2.0

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers