Boma

Provides a dedicated MCP server to manage Boma room reservations, accessible via Claude Code and compatible MCP clients.

typescript

0

GitHub Stars

typescript

Language

3 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nicolasvegam-boma-mcp": {
      "command": "node",
      "args": [
        "/ruta/completa/a/boma-mcp/build/index.js"
      ],
      "env": {
        "BOMA_USER_EMAIL": "YOUR_EMAIL",
        "BOMA_USER_PASSWORD": "YOUR_PASSWORD"
      }
    }
  }
}

The Boma MCP Server lets you manage room reservations for Boma from any MCP client. It supports Claude Code and any client that speaks the MCP protocol, making it easy to search availability, view reservations, and create or modify bookings directly from your preferred tool.

How to use

You connect to the Boma MCP Server using an MCP client. Start by ensuring the server is running locally or remotely, and then issue requests through your client to list rooms, check availability, and manage reservations. The available commands map to rooms, reservations, and user profiles, letting you perform tasks such as querying all reservations for a date, viewing a single reservation, creating a new booking, updating an existing booking, or deleting a booking if you own it.

How to install

Prerequisites: you need Node.js installed on your machine. Node.js enables you to install dependencies, build, and run the MCP server.

Step 1: Clone the repository.

git clone https://github.com/nicolasvegam/boma-mcp.git
cd boma-mcp

Step 2: Install dependencies and build the project.

npm install
npm run build

Step 3: Add the MCP server to Claude Code.

claude mcp add boma \
  -e BOMA_USER_EMAIL=your-email@example.com \
  -e BOMA_USER_PASSWORD=your_password \
  -- node /ruta/completa/a/boma-mcp/build/index.js

Verification

Open Claude Code and ask for available rooms today, for example: What rooms are available today?

Available tools

get_reservations

List all reservations, with optional date filtering.

get_reservations_by_room

Retrieve reservations for a specific room.

get_reservations_by_user

Retrieve all reservations made by a specific user.

get_reservation

Get details for a reservation by its ID.

create_reservation

Create a new room reservation.

update_reservation

Update an existing reservation.

delete_reservation

Delete a reservation (only by the owner).

get_user_profile

Fetch a single user profile.

get_user_profiles

Fetch profiles for multiple users.

search_user

Search for a user by email.

get_available_rooms

List all available rooms.

get_room_availability

Check room availability for a given date.

get_day_overview

Get a summary of all rooms for a specific date.