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

This version

0.6.0

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.6.0.tar.gz (880.2 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.6.0-py3-none-any.whl (492.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bibliocommons_mcp-0.6.0.tar.gz
  • Upload date:
  • Size: 880.2 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.6.0.tar.gz
Algorithm Hash digest
SHA256 c462d3d51bbd9d7b9b033bc2b3c125ebc4cf7760de2bf3bc6faa2bf7f9f5aec2
MD5 812e664bcb2878d7d7c7fe79032d903d
BLAKE2b-256 d5dbf5a9bf90a95536f7cdd00ee329988ebbb7624b916e3f48191eebb02fa63d

See more details on using hashes here.

Provenance

The following attestation bundles were made for bibliocommons_mcp-0.6.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.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for bibliocommons_mcp-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5061d946e910d9be0e8826ced7529d1b7a925e1f765450e6fee9597ae8f8cf32
MD5 8f43d0e70c907d726f119388f1a711fd
BLAKE2b-256 68f314712f93b5a3c2f7540007eac1536650070548babc5c5107e4f12aca314f

See more details on using hashes here.

Provenance

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