BeautyOS by AI Beauty Bot
Free salon CRM: services, staff, clients, online booking and an optional AI receptionist.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http beautyos-by-ai-beauty-bot 'https://agents.ai-beauty.bot/beauty-os/mcp'
{
"mcpServers": {
"beautyos-by-ai-beauty-bot": {
"type": "http",
"url": "https://agents.ai-beauty.bot/beauty-os/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
BeautyOS by AI Beauty Bot
A free salon CRM your AI agent can set up and run: services, staff, clients, online booking and an optional AI receptionist. Available as a Claude Code plugin, Gemini CLI extension, portable Agent Skill and remote MCP connection.
Connect an account, create or pick a salon, import services and prices, organize staff and schedules, complete CRM setup, publish online booking, and optionally configure, test and enable the AI receptionist for supported channels. Salon changes are shown as previews and applied after your confirmation. Passwords and channel credentials are entered only on BeautyOS pages, never in chat.
Learn more at ai-beauty.bot/agents.
Install
Using ChatGPT? You don't need this skill. Open the BeautyOS app for ChatGPT and start chatting.
Choose one installation method for each agent so it has one BeautyOS connection.
Claude Code plugin
claude plugin marketplace add ai-beauty-bot/beauty-os-skill
claude plugin install beautyos@ai-beauty-bot
The plugin includes the BeautyOS skill and remote MCP connection. Start a new session, ask Claude to set up your salon and complete the BeautyOS OAuth sign-in when prompted. You do not need a client secret or API key.
Gemini CLI extension
gemini extensions install https://github.com/ai-beauty-bot/beauty-os-skill
Restart Gemini CLI. Authenticate with /mcp auth beautyos, then ask it to connect
or set up your salon. The extension includes the same skill and MCP connection.
Claude web connector
In Claude's custom connector settings, add
https://agents.ai-beauty.bot/beauty-os/mcp with OAuth. Choose Claude's published
identity or automatic client registration, then sign in to BeautyOS and approve
the salons to share. The return address is
https://claude.ai/api/mcp/auth_callback. This connection does not require
installing the portable skill.
Portable skill: ask your agent to install it
Paste this into your AI agent (Claude Code, Codex, Hermes Agent, Cursor and others):
Install the BeautyOS skill for yourself, for all my projects: run
npx skills add ai-beauty-bot/beauty-os-skill --skill beautyos -g -y -a <agent-id>, replacing<agent-id>with your own id from https://github.com/vercel-labs/skills/blob/main/docs/agents.md (for exampleclaude-code,codexorhermes-agent). Then tell me when to start a new conversation so you can use it.
Portable skill: run the command yourself
Pick the line for your agent and run it in a terminal:
| Agent | Command |
|---|---|
| Claude Code | npx skills add ai-beauty-bot/beauty-os-skill --skill beautyos -g -y -a claude-code |
| Codex | npx skills add ai-beauty-bot/beauty-os-skill --skill beautyos -g -y -a codex |
| Hermes Agent | npx skills add ai-beauty-bot/beauty-os-skill --skill beautyos -g -y -a hermes-agent |
| Other agents | See the supported agent ids |
-g installs the skill for your user rather than into the current folder, -y skips the questions and -a chooses the agent. Keep -a: without it the installer may add the skill for every agent it supports.
After installing, start a new conversation or restart the agent so it finds the skill.
Use
Ask your agent, for example:
Use the BeautyOS skill to set up my salon. Start by connecting my account.
With the helper, the agent shows a BeautyOS link and a short code; with a native MCP connection, your agent opens its own sign-in. Either way, sign in or register in BeautyOS, choose which salons to share, and approve. Setup then continues in the conversation.
Requirements
The skill works with any agent that supports Agent Skills and has one of these:
- BeautyOS connected as a native MCP server. Add
https://agents.ai-beauty.bot/beauty-os/mcpwith OAuth in your agent's MCP settings; the skill then uses those tools directly and needs nothing else. See native MCP setup for Claude Code, Codex, Hermes Agent and other clients. - Script execution with Node.js 22 or later. The bundled helper signs in with a short code, needs no MCP configuration and has no npm dependencies. It needs outbound HTTPS and persistent user storage.
You also need a BeautyOS account; registration is available during sign-in. Plan limits and AI allowances apply.
Plain chat apps with neither option cannot use this skill. In ChatGPT, use the BeautyOS app for ChatGPT instead; the skill points ChatGPT users there too.
MCP endpoint and sign-in
External agents, the plugins in this repository and the helper use
https://agents.ai-beauty.bot/beauty-os/mcp. The published ChatGPT app keeps its
own MCP connection at https://account.ai-beauty.bot/beauty-os/mcp. Both connect
to BeautyOS accounts; OAuth connections and tokens are bound to their respective
server address.
Server and tool descriptions are publicly discoverable on the agents endpoint. Calling tools or reading salon data requires OAuth and the user's current salon permissions. The native MCP guide describes direct connections for clients that already manage MCP servers.
Access and privacy
The points about token storage below apply to the helper; with a native MCP connection your agent stores its own tokens.
- One browser approval grants the skill access to what BeautyOS offers agents. What it can do is limited by the salons you shared and your role in each salon, rechecked on every call.
- Access and refresh tokens are stored in
~/.config/beautyos/(directory0700, files0600), outside the skill and your projects.BEAUTYOS_CONFIG_DIRselects another protected directory. - The helper serializes calls so rotating tokens are not lost, strips private UI data from results, and never retries writes on its own.
- Ask the agent to log out, or revoke the connection at
https://agents.ai-beauty.bot/beauty-os/connections.
Repository layout
.claude-plugin/
plugin.json Claude Code plugin
marketplace.json AI Beauty Bot marketplace
gemini-extension.json Gemini CLI extension
server.json MCP Registry descriptor
assets/logo.png official 512x512 logo
SECURITY.md vulnerability reporting and access model
skills/beautyos/
SKILL.md instructions the agent loads
references/onboarding.md setup sequence and source limits
references/recovery.md error codes and recovery
references/native-mcp.md connecting BeautyOS as a native MCP server
scripts/beautyos.mjs dependency-free MCP and device-sign-in helper
test/ helper and distribution-package tests
Development
npm test
Tests use fake network transports, local package files and temporary storage;
they never contact BeautyOS. The repository packages version 1.0.0 under the MIT
license. Its MCP Registry descriptor uses the namespace bot.ai-beauty/beautyos;
publication in third-party directories is a separate process.
Support
Write to support@ai-beauty.bot or @ai_beauty_support_bot on Telegram.
Report vulnerabilities using the security policy.
License
Questions fréquentes
Qu'est-ce que BeautyOS by AI Beauty Bot ?
Free salon CRM: services, staff, clients, online booking and an optional AI receptionist.
Comment installer BeautyOS by AI Beauty Bot ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http beautyos-by-ai-beauty-bot 'https://agents.ai-beauty.bot/beauty-os/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour BeautyOS by AI Beauty Bot ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
BeautyOS by AI Beauty Bot est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient BeautyOS by AI Beauty Bot ?
Il est publié par ai-beauty-bot. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.