HasData Google Hotels

Google Hotels MCP Server

A hosted Google Hotels 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.

https://mcp.hasdata.com/mcp?apis=google_travel_hotels

• 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.

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 mcp add --transport http google-hotels "https://mcp.hasdata.com/mcp?apis=google_travel_hotels" \

--header "x-api-key: HASDATA_API_KEY"

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:

{

"mcpServers": { "google-hotels": { "command": "npx", "args": ["-y", "@hasdata/google-hotels-mcp"], "env": { "HASDATA_API_KEY": "YOUR_KEY" } } } }

For Python instead of Node, swap the launcher for the PyPI package, which uvx runs without a manual install:

{

"mcpServers": { "google-hotels": { "command": "uvx", "args": ["hasdata-google-hotels-mcp"], "env": { "HASDATA_API_KEY": "YOUR_KEY" } } } }

Cursor

~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:

{

"mcpServers": { "google-hotels": { "url": "https://mcp.hasdata.com/mcp?apis=google_travel_hotels", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

Windsurf

~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:

{

"mcpServers": { "google-hotels": { "serverUrl": "https://mcp.hasdata.com/mcp?apis=google_travel_hotels", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

VS Code

.vscode/mcp.json in the workspace:

{

"servers": { "google-hotels": { "type": "http", "url": "https://mcp.hasdata.com/mcp?apis=google_travel_hotels", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

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

One tool, read-only, covering both halves of the site. Without a propertyToken it searches. With one it opens a single property.

The samples below are trimmed from real calls, and hotel rates move daily. Read them as a shape.

A sample is the payload, not the whole response. A tools/call result carries one text block, and that text is itself JSON holding url, status, text and json, with the scraped data under json. From a raw JSON-RPC response the path is result.content[0].text, parsed, then .json. A chat client unwraps that for you and code talking to the endpoint directly does not.

Search hotels and vacation rentals

hasdata_google_travel_hotels_getGoogleHotels

Properties for a destination and a stay, with rates, ratings, amenities and images.

Results arrive under properties, roughly twenty per page. Each property carries name, type, description, link, gpsCoordinates, ratePerNight and totalRate (each with the raw string and an extracted* number), hotelClass with extractedHotelClass, overallRating, reviews, locationRating, a ratings histogram, reviewsBreakdown with positive and negative mentions per topic, amenities, images and nearbyPlaces with walking and transit times. searchInformation.totalResults reports how many Google has, pagination carries nextPageToken, and brands lists the brand tree with the ids the brands filter takes.

Rates are quoted two ways. lowest includes taxes and fees, beforeTaxesFees does not, and a property may carry only one of them. Compare like with like before ranking.

{

"name": "Casa Gràcia", "propertyToken": "ChcI0r6-2uyF7rIuGgsvZy8xdmo2bnNxZhAB", "type": "hotel", "description": "Cozy quarters in a hip lodging with dining & a lively bar, plus a kitchen, a library & free Wi-Fi.", "link": "https://room00hostel.com/barcelona/casa-gracia-hostel/", "gpsCoordinates": { "latitude": 41.3974523, "longitude": 2.1593339 }, "ratePerNight": { "beforeTaxesFees": "US$61", "extractedBeforeTaxesFees": 61 }, "totalRate": { "beforeTaxesFees": "US$182", "extractedBeforeTaxesFees": 182 }, "hotelClass": "4-star hotel", "extractedHotelClass": 4, "overallRating": 3.9, "reviews": 3811, "locationRating": "4.6", "amenities": ["Breakfast", "Air conditioning", "Airport shuttle", "Kid-friendly"], "nearbyPlaces": [ { "name": "La Pedrera - Casa Milà", "transportations": [{ "type": "Walking", "duration": "5 min" }] } ] }

One property in full

Pass propertyToken from any search result back into the same tool, keeping the dates, and the answer is that property alone. On top of the search fields it adds prices, the rate at every source Google compares, featuredPrices for the sponsored ones, typicalPriceRange for the stay, deal and dealDescription when Google