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
borrow_digital Borrow an available digital item
list_holds Show current holds and queue positions
cancel_hold Cancel a hold by ID
list_loans Show checkouts with due dates
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.4.0

0.3.0

This version

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.2.0.tar.gz (225.9 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.2.0-py3-none-any.whl (20.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bibliocommons_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 225.9 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.2.0.tar.gz
Algorithm Hash digest
SHA256 138762cefcbaf33b180ef044a13005df4131fba49fc7834733cd6c6b31287417
MD5 85f1c38643dac7b616d6012a6a90d3fe
BLAKE2b-256 444f96482740cad26f5452461220521058170f991181cf6a9f6991bc5ed3424a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for bibliocommons_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6c64b076c1a584b147bf67096f4c7ef6242d995f7d54fdbf353292d94c770019
MD5 4519d6ed33afb4f305f94e90925927dd
BLAKE2b-256 be1aee1a48d0505f2e46180378f8e99a0b927bead5a1f676e62a163aa04dc1fb

See more details on using hashes here.

Provenance

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