Google Hotels MCP Server
Google Hotels Model Context Protocol

Get Google Hotels hotel data by chatting with AI.

Paste one prompt into Claude Code, Cursor, or your agent and it installs itself. Your agent then pulls Google Hotels data from plain-English prompts. Same API key, same billing as the REST API.

50 free requests on signup No credit card Any language, no code

Trusted by hospitality teams at

What you can ask

Ask in plain English.
Get real Google Hotels answers.

Whatever you'd ask a junior analyst about a hotel, ask your agent. No syntax to learn.

>

What is the Google rating and review mix for Barcelo Fortina Malta?

>

Compare prices for Barcelo Fortina Malta across booking sites on Google.

>

Find well-reviewed hotels near the Eiffel Tower on Google.

>

Summarize what reviewers mention most often about Barcelo Fortina Malta.

>

Show hotels similar to Barcelo Fortina Malta with their nightly prices.

>

Which rooms at Barcelo Fortina Malta have free cancellation or breakfast on Google, and on which booking sites?

>

Find well-rated pizza places near Times Square on Google Maps with today's opening hours.

Behind the scenes

You type plain English. Your agent calls the right Google Hotels tool.

Real examples. You ask, the agent picks a tool and fills the parameters, you read the answer. These outputs are illustrative.

01 Reviews
You ask

What is the Google rating and review mix for Barcelo Fortina Malta?

Behind the scenes google_travel_resolve(query="Barcelo Fortina Malta") -> google_travel_summary(entity_token=...)
You see

The overall rating with its star histogram and the review topics guests mention most, drawn from the summary Google publishes for the property.

02 Prices
You ask

Compare prices for Barcelo Fortina Malta across booking sites on Google.

Behind the scenes google_travel_resolve(query="Barcelo Fortina Malta") -> google_travel_prices(entity_token=...)
You see

The nightly rate with its usual-price band, plus the partner booking offers Google lists, so you can see which site is cheapest.

03 Search
You ask

Find well-reviewed hotels near the Eiffel Tower on Google.

Behind the scenes google_travel_search(query="hotels near the Eiffel Tower")
You see

About twenty hotel cards for that search, each with its rating, price, and star class, so the well-reviewed options are easy to spot.

Connect it

Paste one sentence. Your agent does the rest.

Copy the prompt into the agent you already have open. It reads our setup page and wires up the connector itself.

Paste into Claude Code
Read https://stayapi.com/install and set up the StayAPI MCP server for me.

Then open a new session and run claude mcp list — stayapi should read ✓ Connected.

No key yet? Sign up for 50 free requests — the agent asks you for it.

Claude on the web, desktop, or mobile doesn't need this prompt: add StayAPI under Settings → Connectors and sign in. ChatGPT: add it as an MCP app in developer mode and sign in. Other clients: manual setup below.

No key

Claude on the web, desktop & mobile

Add StayAPI as a connector and sign in. Nothing to paste.

  1. In Claude, open Settings → Connectors → Add custom connector.
  2. Name it StayAPI and set the URL to https://api.stayapi.com/mcp.
  3. Click Connect, sign in to StayAPI, and choose Allow.
No key

ChatGPT (developer mode)

Add StayAPI as an MCP app and sign in. Plus, Pro, Business, Enterprise, or Edu, on the web.

  1. In ChatGPT, turn on Settings → Security and login → Developer mode.
  2. Open chatgpt.com/plugins, click +, and choose Create MCP app.
  3. Name it StayAPI, set the URL to https://api.stayapi.com/mcp, and pick OAuth. Leave the client ID and secret blank.
  4. Sign in to StayAPI, choose Allow, then install StayAPI from your personal plugins.
  5. In a Work chat, type @StayAPI and ask.
Manual setup — paste the config yourself
01

Claude Code

One terminal command.

bash
claude mcp add --scope user --transport http stayapi https://api.stayapi.com/mcp --header "X-API-Key: YOUR_API_KEY"
  1. Run the command in any terminal.
  2. Open a new Claude Code session.
  3. Confirm with claude mcp list.
02

Cursor

Edit ~/.cursor/mcp.json.

