Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/nicolasvegam/boma-mcp.git
cd boma-mcp
npm install
npm run build2
Register it in Claude Code
claude mcp add -e "BOMA_USER_EMAIL=${BOMA_USER_EMAIL}" -e "BOMA_USER_PASSWORD=${BOMA_USER_PASSWORD}" boma-mcp -- node /path/to/boma-mcp/build/index.jsReplace any placeholder paths in the command with the real path on your machine.
Required:
BOMA_USER_EMAILBOMA_USER_PASSWORD3
Make your agent remember this setup
boma-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Manage meeting room reservations on the Boma platform
- Check real-time room availability
- Search and retrieve user profiles
- Create, update, and delete room bookings
- Get daily overviews of room usage
Tools 13
get_reservationsList reservations, optionally filtered by date.get_reservations_by_roomGet reservations for a specific room.get_reservations_by_userGet reservations for a specific user.get_reservationGet details of a reservation by ID.create_reservationCreate a new reservation.update_reservationModify an existing reservation.delete_reservationDelete a reservation (only the owner).get_user_profileGet a user profile.get_user_profilesGet profiles for multiple users.search_userSearch for a user by email.get_available_roomsList all available rooms.get_room_availabilityCheck availability of a room on a specific date.get_day_overviewGet a summary of all rooms on a specific date.Environment Variables
BOMA_USER_EMAILrequiredEmail address for Boma authenticationBOMA_USER_PASSWORDrequiredPassword for Boma authenticationTry it
→What rooms are available today?
→Show me all my reservations for this week.
→Book the Big Mike room for tomorrow from 10 AM to 11 AM.
→Who is the user with the email [email protected]?
→Give me an overview of all room bookings for next Monday.
Original README from Nicolasvegam/boma-mcp
Boma MCP
Servidor MCP para gestionar las reservas de salas en Boma. Funciona con Claude Code y cualquier cliente compatible con el protocolo MCP.
Salas disponibles
| Sala | Capacidad |
|---|---|
| Big Mike | 8 personas |
| Gran Enana | 2 personas |
| Lakatán | 4 personas |
| Dacca | 4 personas |
| Cavendish | 4 personas |
| Dominico | 2 personas |
Instalación
1. Clonar el repositorio
git clone https://github.com/nicolasvegam/boma-mcp.git
cd boma-mcp
2. Instalar dependencias y compilar
npm install
npm run build
3. Agregar a Claude Code
claude mcp add boma \
-e [email protected] \
-e BOMA_USER_PASSWORD=tu_password \
-- node /ruta/completa/a/boma-mcp/build/index.js
Reemplaza /ruta/completa/a/boma-mcp con la ruta donde clonaste el repo y usa tus credenciales de Boma.
Verificar
Abre Claude Code y pregunta algo como:
¿Qué salas hay disponibles hoy?
Tools disponibles
Reservas
- get_reservations - Listar reservas (opcionalmente filtrar por fecha)
- get_reservations_by_room - Reservas de una sala específica
- get_reservations_by_user - Reservas de un usuario
- get_reservation - Detalle de una reserva por ID
- create_reservation - Crear una nueva reserva
- update_reservation - Modificar una reserva existente
- delete_reservation - Eliminar una reserva (solo el dueño)
Usuarios
- get_user_profile - Perfil de un usuario
- get_user_profiles - Perfiles de varios usuarios
- search_user - Buscar usuario por email
Calendario
- get_available_rooms - Listar todas las salas
- get_room_availability - Disponibilidad de una sala en una fecha
- get_day_overview - Resumen de todas las salas en una fecha
Desarrollo
npm run dev # Compilar en modo watch
npm run build # Compilar para producción
npm start # Ejecutar el servidor
Licencia
MIT