Your reading life, made useful

Ask your AI about everything you’ve read.

Connect your Goodreads library to Claude, Codex, or another MCP client. Find patterns in your reading, remember what mattered, and choose your next book.

Connect my library See how it works

No Goodreads password. Your credentials stay on your device, not on the cloud.

Try a question

“What books changed how I think about work?”

1 The Design of Everyday Things · Don Norman

2 Thinking in Systems · Donella Meadows

3 Range · David Epstein

Your library, with a point of view →

Your books let you discover you.

Goodreads keeps the record. Goodreads MCP makes that record available to the tools you already use, without turning your reading life into another social feed.

Recall

Find the title, author, or half-remembered idea hiding somewhere in your shelves.

Reflect

Look back at your reading patterns, ratings, and seasons of your life.

Discover

Ask for recommendations that start from what you actually read—not a generic profile.

Simple by design

Choose where your reading life lives.

Three small choices. No passwords, no mysterious setup language, no need to understand how MCP works.

1 YOUR AI

Run the command

Choose your AI client and run the setup command. A fresh browser window opens on your device.

setup --client claude

setup --client codex

2 YOUR BOOKS

Log in on Goodreads

Sign in directly on Goodreads, then use the account menu on the right to visit Profile. The helper never sees your password or session cookie. Open Goodreads ↗

Having trouble? Find your ID manually.

3 DONE

Let the tool do its thing

It finds your library connection in memory, asks before changing local configuration, and gets your AI ready to answer its first question.

“What should I read next?” Your library is ready →

For people who want the details.

Use local stdio or the hosted endpoint. Both expose the same library tools.

Local

Run the server on your own machine and keep the values in your client environment.

command: npx
args: -y, goodreads-mcp
environment:
  GOODREADS_USER_ID
  GOODREADS_RSS_KEY

Hosted

Point your MCP client at the stateless hosted endpoint and send credentials as request headers.

url: https://goodreads-mcp-chi.vercel.app/mcp
headers:
  X-Goodreads-User-ID: GOODREADS_USER_ID
  X-Goodreads-RSS-Key: GOODREADS_RSS_KEY

Privacy is a boundary, not a feature. No Goodreads passwords, session cookies, scraping, or secret-bearing URLs in logs. The hosted endpoint reads request-scoped values and does not store them.