Agent skill · software engineering · mvanhorn
pp-goodreads
Printing Press CLI + MCP for Goodreads, read and write — rate books (GraphQL RateBook/UnrateBook), write/publicize reviews, add to and create shelves, home feed, friends, recommendations, genre/topic search, book pages, and Goodreads Giveaways. Reverse-engineered from the logged-in web app (no public API), live-verified.
Why this skill is useful
Adds executable commands for Goodreads management that are not available through any public API, enabling new capabilities for the AI.
What it needs
Requires goodreads-pp-cli installed locally. About 9k tokens when loaded. Last updated 2026-08-06. 1,890 stars on the source repository.
What this skill does
Goodreads — Printing Press CLI Prerequisites: Install the CLI This skill drives the goodreads-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first: 1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: 2. Verify: goodreads-pp-cli --version 3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill. If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer): If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds. HTTP Transport This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints and sends the configured Goodreads session as the sessionid2 cookie. It does not require a resident browser process for normal API calls. MCP Surface The MCP binary defaults to stdio and can serve streamable HTTP for hosted agents: Default MCP registration exposes goodreadssearch and goodreadsexecute for the full route map, plus local search, sql, and context. Raw endpoint mirror tools are opt-in with GOODREADSMCPENDPOINTMIRRORS=1. Mutating routes remain blocked unless GOODREADSPPALLOWWRITES=1 is set after explicit approval. Command Reference amazon-purchases — Manage amazon purchases goodreads-pp-cli amazon-purchases — Amazon purchases import/inspection page. book — Manage book goodreads-pp-cli book <bookslug> — Book detail page. Current page is Next.js-backed. comment — Manage comment goodreads-pp-cli comment <userslug> — User comments/recent posts page. feed — Read the home updates feed (friends' activity) goodreads-pp-cli feed list — Read the home updates feed (friends' activity). Use --page <n> to walk older activity. Read-only POST to /home/loadmoreupdates. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mvanhorn/goodreads