Repository avatar
Other Tools
v1.0.2
active

brelio

eu.brelio/brelio

Beauty salon management: appointments, clients, services and stats for your Brelio salon

Documentation

Brelio MCP server

Brelio is salon management software for beauty salons: online booking, calendar, clients, services and payments. Connect your AI assistant to your Brelio salon and ask it about your schedule and revenue, or have it book appointments for you.

Claude reads a salon's week and books an appointment through Brelio, and the booking shows in the Brelio calendar

  • Server URL: https://brelio.eu/api/mcp (Streamable HTTP, OAuth 2.1 with dynamic client registration)
  • Website: brelio.eu · Privacy policy

Connect

Claude (claude.ai, desktop and mobile): Settings → Connectors → Add custom connector → paste https://brelio.eu/api/mcp. Claude opens the Brelio sign-in page: sign in with your salon account and allow access.

Claude Code:

claude mcp add --transport http brelio https://brelio.eu/api/mcp

Clients without OAuth can use an API key from Brelio → Settings → MCP, sent as Authorization: Bearer <key>.

Then ask something like: "What's on my schedule this week, and how did this month go?" or "Book Maja Nowak for a manicure on Friday at 16:00."

Tools

ToolWhat it does
get_appointmentsAppointments with client and service, filtered by dates and status
get_clientsClients, searchable by name or phone
list_servicesServices with duration and price
get_statsAppointments, completed visits and revenue for today, the week, the month or the year
create_appointmentBooks a confirmed appointment; a new client is added if needed

Public help server (no sign-in)

https://brelio.eu/api/mcp/help is a second, public MCP server. Any assistant can use it without an account to answer questions about Brelio:

claude mcp add --transport http brelio-help https://brelio.eu/api/mcp/help
ToolWhat it does
brelio_search_helpSearches the help pages: features, how-to guides, troubleshooting
brelio_get_helpA help page in full
brelio_list_articlesThe blog for salon owners, in Polish or English
brelio_get_articleA blog article in full
brelio_get_plansPlans and prices, the stylist limit, included message credits, the free trial

Source

The server is part of the Brelio web app (Next.js on Vercel, Supabase). This repository holds its MCP and OAuth code as it runs in production:

PathWhat it is
src/app/api/mcp/route.tsThe MCP endpoint: Streamable HTTP, JSON-RPC, protocol version negotiation
src/lib/mcp/tools.tsThe tools, each scoped to the signed-in salon owner
src/app/api/mcp/help/route.ts, src/lib/mcp/help.tsThe public help server; scripts/build-mcp-help.ts bundles the help pages
src/lib/mcp/auth.tsBearer resolution: a salon API key or an OAuth access token
src/app/api/oauth/*OAuth 2.1: dynamic client registration, authorization with PKCE (S256), tokens and refresh
src/app/.well-known/*Authorization server and protected resource metadata
supabase/migrations/20260512000001_mcp_oauth.sqlThe API key column and the OAuth tables

Imports such as @/lib/supabase/admin and @/lib/supabase/server are the app's Supabase clients and aren't included; this code is for reading, not a standalone server.

Privacy

The server acts only as the signed-in salon owner and reads and writes only that salon's data. Access can be revoked by removing the connector or regenerating the API key in Brelio.

No installation packages available.