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

Tool Description
search Search the catalog, optionally filtered by format
availability Show per-branch status for a bib
place_hold Place a physical hold at your pickup branch
place_holds Place holds on multiple bibs at the same branch
borrow_digital Borrow an available digital item
place_digital_hold Join the Libby waitlist for an unavailable digital item
list_holds Show current holds and queue positions
ready_for_pickup Show only the holds waiting at your branch
cancel_hold Cancel one hold by ID
cancel_holds Cancel multiple holds in a single round-trip
list_loans Show checkouts with due dates
renew_loan Renew one checkout by ID
renew_loans Renew multiple checkouts in one PATCH
check_in_loan Return a digital checkout early
check_in_loans Return multiple digital checkouts
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.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.3.0.tar.gz (763.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.3.0-py3-none-any.whl (461.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bibliocommons_mcp-0.3.0.tar.gz
  • Upload date:
  • Size: 763.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.3.0.tar.gz
Algorithm Hash digest
SHA256 ffadab1fe4deb5378b6e812f5ef220c36ffcd4bd7fbe29625d42f8fdb1060338
MD5 7c0864be94259e8ce2e02c60351faad5
BLAKE2b-256 a514863b3039380299d2206c2c73257b9096f924b8bb65f43ecf29f69c937de1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for bibliocommons_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f939bb1ce3a6c85dcf3d94cb65bc98fe974f6f6072cbf4caffbd13aaca2d9beb
MD5 e434c7f2a8936ba17d3766ce4ad7275f
BLAKE2b-256 b7216006e72152c632a13314a27672738c1aa4e62059cd1aac049435a8a18242

See more details on using hashes here.

Provenance

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