booking-py

A Python CLI for searching hotels on Booking.com via the MoodTrip MCP HTTP API — no auth required.

Install

uv tool install -e ~/projects/booking-py/

Usage

Search hotels

bpy search --destination "Istanbul" --checkin 2026-04-08 --checkout 2026-04-12 --adults 3 --breakfast --pretty

Hotel details + reviews

bpy hotel <hotel_id> --reviews --pretty

Price trends for a city

bpy price-trend --destination "Istanbul" --month 04 --pretty

Compare two hotels

bpy compare <hotel_id1> <hotel_id2> --pretty

Quick search (lightweight)

bpy quick --destination "Athens" --checkin 2026-05-01 --checkout 2026-05-05

Output

All commands output JSON by default. Add --pretty for rich terminal tables.

API

Uses the MoodTrip MCP HTTP API — a free, no-auth Booking.com search API using the MCP Streamable HTTP protocol (JSON-RPC 2.0).