# BookingKoala by Cotlet

Connects AI assistants to BookingKoala store data, letting agents inspect bookings, providers, and customer invoices through a local session.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: cotletdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cotletdev/bookingkoala-api-mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/bookingkoala-by-cotlet

## What it does

BookingKoala lacks an open public API. This integration solves that restriction by tapping into your active browser session. It reads cookies from Google Chrome through DevTools and sends requests via `curl_cffi` to match browser traffic. The setup provides 17 tools covering customer profiles, quotes, charges, and provider rosters.

You need Python 3.11+ and Google Chrome 144 or newer with remote debugging enabled. Your store account permissions directly limit what the tools can do. The local session lasts up to 30 days before requiring a refresh. Note that this open repository is released exclusively for noncommercial use.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://cotlet.dev/mcp/v1/bookingkoala/connect`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http bookingkoala https://cotlet.dev/mcp/v1/bookingkoala/connect
```

2. **Platform CLI**
```bash
claude mcp add bookingkoala-by-cotlet -- uvx bookingkoala-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bookingkoala-api-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add bookingkoala-by-cotlet --url https://cotlet.dev/mcp/v1/bookingkoala/connect
```

2. **Platform CLI**
```bash
codex mcp add bookingkoala-by-cotlet -- uvx bookingkoala-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bookingkoala-api-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bookingkoala-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/bookingkoala/connect"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bookingkoala-by-cotlet": {
            "command": "uvx",
            "args": [
                "bookingkoala-api-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from bookingkoala-api-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bookingkoala-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/bookingkoala/connect"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bookingkoala-by-cotlet": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "bookingkoala-api-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from bookingkoala-api-mcp <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http bookingkoala-by-cotlet https://cotlet.dev/mcp/v1/bookingkoala/connect
```

2. **Platform CLI**
```bash
gemini mcp add bookingkoala-by-cotlet uvx bookingkoala-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bookingkoala-api-mcp <command>

## When to use it
- retrieve unassigned or upcoming store bookings
- inspect customer records and draft quotes
- check charge history and store invoice balances
- view provider details and team allocations

## Example prompts
- List all unassigned bookings for this week
- Find the customer record and show their unpaid invoices
- Check provider team schedules for tomorrow

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md