json
{
  "mcpServers": {
    "stayapi": {
      "type": "http",
      "url": "https://api.stayapi.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
  1. Open or create the file.
  2. Paste, swap YOUR_API_KEY, save.
  3. Restart Cursor.
03

Claude Desktop

Edit claude_desktop_config.json.

json
{
  "mcpServers": {
    "stayapi": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote@0.1.18",
        "https://api.stayapi.com/mcp",
        "--header", "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. Open the config file in your OS.
  2. Paste, swap the key, save.
  3. Quit Claude with ⌘ Q, relaunch.

On Windows, a bare npx can fail with spawn npx ENOENT. Use the absolute path to npx.cmd. Windows setup notes →

Full reference — every tool, error shapes, Windows notes: MCP documentation →

Tools for Google Hotels

The Google Hotels tools your agent can call.

Most agents pick the right tool from your prompt, so you never name it. One tool call counts as one request, the same as a REST request.

google_travel_search

Free-text hotel search ("hotels in Lisbon") to about 20 hotel cards per page, with optional dates, adults, currency, and Google's 3.5+/4.0+/4.5+ guest-rating filter. Each card includes rating, nightly and whole-stay price, star class, coordinates, check-in/out times, description, photos, amenity labels, deal note, location score, website, hotel_id, and an entity_token for drilldown; the response carries Google's total_count.

google_travel_resolve

Hotel name to Google Travel entity_token candidates. First step for the other google_travel_* tools.

google_travel_summary

A hotel's review summary by entity_token: overall rating, total count, star histogram, and review-topic sub-scores.

google_travel_reviews

A hotel's individual Google reviews by entity_token: rating, text, reviewer, owner response, with sort and cursor pagination.

google_travel_info

A hotel's identity and metadata by entity_token: name, star class, coordinates, address, phone, check-in/out times, descriptions, website, location score, Maps ids, and amenities (available, absent, and by section; English labels).

google_travel_prices

A hotel's nightly rate, usual-price band, and partner booking offers by entity_token; optional paired YYYY-MM-DD dates plus adults target an explicit stay. Check-in must be today or later and check-out must be after check-in; otherwise Google chooses dates. Currency shapes money fields.

google_travel_rooms

Room-level offers per booking site for one hotel and stay, by entity_token: each site's room types (name, photos, bed and view features) and, per rate, the nightly and whole-stay price, free cancellation (Google's text plus an ISO free_cancellation_until when unambiguous), and breakfast. official: true marks the hotel's own website. Only sites with a Google sponsored listing carry room detail, so expect a few, not every google_travel_prices offer. Same dates, adults, and currency as google_travel_prices. No booking links are returned; use the partner's offer in google_travel_prices for a link.

google_travel_photos

A hotel's photo gallery by entity_token (https URLs, dimensions, and occasional AI caption highlights).

google_travel_similar

Similar hotels and vacation rentals near a hotel (entity_token), each with its own token to pivot to.

google_travel_nearby

Nearby points of interest (attractions, transit, airports, restaurants) with ratings and drive/walk times, by entity_token.

google_reviews_for_place

Get Google reviews for a place, by Google data_id or by query plus optional location. The relative date is always present; iso_date may be null, and iso_date_source says whether it is the exact review time or the reviewer's photo upload time.

google_maps_search

Search Google Maps for places of any kind (restaurants, cafes, attractions, shops, hotels) by free text, with an optional location (lat,lng). Up to 20 ranked places per page (1 to 10), each with data_id, name, categories, address, coordinates, rating, review count, phone, website, today's hours, and live open state. Sponsored results are excluded.

google_maps_place

Google Maps details for one place by data_id: identity ids and Maps link, categories, editorial summary, address and its parts, coordinates, time zone, phone, website, rating with star histogram, review topics, opening hours (plus delivery or takeout hours), attributes, order and reservation links, photos, the owner's name, places inside it, and hotel extras. Reviews come from google_reviews_for_place with the same data_id.

Full parameters and response shapes live in the MCP docs. For the same data over REST, see the Google Hotels API hub.

Point your agent at Google Hotels.

Sign up, paste one prompt, let your agent install itself. Both paths end with your agent answering Google Hotels questions in plain English.

01 · the fast path

Get your key

50 free requests on signup. Paste one prompt into your agent, then start asking it for Google Hotels data.

Start free Read the MCP docs
  • 50 free requests, no credit card
  • Same key as the REST API
  • Any language, no code
02 · talk to us

Talk through your use case

15 minutes. We screen-share and wire Claude or Cursor to your real properties. Free of charge.

Book a demo
  • Working setup on the call
  • Your properties, your prompts
  • Engineering, not sales