How to Use the Goodreads MCP in Claude Code

Q: Can I audit my Goodreads shelves via Claude Code?

Yes, you use getusershelveslist to list your books. Claude Code formats the output, making it easy to pipe the list to other terminal tools.

Claude Code brings Goodreads data into your terminal for headless book auditing and metadata processing.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Goodreads MCP to Claude Code

Create your Vinkius account to connect Goodreads to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Goodreads with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless book metadata processing

Run `search_books` from your terminal to pipe data into your CI/CD pipelines. Claude Code fetches the metadata and converts it into formats your scripts can process. You avoid the browser entirely. By calling `get_book_info`, the agent retrieves specific details that you can save directly to your local file system for batch processing.

Automated author data extraction

Claude Code uses `list_author_books` to compile bibliographies for your projects. It runs this as part of a larger script to keep your data current. It also uses `get_author_profile` to grab biographical details. You can feed this output into other shell tools to generate documentation or reports automatically.

Review auditing at the command line

Use `get_user_reviews` to pull reader feedback into your log files. Claude Code captures this data and displays it in your terminal, perfect for quick audits of book sentiment. This MCP Server provides the hooks for your terminal to interact with Goodreads. It keeps your workflow local and fast by avoiding unnecessary UI overhead.

Setup guide

Set up Goodreads MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see goodreads-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Goodreads transactions." It will automatically discover and invoke the available Goodreads tools.

Terminal

claude mcp add --transport http goodreads-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Goodreads MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "goodreads-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Goodreads. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Goodreads now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Goodreads MCP in Claude Code

You run the search command through the CLI. Claude Code triggers the `search_books` tool and prints the results directly to your terminal output.

Yes, you use `get_user_shelves_list` to list your books. Claude Code formats the output, making it easy to pipe the list to other terminal tools.

It is. Because Claude Code runs in the terminal, you can chain these tools with standard unix utilities to build custom data pipelines.

Run the list command in your terminal to see the registered tools. This confirms the server is reachable and ready to process requests.

The server handles all interactions via encrypted transport. We never cache your shelf data, and the terminal only touches public records accessible without a password.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript