Readbook

You can run a Readbook MCP Server to fetch and manage book content, bookmarks, and reading progress for AI assistants. It exposes tools to search, read, and summarize books, while maintaining per-book progress and bookmarks for a tailored reading experience.

How to use

Connect your MCP client to the Readbook MCP Server using the provided stdio configuration or the remote HTTP option if you have one. You can perform practical actions like searching for books by title or author, retrieving specific chapters, adding bookmarks, and updating or querying reading progress and statistics. Use the tools to build workflows such as getting a reading list, fetching content for a chapter, bookmarking important passages, and generating personalized recommendations or summaries.

How to install

Prerequisites: Node.js and npm must be installed on your system. You will also need a working shell or terminal.

git clone https://github.com/yourusername/readbook-mcp.git
cd readbook-mcp
npm install
npm run build

Configuration

Configure the MCP client to connect to Readbook MCP Server using a local stdio setup. The server is started locally with Node and points to the built entry file.

{
  "mcpServers": {
    "readbook": {
      "command": "node",
      "args": ["/path/to/readbook-mcp/build/index.js"]
    }
  }
}

Development

You can build and run in development mode to test locally before deployment.

npm run build
npm run watch
npm run inspector

Mock data and API usage highlights

The server ships with mock books for quick testing, including multiple titles with chapters. Use the API usage patterns to search books, fetch content, manage bookmarks, and track progress across your library.

Common tool usage includes searching by title or author, retrieving a particular book’s content, adding bookmarks with notes, and updating or querying reading progress and statistics.

Available tools

search_books

Search for books by title, author, or category to locate relevant reads.

get_book_content

Retrieve chapter content for a specific book and chapter number.

add_bookmark

Create a bookmark at a given chapter and page with an optional note.

get_bookmarks

Fetch all bookmarks for a given book to revisit important passages.

get_reading_progress

Get the current reading progress for a book, showing chapters/pages completed.

update_reading_progress

Update your progress by marking chapters or pages as read and optionally mark chapters complete.

get_reading_stats

Get overall statistics across your reading activity and books.

book_list

List all available books in the mock data set.

reading_progress_summary

Provide a summary of reading progress across all books.

reading_recommendation

Get personalized book recommendations based on your reading history.

reading_summary

Generate a summarized reading report for selected books.