Goodreads Connector for AI agents.
8 live capabilities
Search book metadata and author bibliographies with your agent.
Waiting for input…
Why people use Goodreads
Goodreads for Literary Research and Book Metadata
With this Connector, that process disappears. You ask your agent for the book, the author's history, and the community's opinion all in one go. Your agent pulls the data from Goodreads and gives you a clean summary, letting you stay focused on your project.
What Vinkius changes
Your agent becomes a real-time librarian with instant access to millions of book records.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Automating Bibliography Collection
A researcher needs a list of every book by a specific author.
- Real-world use case 02
Sentiment Analysis for Bloggers
A blogger wants to know if a new release is being well received.
- Real-world use case 03
Series Order Verification
A reader is confused about the order of a long fantasy series.
Complete set · 8capabilities
The complete Goodreads capability set.
These are the exact actions your AI can choose when you ask it to work with Goodreads.
01—04
4 capabilities in this set.
Part of 8 available through Goodreads.
- 01 Capability
Get author profile
Get detailed information about a specific author. This provides a deep dive into their professional background.
- 02 Capability
Get book info
Pull metadata for a specific book. This gives you the title, description, and other core details.
- 03 Capability
Get user reviews
Fetch reviews written by a specific user. This is great for checking a trusted reviewer's history.
- 04 Capability
Get user shelves list
See a list of the bookshelves a user has created. It's a quick way to see a reader's curated collections.
05—08
4 capabilities in this set.
Part of 8 available through Goodreads.
- 05 Capability
List author books
Get a full list of books written by a specific author. This helps you build out a complete bibliography.
- 06 Capability
Get series metadata
Get specific details about a book series. It helps you see the full lineup of a franchise.
- 07 Capability
Get user public profile
Pull public profile data for a specific user. Use this to see what a reader is currently into.
- 08 Capability
Search books
Search the entire Goodreads library for titles. Use this to find any book by name or keyword.
Set up in minutes
One URL. Then ask Goodreads to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Goodreads from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_3jFIsLCFB4Z21wtQnCoaciRU5Hzd1tJEupkXnMJ9/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Goodreads, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Goodreads for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_3jFIsLCFB4Z21wtQnCoaciRU5Hzd1tJEupkXnMJ9/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Goodreads URL.
- Step 03
Save and start
Save the connection and enable Goodreads in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"goodreads": {
"url": "https://edge.vinkius.com/vk_preview_3jFIsLCFB4Z21wtQnCoaciRU5Hzd1tJEupkXnMJ9/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Goodreads
Open Agent mode in chat and ask: "Using Goodreads, help me...". 8 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"goodreads": {
"url": "https://edge.vinkius.com/vk_preview_3jFIsLCFB4Z21wtQnCoaciRU5Hzd1tJEupkXnMJ9/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Goodreads
Ask Copilot: "Using Goodreads, help me...". 8 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"goodreads": {
"url": "https://edge.vinkius.com/vk_preview_3jFIsLCFB4Z21wtQnCoaciRU5Hzd1tJEupkXnMJ9/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Goodreads
Open Cascade and ask: "Using Goodreads, help me...". 8 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"goodreads": {
"url": "https://edge.vinkius.com/vk_preview_3jFIsLCFB4Z21wtQnCoaciRU5Hzd1tJEupkXnMJ9/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Goodreads
Ask Cline: "Using Goodreads, help me...". 8 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add goodreads --transport http "https://edge.vinkius.com/vk_preview_3jFIsLCFB4Z21wtQnCoaciRU5Hzd1tJEupkXnMJ9/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Goodreads
Ask Claude: "Using Goodreads, show me...". 8 tools are ready
Where the request belongs
Work Goodreads can move forward.
This is for book bloggers, academic researchers, and content creators who need to move past manual searching to gather literary data at scale.
Book Blogger
Use this to quickly find trending titles and summarize community sentiment for your next review.
Academic Researcher
Pull complete bibliographies and author profiles to build accurate citations and literature reviews.
Content Creator
Audit thousands of user reviews to identify key themes or popular opinions on a specific topic.
Avid Reader
Keep track of series order and discover new books based on public bookshelves and author lists.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsGoogle Books
Search and explore millions of books on Google Books. find titles, authors, reviews, previews and full text from any AI agent.
Penguin Random House
Access the global Penguin Random House catalog—search for authors, titles, works, and literary categories directly from your AI agent.
Open Library
Access the world's largest open book catalog. search books, authors, and works, and explore user-created lists directly from any AI agent.
Readwise
Connect your AI agents to Readwise to manage books, highlights, tags, and spaced repetition reviews directly through natural language.
LibraryThing
Look up books by ISBN, explore works, and check library coverage. a bibliographic intelligence capability for AI agents.
Bring your own AI
Change the model, client or framework. Keep Goodreads connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Goodreads.
The practical details behind the request, access and result.
Can the Goodreads MCP find specific book titles for me?
Yes, it can search the entire Goodreads library for any book title or keyword. Your agent will return the title, description, and other core metadata.
How does the Goodreads MCP help with book research?
It allows your agent to pull complete author bibliographies and detailed profiles. This makes it much faster to gather data for citations or literary analysis.
Can I use the Goodreads MCP to see what my friends are reading?
The Connector can access public profiles and bookshelves. If a user's profile is public, your agent can retrieve their reading trends and saved collections.
Does the Goodreads MCP summarize user reviews?
Yes, your agent can fetch reviews for specific users or titles. You can then ask it to summarize the general sentiment or highlight specific themes from those reviews.
Is the Goodreads MCP good for finding series order?
It is excellent for this. It can pull specific metadata for book series, helping you identify every member and the correct chronological order.
Do I need a Goodreads account to use this Connector?
You will need your legacy Goodreads API credentials to connect the Connector. This allows your AI client to communicate with the Goodreads database on your behalf.
Can I still get a new Goodreads API Key?
No. Goodreads stopped issuing new developer keys in December 2020. This server is designed for users who already possess a legacy key or for developers maintaining existing integrations.
What data format does this server return?
The Goodreads API natively returns XML. This server retrieves the raw XML data and provides it to your agent, which can then parse and reason over the structure using natural language.
Are there limits to review access?
Yes. Due to privacy policies, the Goodreads API typically provides snippets or widgets for reviews rather than full-text access for all users. The capabilities here will retrieve all information permitted by your specific API key.
One connection away
Give your agent a direct line to Goodreads.
Connect Goodreads once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available