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

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