Booksy by Cotlet — MCP-сервер для Claude Code: доступ к Booksy Biz
Самодельный MCP-сервер и REST API к панели Booksy Biz: календарь, клиенты, услуги, отзывы и отчёты прямо из агента.
claude mcp add --transport http booksy https://cotlet.dev/mcp/v1/booksy/connectЧто делает Booksy by Cotlet
Сервер поднимается на вашей машине на Python и работает через вашу же сессию в Google Chrome. Отдельного API для владельцев салонов у Booksy нет, поэтому booksy-mcp connect подключается к браузеру по Chrome DevTools Protocol, забирает сессию из localStorage фрейма web-gateway.booksy.com вместе с cookies и страной панели, и кладёт всё в ~/.config/booksy-api-mcp/session.json. Пароль он не видит.
Дальше каждый вызов инструмента уходит на тот же эндпоинт, что использует веб-панель: <country>.booksy.com/core/v2. Запросы шлёт curl_cffi, повторяя TLS-отпечаток Chrome, без headless-браузера. Всего 28 инструментов: календарь, свободные слоты, отгулы, клиенты, услуги и мастера, отзывы, Message Blasts, Stats & Reports. Есть и REST на http://127.0.0.1:8787/api/v1/booksy с OpenAPI-документацией на /docs, и Python-вызовы вида call("list_appointments", ...).
Нужен Python 3.11 или новее и Chrome 144 или новее с открытой сессией Booksy Biz. Часть отчётов, например Staff Members, требует Booksy Biz Pro, а разовые рассылки Message Blasts уходят только на платном тарифе — на бесплатном триале они не сработают. Лицензия PolyForm Noncommercial разрешает только некоммерческое использование; для команды или круглосуточной работы есть платная версия на cotlet.dev.
Какие задачи решает
- вытащить расписание записей на день из панели Booksy Biz
- посмотреть свободные слоты и отгулы мастеров
- собрать список клиентов и услуг из аккаунта
- прочитать отзывы и статистику по салону
- отправить разовую рассылку клиентам через Message Blasts
Примеры запросов агенту
- Покажи все записи на 27 октября через Booksy
- Выведи список услуг из моей панели Booksy Biz
- Какие свободные слоты есть у мастеров на завтра?
Как установить Booksy by Cotlet
1Командой платформы: удалённый сервер
claude mcp add --transport http booksy https://cotlet.dev/mcp/v1/booksy/connect2Командой платформы
claude mcp add booksy-by-cotlet -- uvx booksy-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>
1Командой платформы: удалённый сервер
codex mcp add booksy-by-cotlet --url https://cotlet.dev/mcp/v1/booksy/connect2Командой платформы
codex mcp add booksy-by-cotlet -- uvx booksy-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>
Файл настроек
{
"mcpServers": {
"booksy-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/booksy/connect"
}
}
}{
"mcpServers": {
"booksy-by-cotlet": {
"command": "uvx",
"args": [
"booksy-api-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>
Файл настроек
{
"servers": {
"booksy-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/booksy/connect"
}
}
}{
"servers": {
"booksy-by-cotlet": {
"type": "stdio",
"command": "uvx",
"args": [
"booksy-api-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http booksy-by-cotlet https://cotlet.dev/mcp/v1/booksy/connect2Командой платформы
gemini mcp add booksy-by-cotlet uvx booksy-api-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Booksy by Cotlet
Как установить Booksy by Cotlet в Claude Code?
Сначала поставьте пакет: uv tool install booksy-api-mcp, затем подключите сессию командой booksy-mcp connect и добавьте сервер в Claude: claude mcp add booksy -- uvx booksy-api-mcp mcp.
Что делает Booksy by Cotlet?
Даёт агенту доступ к панели Booksy Biz: календарь, свободные слоты, отгулы, клиенты, услуги, мастера, отзывы, рассылки и отчёты. Работает через вашу сессию в Chrome, отдельного API у Booksy нет.
Что нужно для работы сервера?
Python 3.11 или новее, Chrome 144 или новее с активной сессией Booksy Biz и аккаунт владельца. Отчёты вроде Staff Members требуют Booksy Biz Pro, а Message Blasts доступны только на платном тарифе.
