BookingKoala by Cotlet — Claude Code MCP server: setup guide
Connects AI assistants to BookingKoala store data, letting agents inspect bookings, providers, and customer invoices through a local session.
claude mcp add --transport http bookingkoala https://cotlet.dev/mcp/v1/bookingkoala/connectWhat BookingKoala by Cotlet 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.
What it helps with
- 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 for the agent
- List all unassigned bookings for this week
- Find the customer record and show their unpaid invoices
- Check provider team schedules for tomorrow
How to install BookingKoala by Cotlet
1Platform CLI: remote server
claude mcp add --transport http bookingkoala https://cotlet.dev/mcp/v1/bookingkoala/connect2Platform CLI
claude mcp add bookingkoala-by-cotlet -- uvx bookingkoala-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from bookingkoala-api-mcp <command>
1Platform CLI: remote server
codex mcp add bookingkoala-by-cotlet --url https://cotlet.dev/mcp/v1/bookingkoala/connect2Platform CLI
codex mcp add bookingkoala-by-cotlet -- uvx bookingkoala-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from bookingkoala-api-mcp <command>
Config file
{
"mcpServers": {
"bookingkoala-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/bookingkoala/connect"
}
}
}{
"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>
Config file
{
"servers": {
"bookingkoala-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/bookingkoala/connect"
}
}
}{
"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>
1Platform CLI: remote server
gemini mcp add -t http bookingkoala-by-cotlet https://cotlet.dev/mcp/v1/bookingkoala/connect2Platform CLI
gemini mcp add bookingkoala-by-cotlet uvx bookingkoala-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from bookingkoala-api-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about BookingKoala by Cotlet
How to install BookingKoala by Cotlet in Claude Code?
For local stdio execution, run claude mcp add bookingkoala-by-cotlet -- uvx bookingkoala-api-mcp. If using the hosted web endpoint, run claude mcp add --transport http bookingkoala-by-cotlet https://cotlet.dev/mcp/v1/bookingkoala/connect.
What does BookingKoala by Cotlet do?
It allows MCP clients to read and modify store records inside BookingKoala. Agents can query bookings, update providers, and manage customer billing.
What are the prerequisites for this server?
The tool requires Python 3.11+, Google Chrome 144+ signed into the store admin, and an administrator account. The session extractor pulls tokens directly from Chrome without running a headless browser.
