How to Use the Goodreads MCP in LlamaIndex

Q: How do I ingest Goodreads shelf data into a LlamaIndex vector store?

Call getusershelveslist using the McpToolSpec to retrieve the user's shelves. Pass the resulting data to LlamaIndex's document parsers to build your vector index.

Q: Can LlamaIndex agents search Goodreads book listings in real-time?

Yes, the searchbooks tool runs live queries when the agent needs immediate data. For historical queries, your agent can fall back to searching your pre-indexed LlamaIndex vector store.

Q: How do I handle schema conversion between the Goodreads MCP Server and LlamaIndex?

The llama-index-tools-mcp package handles schema conversion automatically. It maps the server's tool schemas directly to LlamaIndex's tool specifications without custom code.

Q: What is the setup configuration for this MCP Server?

Install llama-index-tools-mcp and instantiate the BasicMCPClient with the Vinkius URL. Convert the tools using totoollistasync() and pass them to your FunctionAgent.

Q: Is my Goodreads public profile data secure when using this MCP Server?

The server only reads public data via getuserpublicprofile and public shelf lists. Vinkius executes each connection in a zero-trust, ephemeral sandbox, ensuring your data is never cached or stored on external servers.

Index Goodreads book data and public reviews directly into LlamaIndex vector stores for semantic search.

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 LlamaIndex

Create your Vinkius account to connect Goodreads to LlamaIndex 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 LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Index book metadata into LlamaIndex vector stores with this MCP Server

The `get_book_info` tool retrieves rich metadata which LlamaIndex immediately parses into document nodes. Your pipeline converts these nodes into vector embeddings, turning raw Goodreads metadata into a queryable semantic index. When users ask for books with specific thematic elements, your agent queries this vector store instead of running basic keyword searches. The `get_series_metadata` output is indexed similarly, linking series context to individual book nodes.

Convert Goodreads reviews into searchable LlamaIndex nodes

Your pipeline uses `get_user_reviews` to fetch user text and loads it directly into a local vector index. This turns unstructured reader feedback into structured, searchable data points. By querying this index, your application matches user queries against actual reader sentiments rather than publisher descriptions. This Goodreads MCP Server provides the raw qualitative text needed to power these highly specific RAG pipelines.

Semantic discovery of author bibliographies

The `list_author_books` tool pulls all titles by a specific creator, which LlamaIndex indexes alongside biographical data from `get_author_profile`. This creates a unified knowledge graph of an author's entire career. Your agent searches this graph to find thematic shifts in an author's work over time. It bypasses simple chronological lists, using semantic search to connect different eras of an author's writing.

Setup guide

Set up Goodreads MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all Goodreads MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to Goodreads tools.",
)
response = await agent.run("List recent Goodreads data")

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 LlamaIndex

Call `get_user_shelves_list` using the `McpToolSpec` to retrieve the user's shelves. Pass the resulting data to LlamaIndex's document parsers to build your vector index.

Yes, the `search_books` tool runs live queries when the agent needs immediate data. For historical queries, your agent can fall back to searching your pre-indexed LlamaIndex vector store.

The `llama-index-tools-mcp` package handles schema conversion automatically. It maps the server's tool schemas directly to LlamaIndex's tool specifications without custom code.

Install `llama-index-tools-mcp` and instantiate the `BasicMCPClient` with the Vinkius URL. Convert the tools using `to_tool_list_async()` and pass them to your `FunctionAgent`.

The server only reads public data via `get_user_public_profile` and public shelf lists. Vinkius executes each connection in a zero-trust, ephemeral sandbox, ensuring your data is never cached or stored on external servers.

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