Goodreads MCP Server

goodreads-mcp

A CLI tool for Goodreads MCP integration.

Installation

Prerequisites

If you don't have uv installed, first install it:

Clone the repository

Usage

CLI Commands

Using with Claude Desktop

To use goodreads-mcp as an MCP server in Claude Desktop:

1. First clone the repository:
   git clone https://github.com/getgather-hub/mcp-getgather-goodreads.git cd mcp-getgather-goodreads
2. Configure Claude Desktop by editing the config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Add the following configuration:
   { "mcpServers": { "goodreads": { "command": "uv", "args": [ "--directory", "/path/to/mcp-getgather-goodreads", "run", "goodreads-mcp" ], "env": { "GOODREADS_EMAIL": "your-email@example.com", "GOODREADS_PASSWORD": "your-password", "GETGATHER_URL": "127.0.0.1:8000" } } } }
   Note: Replace /path/to/mcp-getgather-goodreads with the actual path where you cloned the repository.
4. Restart Claude Desktop

Available MCP Tools

Once configured, the following tools will be available in Claude:

• get_goodreads_books: Get books from your Goodreads library

Environment Variables

The MCP server requires these environment variables:

• GOODREADS_EMAIL: Your Goodreads account email
• GOODREADS_PASSWORD: Your Goodreads account password
• GETGATHER_URL: (Optional) Host URL for the service (default: 127.0.0.1:8000)