You’ve read more than you remember.

Goodreads is good at keeping a list. Goodreads MCP lets you ask it questions. Which books changed how you think about work? What do you keep returning to? What should you read next?

Connect Goodreads See an example

No password required. Your Goodreads login stays yours.

“Make me a reading brief I can share.”

1 42 books finished · 14,806 pages

2 4.6/5 average rating · 31 books rated

3 Most-read author · Ursula K. Le Guin

Fact-only Markdown, ready to make your own →

A reading list is a record. It can also be a way to think.

Most of us read a book, mark it read, and move on. Later, the useful part is hard to recover. This connects your Goodreads history to Claude or Codex so you can search it, look for patterns, and make decisions from your own experience.

Find the book

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

See the pattern

Notice what you’ve loved, skipped, and returned to over the years.

Pick the next one

Get recommendations that start with your taste—not a generic profile.

Start with one of these: “Create my reading brief for 2026.” · “What do my five-star books have in common?” · “Pick three books from my to-read shelf.” · “Which unfinished series should I return to?” Copy a prompt. Ask a real question.

Connect it once. Then just ask.

The setup is a little technical because computers are. The useful part is simple.

Tell us where to connect

Choose Claude or Codex and run one command. A browser window opens on your device.

setup --client claude

setup --client codex

Sign in normally

Goodreads is the only place that sees your password. We’ll find the profile and library details we need. Open Goodreads ↗

Having trouble? Find your ID manually.

Ask the obvious question

The setup saves the connection on your computer. Then ask something you actually want to know:

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

If you’re curious about the machinery.

There is a local option and a hosted Vercel option. Both let your AI read the same library; the difference is where the connection runs.

On your computer

Your connection details stay on your machine.

command: npx
args: -y, @organized-chaos/goodreads-mcp
environment:
  GOODREADS_USER_ID
  GOODREADS_RSS_KEY

Hosted on Vercel

A small hosted endpoint handles requests. Your Goodreads details are sent with each request and are not saved.

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

We’ve kept this deliberately boring. No Goodreads password, no session cookies, no scraping, and no saved library credentials.