Viajante MCP server

Viajante

Flight and hotel search for the terminal, Python, and AI assistants.

Viajante searches Google Flights, Google Hotels, and Booking.com. Use it to compare flights, find cheaper travel dates, explore destinations, or look up places to stay. It runs on your computer and connects directly to the travel sites; no API keys are required.

You can run a search from the command line, call the Python library, or connect an AI assistant through the Model Context Protocol (MCP). Results include prices, itinerary details, source text, and links where available.

Usage guide · Contributing · Report an issue

Install

Requires Python 3.10 or later.

PyPI:

pip install viajante

npx (needs uv and Python 3.10+ on PATH):

npx -y -p @viajante/mcp viajante airports JFK

No install (same uv + Python 3.10+):

uvx --from viajante viajante airports JFK

Quick start

Search for a one-way flight or a hotel stay:

viajante flights JFK-LHR:2026-11-15 --fetch sweep
viajante hotels London 2026-11-15 2026-11-20 --currency GBP --source google

Use future dates when trying the examples. JFK and LHR are airport codes; viajante airports london lists airports for a city so you can choose one.

These searches use HTTP and do not need a browser. Booking.com and the browser mode for Google Flights require the optional browser setup.

Connect an AI assistant

Viajante provides a local MCP server over stdio. Requires uv and Python 3.10+. Add this entry to your assistant's MCP configuration:

{
  "mcpServers": {
    "viajante": {
      "command": "npx",
      "args": ["-y", "@viajante/mcp"]
    }
  }
}

Native Python (no Node):

{
  "mcpServers": {
    "viajante": {
      "command": "uvx",
      "args": ["--from", "viajante[mcp]", "viajante-mcp"]
    }
  }
}

This configuration supports Google Flights and Google Hotels without Chromium. npx still needs uvx (and Python 3.10+) on PATH. If you use an existing Python environment instead, install pip install 'viajante[mcp]' and configure the client to run that environment's viajante-mcp executable.

Once connected, you can ask:

Find a seven-night round trip from BOS to LHR, departing between November 1

and November 30, 2026. Compare the departure dates.

Search for hotels in Tokyo from November 12 to November 16, 2026, for two

adults. Use JPY and require free cancellation.

The server exposes seven tools:

Use the command line

Each search command accepts --save FILE to write a JSON report. Run viajante --help for its options.

Shortened. The full README is on GitHub.