space-booking-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
space-booking-mcp
A reference Model Context Protocol (MCP) server that lets an AI assistant such as Claude or ChatGPT book shared spaces (meeting rooms, desks, amenities) on behalf of a signed-in user.
Its main idea is profile-based routing: the assistant sees one small set of tools, and the server sends each call to the right booking system for that user, with that system's own rules. A corporate user and a residential user can ask the same question and get answers from different back ends.
It is a runnable example, not a product. The booking systems are in-memory so you can try everything without any external service, and the adapter interface shows where your real APIs plug in.
What it demonstrates
Six well-described tools:
whoami,list_spaces,check_availability,book_space,list_my_bookings,cancel_bookingProfile routing from the user's account type to a backend adapter (architecture)
Different rules per backend (opening hours, maximum duration, active-booking limits), reported to the model through
whoamiso it can plan within themErrors written for the model: a clash says what is taken and which tool to call next
Safety basics: tenant isolation, ownership checks, strict input validation, and tool annotations that mark read-only and destructive tools (security notes)
Built on the official MCP Python SDK, with tests that talk to the server through a real MCP client
Related MCP server: lig-room
Quick start
git clone https://github.com/brdiniz/space-booking-mcp.git
cd space-booking-mcp
pip install -e ".[dev]"
pytestRun it as a local (stdio) server, acting as one of the demo users:
BOOKING_USER_ID=u-corp-1 python -m space_booking_mcp # corporate user
BOOKING_USER_ID=u-res-1 python -m space_booking_mcp # residential userTo connect it to an assistant or inspect it, see docs/connecting.md.
Example conversation (illustrative)
You: Book the Atlas room tomorrow at 10 for an hour.
The assistant calls
whoami(a corporate account, up to 8 hours per booking),check_availabilityforroom-atlas, confirms the details with you, then callsbook_space.You: Actually, cancel it.
The assistant calls
list_my_bookings, finds the booking, and callscancel_booking.
A residential user asking for "the gym for three hours" gets a clear refusal from the server (the limit for that account type is two hours), and the assistant can offer a two-hour slot instead.
Project layout
src/space_booking_mcp/
server.py Tool definitions (the MCP surface)
router.py Chooses a backend from the user's profile
auth.py Who is calling (demo: fixed user per process)
backends/base.py The adapter interface your real systems implement
backends/in_memory.py Thread-safe demo backends with different rules
models.py Typed inputs and outputs
tests/ Backend rules, isolation, and end-to-end tool calls
docs/ Architecture, connecting clients, securityPlugging in a real booking system
Implement
BookingBackend(five methods) for your API.Register it in the router under a
Profile.Keep tenant isolation and ownership checks inside the adapter or the API behind it.
Replace
StaticUserAuthwith identity taken from a verified access token (see security).
Limitations
Data lives in memory and is lost on restart.
The demo identity is one fixed user per server process. A shared remote deployment needs per-request authentication before it is safe to expose.
Prices, payments, notifications and recurring bookings are out of scope.
Need an MCP server for your product?
I help teams design and ship MCP servers and AI assistants that act safely on real systems: tool design, authentication, evaluation and rollout. Contact: brdiniz@icloud.com
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Booking engine for rooms, desks, sessions and courses: listings, rates, availability and bookings.
Find free rooms and book, change or cancel them. Sign in from Claude, ChatGPT or Grok Bot.
Scheduling infrastructure for AI agents across Google and Microsoft calendars.
Scheduling for AI assistants: bookings, availability, meeting polls and routing forms.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables interaction with the DiSH room booking platform to search availability, create bookings, and manage reservations. It allows AI assistants to handle meeting room logistics directly through natural language commands.3-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to search for available desk space, submit room reservations, and let admins approve or reject booking requests through a scoped MCP API.-
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to discover availability, place expiring holds, and confirm or cancel appointments for connected booking businesses, with idempotent retries and explicit user consent.1Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to manage appointments, reschedule bookings, look up clients, and add client notes in a user's signed-in business account without requiring an API key.7Elastic 2.0