Google Hotels Scraper MCP server
Commit Oct 10, 2026Retrieves hotel prices, ratings, amenities, and deal information from Google Hotels for specific cities and dates.
Also known as RalfIJ/google-hotels-api, google-hotels-api
- Stars
- 0
- Tools
- 5
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 10, 2026
- License
- MIT
What is Google Hotels Scraper MCP?
Google Hotels Scraper retrieves hotel prices, ratings, amenities, and deal information from Google Hotels for specific cities and dates. It exposes 5 tools, such as get-actor-run, get-dataset-items, get-key-value-store-record.
Summary generated from the project's README
About Google Hotels Scraper MCP server
Extracting hotel pricing and amenity data from Google Hotels for specific cities and dates is what this server enables. It provides developers and AI clients with access to nightly rates, total stay costs including taxes, guest ratings, star classes, and specific amenities. Because Google does not offer a public API for reading these prices, this tool uses a hosted scraper on Apify to retrieve information from the first page of search results.
Users connect to the server via an Apify API token or by signing in through an MCP client like Claude, Cursor, or VS Code. The service is billed through your own Apify account, though a free plan provides five dollars of monthly credit which covers over 1,000 hotel price lookups. It functions by loading search pages without a browser and uses residential IPs to manage requests. The data includes hotel IDs, coordinates, and deal notes such as whether a price is lower than usual.
What you can do with it
- 1Identify the cheapest travel weekendScan upcoming weekends to determine which dates offer the lowest median hotel rates.
- 2Monitor hotel price fluctuationsTrack hotel costs daily to identify properties that have dropped in price by at least ten percent.
Written from the project's README. Every use case is checked against a quote from it.
How to install Google Hotels Scraper MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Google Hotels Scraper MCP in Claude Code
$ claude mcp add --transport http google-hotels-api 'https://mcp.apify.com/?tools=ralfij/google-hotels-scraper'Install Google Hotels Scraper MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"google-hotels-api": {
"url": "https://mcp.apify.com/?tools=ralfij/google-hotels-scraper"
}
}
}Install Google Hotels Scraper MCP in VS Code
.vscode/mcp.json
{
"servers": {
"google-hotels-api": {
"type": "http",
"url": "https://mcp.apify.com/?tools=ralfij/google-hotels-scraper"
}
}
}Install Google Hotels Scraper MCP in VS Code CLI
$ code --add-mcp '{"name":"google-hotels-api","type":"http","url":"https://mcp.apify.com/?tools=ralfij/google-hotels-scraper"}'Install Google Hotels Scraper MCP in Codex
$ codex mcp add google-hotels-api --url 'https://mcp.apify.com/?tools=ralfij/google-hotels-scraper'Install Google Hotels Scraper MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.google-hotels-api] url = "https://mcp.apify.com/?tools=ralfij/google-hotels-scraper"
Install Google Hotels Scraper MCP in Gemini CLI
$ gemini mcp add -s user --transport http google-hotels-api 'https://mcp.apify.com/?tools=ralfij/google-hotels-scraper'Install Google Hotels Scraper MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"google-hotels-api": {
"url": "https://mcp.apify.com/?tools=ralfij/google-hotels-scraper",
"type": "http"
}
}
}Google Hotels Scraper MCP tools 5
Read from the server with tools/listget-actor-runRead-onlyGet detailed information about a specific Actor run. Returns run result: status, storages (datasets/keyValueStores alias map), stats, summary, nextStep. - summary describes the past (e.g. "SUCCEEDED in 22s. 47 items; 3 fields available."). - nextStep prescribes one primary follow-up action with identifiers interpolated (e.g. "Use get-dataset-items with datasetId=..."). - waitSecs (0–45, default 30) waits up to that many seconds for terminal status before returning. USAGE: - Use to check the status of a run started by any Actor-running tool. - Pass waitSecs > 0 to block until terminal (or until the cap elapses). USAGE EXAMPLES: - user_input: Show details of run y2h7sK3Wc - user_input: Wait for run y2h7sK3Wc to finish
get-dataset-itemsRead-onlyGet items (rows) from a dataset — the output/results produced by an Actor run. Returns the rows themselves, not dataset metadata, counts, or a schema. When the user provides a datasetId and asks to retrieve results, output, data, or rows, call this tool directly. Default limit is 20. Use clean=true to skip empty items and hidden fields. USAGE: - Use when you need to read data from a dataset (all items or only selected fields). USAGE EXAMPLES: - user_input: Retrieve results from dataset abc123 - user_input: Get only metadata.url and title from dataset username~my-dataset
get-key-value-store-recordRead-onlyGet the value stored under a specific key in a key-value store — a single record, not a listing of all keys. Requires the exact key name. The response preserves the original Content-Encoding; most clients handle decompression automatically. A record over 262144 bytes is returned as a link to download it, not as its value. USAGE: - Use when you need to retrieve a specific record (JSON, text, or binary) from a store. USAGE EXAMPLES: - user_input: Get record INPUT from store abc123 - user_input: Get record data.json from store username~my-store
abort-actor-runActionAbort an Actor run that is currently starting or running. For runs with status SUCCEEDED, FAILED, ABORTING, ABORTED, or TIMED-OUT, this call has no effect. The results will include the updated run details after the abort request. USAGE: - Use when you need to stop a run that is taking too long or misconfigured. USAGE EXAMPLES: - user_input: Abort run y2h7sK3Wc - user_input: Gracefully abort run y2h7sK3Wc
ralfij--google-hotels-scraperActionThis tool calls the Actor "ralfij/google-hotels-scraper" and retrieves its output results. Actor description: Hotel prices from Google Hotels for any city and dates: nightly and total price with taxes, deals, rating, reviews, star class, amenities and coordinates. Fast HTTP-only scraper, pay per hotel.
Configuration
APIFY_TOKEN
Automated checks
Ran Nov 16, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableralfij/google-hotels-api is public and reachablegithub.com/ralfij/google-hotels-api ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-10github.com/ralfij/google-hotels-api ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-11-25 in 1164 ms; tools/list returned 5 tools (HostedMCP test account)Pass
README
View on GitHubGoogle Hotels API for Python
Get hotel prices from Google Hotels into Python for any city and dates: the nightly price, the total for your stay with taxes and fees, Google's deal note ("23% less than usual"), guest rating, review count, star class, amenities and coordinates. Google Hotels compares booking sites and the hotels' own websites, so one search gives you the going rate.
Google has no public API for reading hotel prices. Its hotel APIs are for travel partners that send their prices to Google. These examples use a hosted scraper instead, the Google Hotels Scraper on Apify, through the official Python client.

