HasData/google-hotels-mcp

A hosted Model Context Protocol (MCP) server that gives Claude, Cursor, Windsurf and any other MCP client one Google Hotels tool. Search hotels and vacation rentals for a destination and a pair of dates, then open any property in full with the rate every booking site is charging, ratings, a review breakdown by topic, amenities, photos and coordinates, all as structured JSON, with no Google account and no Places API quota.
**1,000 free credits every month, no card required**, which is about 100 hotel searches.
- Prompts and resources
Contents
- What you need
- Quick start
- Example prompts
- Tools
- Errors and failure paths
- Pricing, free tier and limits
- Tool selection
- How it compares
- FAQ
- HasData links
- Development
- Contributing
- License
What you need
An MCP client and a HasData API key from the dashboard, free to create with no card, and the free tier covers about 100 calls a month at the 10-credit rate. This is a remote server, so the simplest path is a URL and an x-api-key header, with no container to run and no Google Cloud project anywhere in the flow. A client that only speaks stdio reaches it through a thin launcher, published as @hasdata/google-hotels-mcp on npm and hasdata-google-hotels-mcp on PyPI, shown below.
Quick start
The server URL is the same for every client. We run it hands-on in Claude Code and Claude Desktop. The other blocks follow each client's own documented format for a remote server.
| Field | Value |
| :--- | :--- |
| URL | https://mcp.hasdata.com/mcp?apis=google_travel_hotels |
| Transport | HTTP, streamable |
| Auth header | x-api-key: HASDATA_API_KEY |
Clients with OAuth support can add the same URL as a connector and sign in without putting a key in a config file.
Claude Code
Claude Desktop
Settings, then Connectors, then Add custom connector, then paste https://mcp.hasdata.com/mcp?apis=google_travel_hotels and sign in.
For the config-file route, Claude Desktop loads only local (stdio) servers, so it reaches a remote server through a stdio launcher. The @hasdata/google-hotels-mcp package is that launcher, and it reads the key from the environment. Add this to claude_desktop_config.json:
For Python instead of Node, swap the launcher for the PyPI package, which uvx runs without a manual install:
Cursor
~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:
Windsurf
~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:
VS Code
.vscode/mcp.json in the workspace:
Example prompts
Prompts, not code. Paste one in and the agent picks the tool itself. Each is annotated with the calls it takes, because every successful call costs 10 credits.
> Find hotels in Barcelona for the nights of 12 to 15 November, two adults, and list the five cheapest with nightly rate, rating and class.
*One call, 10 credits. Rates, ratings and amenities all come back together.*
> Same stay, four stars and up, free cancellation only, sorted by rating.
*One call, 10 credits. Class, cancellation and sort order are filters on the one request.*
> Take the top result and show what each booking site charges for it, and whether that is a good price.
*Two calls, 20 credits. The search hands back a propertyToken per property, and passing it in opens that property with every source Google compares, a typical price range and Google's own verdict on the deal.*
> Vacation rentals in Lisbon that week with at least two bedrooms and a pool.
*One call, 10 credits, with vacationRentals on, bedrooms at 2 and the pool in amenity__.*
Name the destination the way you would say it out loud. A bare Barcelona is read against wherever Google believes the search is running from, so a server in California answers with Californian hotels. Either write hotels in Barcelona or set gl to es, and the city is pinned.
Tools
| Tool | What it returns |
| --- | --- |
| hasdata_google_travel_hotels_getGoogleHotels | Properties with nightly and total rate, class, rating, review counts and a breakdown by topic, amenities, images, coordinates and nearby transit, alongside pagination and the brand tree. Given a propertyToken it returns that one property with the rate at every source Google compares, address, phone and a typical price range. 10 credits a call |