BeautyOS by AI Beauty Bot

Official registry E-commerce

Free salon CRM: services, staff, clients, online booking and an optional AI receptionist.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http beautyos-by-ai-beauty-bot 'https://agents.ai-beauty.bot/beauty-os/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "beautyos-by-ai-beauty-bot": {
            "type": "http",
            "url": "https://agents.ai-beauty.bot/beauty-os/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. BeautyOS by AI Beauty Bot
  2. Install
  3. Use
  4. Requirements
  5. MCP endpoint and sign-in
  6. Access and privacy
  7. Repository layout
  8. Development
  9. Support
  10. License

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 example claude-code, codex or hermes-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:

AgentCommand
Claude Codenpx skills add ai-beauty-bot/beauty-os-skill --skill beautyos -g -y -a claude-code
Codexnpx skills add ai-beauty-bot/beauty-os-skill --skill beautyos -g -y -a codex
Hermes Agentnpx skills add ai-beauty-bot/beauty-os-skill --skill beautyos -g -y -a hermes-agent
Other agentsSee 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/mcp with 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/ (directory 0700, files 0600), outside the skill and your projects. BEAUTYOS_CONFIG_DIR selects 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

MIT

Frequently asked questions

What is BeautyOS by AI Beauty Bot?

Free salon CRM: services, staff, clients, online booking and an optional AI receptionist.

How do I install BeautyOS by AI Beauty Bot?

It runs as a remote server. In Claude Code: claude mcp add --transport http beautyos-by-ai-beauty-bot 'https://agents.ai-beauty.bot/beauty-os/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does BeautyOS by AI Beauty Bot need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is BeautyOS by AI Beauty Bot open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains BeautyOS by AI Beauty Bot?

It is published by ai-beauty-bot. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.