Example output: the median price per night of the first 20 hotels Google shows in 8 cities, for 2 adults on the weekend of 13 to 15 November 2026. Made with examples/compare_cities.py.
Quick start
- Create a free Apify account. The free plan includes $5 of credit every month, which covers more than 1,000 hotel prices. No credit card needed.
- Copy your API token from Settings > API & Integrations in Apify Console.
- Run an example:
pip install -r requirements.txt
export APIFY_TOKEN=your-token # Windows: set APIFY_TOKEN=your-token
python examples/search_hotels.py
hotel stars rating a night, all-in
The Central House Lisbon Baixa 2 4.3 53 EUR
Lisbon Wine House - Rooms & Suites 3 3.7 68 EUR
Next Level Premium Hotels Lisbon 3 4.7 76 EUR
Novotel Lisboa 4 4 83 EUR
...
Saved 20 hotels to hotels.csv
Examples
| File | What it does |
|---|---|
examples/search_hotels.py |
Hotels for one city and date range, cheapest first, saved as CSV |
examples/compare_cities.py |
The same dates in several cities, with the chart above |
examples/cheapest_weekend.py |
Prices for the next 8 weekends, to find the cheapest one |
examples/price_tracker.py |
Run it daily: keeps a price history and lists hotels that got at least 10% cheaper |
sample-output/hotels-lisbon-2026-11-13.csv shows the CSV from search_hotels.py.
Finding the cheapest weekend
cheapest_weekend.py for Amsterdam, run on 10 October 2026:
Fri 16 Oct to Sun 18 Oct: median EUR 191, cheapest EUR 97 a night
Fri 23 Oct to Sun 25 Oct: median EUR 302, cheapest EUR 28 a night
Fri 30 Oct to Sun 01 Nov: median EUR 140, cheapest EUR 88 a night
Fri 06 Nov to Sun 08 Nov: median EUR 177, cheapest EUR 104 a night
Fri 13 Nov to Sun 15 Nov: median EUR 135, cheapest EUR 96 a night
Fri 20 Nov to Sun 22 Nov: median EUR 133, cheapest EUR 89 a night
Fri 27 Nov to Sun 29 Nov: median EUR 141, cheapest EUR 86 a night
Fri 04 Dec to Sun 06 Dec: median EUR 132, cheapest EUR 78 a night
Cheapest weekend: 04 December (median EUR 132 a night, taxes included)
The weekend of 23 October costs more than twice as much as the cheapest one. That's the Amsterdam Dance Event, which runs from 21 to 25 October.
What you get per hotel
pricePerNightas Google shows it, andtotalPricefor the whole stay with taxes and fees, plustotalPriceBeforeTaxesandtaxesAndFeeswhen Google shows the splitdealText, such as "23% less than usual"rating,reviewCount,hotelClass(stars) andpropertyType(hotel, hostel, vacation rental and so on)amenities,description,checkInTimeandcheckOutTimelatitude,longitude,website,googleHotelsUrlandgoogleMapsUrlhotelId, Google's id for the property, to match hotels across runs
Good to know
- Taxes: Google shows US visitors nightly prices before taxes, and most other markets prices with taxes. For prices you can compare, use
totalPrice / nights, as the examples do. - About 20 hotels per search: that's Google's first page. For more hotels in a city, add searches such as
hotels in Amsterdam Jordaanorhotels near Amsterdam Centraal. - Relative dates:
30 daysand32 dayskeep scheduled runs pointing at the future. To track one stay over time, use fixed dates instead. - Market: the
countryinput (Google'sglsetting) decides which booking sites Google compares, and prices can differ between markets. - How it works: the scraper loads the same Google Hotels search page you see in a browser, without a browser, reads the hotel list from the data in the page, and retries from fresh residential IPs when Google blocks a request.
Other options
- SerpApi has a Google Hotels endpoint, with a monthly subscription.
- Booking sites' own APIs are usually only for partners and affiliates, and only cover their own prices.
Use it from AI assistants (MCP)
To let Claude, Cursor, VS Code or another MCP client look up hotel prices for you, add this MCP server URL: https://mcp.apify.com/?tools=ralfij/google-hotels-scraper. Sign in to Apify when the client asks, or send your Apify API token as Authorization: Bearer <token>. Runs are billed to your own Apify account.
Notes
- I built the Google Hotels Scraper used in these examples, so keep that in mind.
- Pricing is per hotel with no subscription; see the actor page.
- It returns business data only. Guest reviews and reviewer names are left out on purpose.
- Not affiliated with, endorsed by or sponsored by Google. Google Hotels is a trademark of Google LLC.
License
MIT
Google Hotels Scraper MCP questions
How do I add Google Hotels Scraper MCP to Claude Code?
Run claude mcp add --transport http google-hotels-api 'https://mcp.apify.com/?tools=ralfij/google-hotels-scraper' in your terminal. Add --scope user to make it available in every project.
How do I add Google Hotels Scraper MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Google Hotels Scraper MCP provide?
It exposes 5 tools, including get-actor-run, get-dataset-items, get-key-value-store-record, abort-actor-run, ralfij--google-hotels-scraper.
How much does it cost to use?
Pricing is per hotel with no subscription required.
Does it include taxes in the price?
Google shows nightly prices before taxes for US visitors, while most other markets show prices with taxes included.
How many hotels are returned per search?
The scraper returns about 20 hotels, which corresponds to Google's first page of results.
Does it provide guest reviews?
No, the tool returns business data only and intentionally excludes guest reviews and reviewer names.