shelfie-mcp

MCP server for Shelfie. Exposes your shelfiebook.com library to Claude Desktop, Cursor, and any MCP-aware client.

Install (Claude Desktop)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "shelfie": {
      "command": "npx",
      "args": ["-y", "shelfie-mcp"],
      "env": {
        "SHELFIE_API_KEY": "sb_live_..."
      }
    }
  }
}

Mint a key at https://shelfiebook.com/settings (API keys section).

Tools

• list_books — search and paginate the user's books
• get_book — fetch one book by id
• add_book — add a book; dedupes by normalized title/author
• update_book — patch read_status, rating, notes, lent_to, wishlist, etc.
• delete_book — soft-delete
• export_library — CSV / XLSX / Goodreads / BibTeX

Try it

After restart, ask Claude: "What's in my Shelfie library?" and it will call list_books for you.