Goodreads MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Goodreads: 23 typed functions through one MCP server. No Goodreads API key needed.

Functions
23
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Goodreads

An MCP server for Goodreads alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/goodreads
Every site

One MCP server for Goodreads and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 19
  • getAuthorReads one author's bio, genre, influences, website, rating/review/follower stats and a preview of their books off their page.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns GoodreadsAuthor

    interface GoodreadsAuthorBook {
      legacyId: string;
      title: string;
      url: string;
      averageRating?: number;
      ratingsCount?: number;
      publishedYear?: number;
    }
    
    interface GoodreadsAuthor {
      legacyId: string;
      name: string;
      url: string;
      image?: string;
      born?: string;
      website?: string;
      genres: string[];
      influences: string[];
      bio?: string;
      memberSince?: string;
      averageRating?: number;
      ratingsCount?: number;
      reviewsCount?: number;
      worksCount?: number;
      followersCount?: number;
      books: GoodreadsAuthorBook[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getAuthor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getAuthor("3389.Stephen_King");
  • getAuthorBooksLists an author's full bibliography, 30 books a page.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    pagenumberNo

    Returns GoodreadsAuthorBook[]

    interface GoodreadsAuthorBook {
      legacyId: string;
      title: string;
      url: string;
      averageRating?: number;
      ratingsCount?: number;
      publishedYear?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getAuthorBooks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getAuthorBooks("3389.Stephen_King");
  • getBookReads one book's full record off its page.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns GoodreadsBook

    interface GoodreadsBook {
      legacyId: string;
      title: string;
      titleComplete?: string;
      url: string;
      authorName?: string;
      authorUrl?: string;
      format?: string;
      pageCount?: number;
      isbn?: string;
      language?: string;
      publisher?: string;
      genres: string[];
      description?: string;
      averageRating?: number;
      ratingsCount?: number;
      textReviewsCount?: number;
      /** The series this book belongs to, with its position; pass its url to getSeries. Empty for a standalone book. */
      series: { title: string; url: string; position?: string }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getBook

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getBook("2767052");
  • getBookEditionsLists the editions of a book (publisher, date, format, pages, ISBN, language, rating), 10 a page.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    pagenumberNo

    Returns GoodreadsBookEdition[]

    interface GoodreadsBookEdition {
      legacyId: string;
      title: string;
      url: string;
      published?: string;
      publisher?: string;
      format?: string;
      pages?: number;
      isbn?: string;
      isbn10?: string;
      language?: string;
      averageRating?: number;
      ratingsCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getBookEditions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getBookEditions("2767052");
  • getBookQuotesLists the quotes readers have attached to one book, with the quote text, its page and the like count, 30 a page.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    pagenumberNo

    Returns GoodreadsBookQuote[]

    interface GoodreadsBookQuote {
      id: string;
      text: string;
      authorName?: string;
      likes?: number;
      tags: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getBookQuotes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getBookQuotes("2767052");
  • getBookReviewsReads a page of member reviews for one book.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    pageNumbernumberNo

    Returns GoodreadsReviewRow[]

    interface GoodreadsReviewRow {
      id: string;
      text: string;
      createdAt?: number;
      reviewerName?: string;
      reviewerUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getBookReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getBookReviews("2767052");
  • getListReads one curated Listopia list.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns GoodreadsListBook[]

    interface GoodreadsListBook {
      legacyId: string;
      rank: number;
      title: string;
      url: string;
      authorName?: string;
      authorUrl?: string;
      averageRating?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getList("1.Best_Books_Ever");
  • getMemberProfileReads a member's PUBLIC profile summary.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns GoodreadsMemberProfile

    interface GoodreadsMemberProfile {
      name: string;
      username?: string;
      location?: string;
      booksCount?: number;
      friendCount?: number;
      shelfCounts: Record<string, number>;
      favoriteGenres: string[];
      // true when the member's own privacy setting restricts this page to
      // signed-in visitors, shelfCounts/favoriteGenres are empty because the
      // site never sent them, not because the member has none.
      private: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getMemberProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getMemberProfile("1-otis-chandler");
  • getMemberShelfLists the books on one of a member's shelves (read, currently-reading, want-to-read, or a custom shelf).

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    shelfstringNo
    pageNumbernumberNo

    Returns GoodreadsShelfBook[]

    interface GoodreadsShelfBook {
      legacyId?: string; // absent only when the book has no cover
      title: string;
      url: string;
      reviewUrl?: string;
      authorName?: string;
      authorUrl?: string;
      coverUrl?: string;
      // the member's own 1-5 rating on this shelf; 0 means not rated
      userRating: number;
      reviewSnippet?: string;
      shelves: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getMemberShelf

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getMemberShelf("1-otis-chandler", "read");
  • getNewsFeedReads the signed-in caller's home feed.

    Arguments

    None.

    Returns GoodreadsUpdate[]

    interface GoodreadsUpdate {
      actorName: string;
      actorUrl?: string;
      action: string;
      bookTitle?: string;
      bookUrl?: string;
      bookId?: string;
      author?: string;
      url?: string;
      timestamp?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getNewsFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getNewsFeed();
  • getOwnProfileReads the signed-in caller's own profile.

    Arguments

    None.

    Returns GoodreadsMemberProfile & { memberId: string }

    interface GoodreadsMemberProfile {
      name: string;
      username?: string;
      location?: string;
      booksCount?: number;
      friendCount?: number;
      shelfCounts: Record<string, number>;
      favoriteGenres: string[];
      // true when the member's own privacy setting restricts this page to
      // signed-in visitors, shelfCounts/favoriteGenres are empty because the
      // site never sent them, not because the member has none.
      private: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getOwnProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getOwnProfile();
  • getSeriesReads a book series' reading order.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns GoodreadsSeries

    interface GoodreadsSeriesBook {
      number?: string;
      legacyId: string;
      title: string;
      url: string;
      author?: string;
      averageRating?: number;
      ratingsCount?: number;
      numPages?: number;
    }
    
    interface GoodreadsSeries {
      seriesId: string;
      title: string;
      url: string;
      books: GoodreadsSeriesBook[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getSeries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getSeries("73758-the-hunger-games");
  • getSimilarBooksLists the books Goodreads suggests next to one book.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns GoodreadsSimilarBook[]

    interface GoodreadsSimilarBook {
      legacyId: string;
      title: string;
      url: string;
      imageUrl?: string;
      authorName?: string;
      averageRating?: number;
      ratingsCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/getSimilarBooks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.getSimilarBooks("2767052");
  • listGenreBooksBrowses one genre shelf, the books Goodreads itself files under that genre tag, newest/most-popular first.

    Arguments

    NameTypeRequired
    genrestringYes

    Returns GoodreadsBookRow[]

    interface GoodreadsBookRow {
      legacyId: string;
      title: string;
      url: string;
      authorName?: string;
      authorUrl?: string;
      averageRating?: number;
      ratingsCount?: number;
      textReviewsCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/listGenreBooks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.listGenreBooks("science-fiction");
  • rateBookSets the signed-in caller's own star rating (1-5) on a book.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    rating1 | 2 | 3 | 4 | 5Yes

    Returns { legacyId: string; rating: number }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/rateBook

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.rateBook("2767052", 5);
  • searchAuthorsFinds Goodreads authors by name; returns each match's id, url, books-on-shelf count and location.

    Arguments

    NameTypeRequired
    querystringYes

    Returns GoodreadsAuthorSearchRow[]

    interface GoodreadsAuthorSearchRow {
      legacyId: string;
      name: string;
      url: string;
      memberUrl?: string;
      location?: string;
      booksCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/searchAuthors

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.searchAuthors("stephen king");
  • searchBooksRuns the site's book search and returns title, author, url and (when the card shows one) average rating per row.

    Arguments

    NameTypeRequired
    querystringYes

    Returns GoodreadsBookRow[]

    interface GoodreadsBookRow {
      legacyId: string;
      title: string;
      url: string;
      authorName?: string;
      authorUrl?: string;
      averageRating?: number;
      ratingsCount?: number;
      textReviewsCount?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/searchBooks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.searchBooks("the hunger games");
  • searchQuotesRuns the public quotes search and returns quote text with its attributed author or book.

    Arguments

    NameTypeRequired
    querystringYes

    Returns GoodreadsQuote[]

    interface GoodreadsQuote {
      id: string;
      text: string;
      authorName?: string;
      authorUrl?: string;
      bookTitle?: string;
      bookUrl?: string;
      likes?: number;
      tags: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/searchQuotes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.searchQuotes("courage");
  • writeReviewPosts a text review (with an optional star rating) on a book as the signed-in caller.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    textstringYes
    rating1 | 2 | 3 | 4 | 5No

    Returns { legacyId: string; rating?: number; posted: true }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/writeReview

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.writeReview("2767052", "A quiet test review.");
Act 4
  • addToShelfAdds a book to one of the signed-in caller's shelves (want-to-read, currently-reading, read, or a custom shelf), creating the shelf if it does not…

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    shelfstringNo

    Returns { legacyId: string; shelf: string; shelved: true }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/addToShelf

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.addToShelf("<idOrUrl>");
  • followUserFollows another member as the signed-in caller.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns { memberId: string; following: true }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/followUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.followUser("<idOrUrl>");
  • removeFromShelfRemoves a book from one of the signed-in caller's shelves.

    Arguments

    NameTypeRequired
    idOrUrlstringYes
    shelfstringYes

    Returns { legacyId: string; shelf: string; shelved: false }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/removeFromShelf

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.removeFromShelf("<idOrUrl>", "<shelf>");
  • unfollowUserStops following another member as the signed-in caller.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns { memberId: string; following: false }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/goodreads/unfollowUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.goodreads.unfollowUser("<idOrUrl>");

Use it from code