MCP server for BiblioCommons-powered public libraries — search, place holds, manage your account

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for patdugan from gravatar.com patdugan

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: MIT
    SPDX License Expression
  • Author: Pat Dugan
  • Requires: Python >=3.11
  • Provides-Extra: dev
Classifiers
Report project as malware

Project description

bibliocommons-mcp

PyPI CI Python License: MIT

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)

Further reading

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for patdugan from gravatar.com patdugan

Unverified details

These details have not been verified by PyPI
Meta
  • License Expression: MIT
    SPDX License Expression
  • Author: Pat Dugan
  • Requires: Python >=3.11
  • Provides-Extra: dev
Classifiers

Release history Release notifications | RSS feed

0.6.0

This version

0.5.0

0.4.0

0.3.0

0.2.0

0.1.0

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.5.0.tar.gz (838.5 kB view details)

Uploaded Source

Built Distribution

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

bibliocommons_mcp-0.5.0-py3-none-any.whl (489.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bibliocommons_mcp-0.5.0.tar.gz
  • Upload date:
  • Size: 838.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for bibliocommons_mcp-0.5.0.tar.gz
Algorithm Hash digest
SHA256 2163a45d79dfd58c988a7bb58d3cd5d6b16ea2f6c8e086f0991b74a06932bade
MD5 12816666e8c79672a8776d39fcfee5a7
BLAKE2b-256 c8531870f2e57fd7bdd25bb2a91e5c8624ed966ae84e9001de00a0202594da36

See more details on using hashes here.

Provenance

The following attestation bundles were made for bibliocommons_mcp-0.5.0.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.

File details

Details for the file bibliocommons_mcp-0.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for bibliocommons_mcp-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 20e6fe597ed824a61b99bac6df7bcffb0d204199a4c6b5e86cf0bb8a4f5c589f
MD5 74bd154e2a6f0695bb4f39380d4668cf
BLAKE2b-256 2a40821313f4f909695faf508ca4ea0b84c39c6ba9ac14e8b02a5129f27a421a

See more details on using hashes here.

Provenance

The following attestation bundles were made for bibliocommons_mcp-0.5.0-py3-none-any.whl:

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.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page