bookmosh-mcp

BookMosh MCP server

Connect your BookMosh reading library to Claude and other AI tools through the Model Context Protocol. Search the catalog, list and update your shelves, log books, and build public or private reading lists, all in natural language.

It wraps the BookMosh developer API and authenticates with a personal API key (bm_live_...).

Get an API key

1. Open BookMosh, go to Profile -> Settings -> Developer API.
2. Create a key and copy it (shown once). It looks like bm_live_....

Use it with Claude Desktop

Add this to your claude_desktop_config.json (Claude Desktop -> Settings -> Developer -> Edit Config):

{
  "mcpServers": {
    "bookmosh": {
      "command": "npx",
      "args": ["-y", "bookmosh-mcp"],
      "env": { "BOOKMOSH_API_KEY": "bm_live_your_key_here" }
    }
  }
}

Restart Claude Desktop. You can now say things like "add The Left Hand of Darkness to my to-read shelf" or "what am I currently reading?".

Use it with Claude Code

claude mcp add bookmosh --env BOOKMOSH_API_KEY=bm_live_your_key_here -- npx -y bookmosh-mcp

Tools

Tool	What it does
search_catalog	Search the 380,000+ book catalog (by title/author/keywords or ISBN).
list_my_books	List your library, filter by status/tag/text, page with a cursor.
get_my_book	Fetch one book from your library by id.
add_book	Add a book (or update it if it exists). title + author required.
update_book	Update status, rating, progress, tags, cover, or finished date.
remove_book	Remove a book from your library.
list_my_lists	List your reading lists (collections), each public or private.
get_list	Fetch one list and its books by id (yours, or anyone's public list).
create_list	Create a list. title required; is_public (or visibility) sets public/private, default private. Can seed with books.
update_list	Rename, re-describe, or flip a list public/private.
delete_list	Delete a list and its books.
add_book_to_list	Add a book to one of your lists (list_id + title). Skips duplicates.
remove_book_from_list	Remove a book from a list (list_id + item_id).

Configuration

Env var	Required	Default
BOOKMOSH_API_KEY	yes	(required)
BOOKMOSH_API_URL	no	the BookMosh production API

Notes

• Rate limit: 60 requests/minute per key. The tools surface a clear message on 429.
• Scopes: read tools need books:read / search:read; write tools need library:write. Keys created in the app include all three.
• Your key grants access to your own library only. Keep it secret; you can revoke a key any time under Developer API settings.

Run from source

npm install
BOOKMOSH_API_KEY=bm_live_xxx node index.js