bibliocommons-mcp
MCP server for placing holds, searching, and managing your account at BiblioCommons-powered public libraries.
Install
pipx install bibliocommons-mcp
Requires Python 3.11+.
Quick Start
bibliocommons-mcp init
claude mcp add bibliocommons bibliocommons-mcp --scope user
init walks the prompts, validates live against the gateway, and writes the config file for you. Manual setup: docs/configuration.md. For Claude Desktop, Cursor, or other MCP clients: docs/mcp-clients.md.
Try asking
- “Place a hold on Project Hail Mary at my branch.”
- “Show my current holds and their queue positions.”
- “What’s due back this week?”
- “Cancel my hold on Zen and the Art of Motorcycle Maintenance.”
Tools
All mutation tools accept a list of IDs/refs — pass [id] for the common single-item case.
Library compatibility
The same gateway serves every BiblioCommons-powered library — see docs/known-libraries.md for what's been verified. If yours isn't listed, file a compatibility report once you try it.
Requirements
- Python 3.11+
- A BiblioCommons library account in good standing (card + PIN)
- The library must run on BiblioCommons (visit
{name}.bibliocommons.comand confirm)
Further reading
docs/architecture.md— gateway client design and API quirksdocs/format-codes.md— format facet codesdocs/troubleshooting.md— common errors and fixesdocs/roadmap.md— what's planned nextdocs/releasing.md— automated release flow