README.md
MCP server to manage meeting room reservations on the Boma platform.
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 BOMA_USER_EMAIL=tu@email.com \
-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
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 authenticationConfiguration
claude_desktop_config.json
{"mcpServers": {"boma": {"command": "node", "args": ["/path/to/boma-mcp/build/index.js"], "env": {"BOMA_USER_EMAIL": "your-email@example.com", "BOMA_USER_PASSWORD": "your-password"}}}}Try 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 example@domain.com?
→Give me an overview of all room bookings for next Monday.