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 something at my branch.

Show my current holds with queue positions.

What's due back this week?

Cancel a hold.

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
`place_hold`	Place physical holds at your pickup branch
`borrow_digital`	Borrow one or more available digital items
`place_digital_hold`	Join the Libby waitlist for unavailable digital items
`list_holds`	Show current holds and queue positions
`ready_for_pickup`	Show only the holds waiting at your branch
`cancel_hold`	Cancel holds (native bulk; one DELETE per call)
`list_loans`	Show checkouts with due dates
`renew_loan`	Renew physical checkouts (native bulk; one PATCH per call)
`check_in_loan`	Return digital checkouts early
`list_branches`	List all branches at your library
`library_health`	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)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bibliocommons_mcp-0.6.1.tar.gz (889.6 kB view details)

Uploaded Jul 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

bibliocommons_mcp-0.6.1-py3-none-any.whl (496.4 kB view details)

Uploaded Jul 24, 2026 Python 3

File details

Details for the file bibliocommons_mcp-0.6.1.tar.gz.

File metadata

Download URL: bibliocommons_mcp-0.6.1.tar.gz
Upload date: Jul 24, 2026
Size: 889.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for bibliocommons_mcp-0.6.1.tar.gz
Algorithm	Hash digest
SHA256	`26c030216acd16317615a559d160ef904bff6b503233e3ed3be9845ddaeac4dd`
MD5	`4185d54b50d164fd3ebd6d63905ac7da`
BLAKE2b-256	`965a8ff0579f2cffbbb96f0292a099e848366c875e1a51fd9f322867345b7c70`

See more details on using hashes here.

Provenance

The following attestation bundles were made for bibliocommons_mcp-0.6.1.tar.gz:

Publisher: publish.yml on pdugan20/bibliocommons-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: bibliocommons_mcp-0.6.1.tar.gz
- Subject digest: 26c030216acd16317615a559d160ef904bff6b503233e3ed3be9845ddaeac4dd
- Sigstore transparency entry: 2231363929
- Sigstore integration time: Jul 24, 2026
Source repository:
- Permalink: pdugan20/bibliocommons-mcp@7087667289badd4993bf11182fd2a7ab48c727b1
- Branch / Tag: refs/tags/v0.6.1
- Owner: https://github.com/pdugan20
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@7087667289badd4993bf11182fd2a7ab48c727b1
- Trigger Event: push