# Booksy by Cotlet

Самодельный MCP-сервер и REST API к панели Booksy Biz: календарь, клиенты, услуги, отзывы и отчёты прямо из агента.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Автор: cotletdev
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cotletdev/booksy-api-mcp-server
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/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.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://cotlet.dev/mcp/v1/booksy/connect`

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http booksy https://cotlet.dev/mcp/v1/booksy/connect
```

2. **Командой платформы**
```bash
claude mcp add booksy-by-cotlet -- uvx booksy-api-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add booksy-by-cotlet --url https://cotlet.dev/mcp/v1/booksy/connect
```

2. **Командой платформы**
```bash
codex mcp add booksy-by-cotlet -- uvx booksy-api-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "booksy-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/booksy/connect"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "booksy-by-cotlet": {
            "command": "uvx",
            "args": [
                "booksy-api-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "booksy-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/booksy/connect"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "booksy-by-cotlet": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "booksy-api-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http booksy-by-cotlet https://cotlet.dev/mcp/v1/booksy/connect
```

2. **Командой платформы**
```bash
gemini mcp add booksy-by-cotlet uvx booksy-api-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from booksy-api-mcp <команда>

## Когда брать
- вытащить расписание записей на день из панели Booksy Biz
- посмотреть свободные слоты и отгулы мастеров
- собрать список клиентов и услуг из аккаунта
- прочитать отзывы и статистику по салону
- отправить разовую рассылку клиентам через Message Blasts

## Примеры запросов агенту
- Покажи все записи на 27 октября через Booksy
- Выведи список услуг из моей панели Booksy Biz
- Какие свободные слоты есть у мастеров на завтра?

## Похожие
- [Substack by Cotlet](https://affpapa.org/nevibecode/mcp/substack-by-cotlet.md) — MCP-сервер · ★ 3
- [extension-http-outcalls](https://affpapa.org/nevibecode/skills/extension-http-outcalls.md) — скилл · 28100 установок
- [agentmemory-rest-api](https://affpapa.org/nevibecode/skills/agentmemory-rest-api.md) — скилл · 10800 установок
- [agentmemory-architecture](https://affpapa.org/nevibecode/skills/agentmemory-architecture.md) — скилл · 10700 установок
- [api-integration-surface-strategy](https://affpapa.org/nevibecode/skills/api-integration-surface-strategy.md) — скилл · 8000 установок
- [wp-rest-api](https://affpapa.org/nevibecode/skills/wp-rest-api.md) — скилл · 5900 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md