pdugan20/bibliocommons-mcp

MCP server for placing holds, searching, and managing your account at BiblioCommons-powered public libraries.
## Install
bash
pipx install bibliocommons-mcp
Requires Python 3.11+.
## Quick Start
bash
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.
| Tool | Description |
| search | Search the catalog, optionally filtered by format |
| availability | Show per-branch status for a bib |
| placehold | Place physical holds at your pickup branch |
| borrowdigital | Borrow one or more available digital items |
| placedigitalhold | Join the Libby waitlist for unavailable digital items |
| listholds | Show current holds and queue positions |
| readyforpickup | Show only the holds waiting at your branch |
| cancelhold | Cancel holds (native bulk; one DELETE per call) |
| listloans | Show checkouts with due dates |
| renewloan | Renew physical checkouts (native bulk; one PATCH per call) |
| checkinloan | Return digital checkouts early |
| listbranches | List all branches at your library |
| libraryhealth | Check login and report hold quotas |
## 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.com and confirm)