Serpapi Hotels

com.pulsemcpPublished by pulsemcp.comv0.0.4Updated Oct 24, 2026

MCP server for searching Google Hotels via SerpAPI — hotel search, pricing, ratings, and reviews.

VerifiedSTDIODesktop onlyLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Searches Google Hotels through SerpAPI, letting an assistant find hotels, compare prices and read guest reviews.

What you can do
  • Search hotels by area and date range, filtered by price, rating, star class, amenities, free cancellation, special offers, eco certification or vacation rentals
  • Get a specific hotel's details, including prices from multiple booking sources, review breakdowns, amenities, check-in times and nearby places
  • Read individual guest reviews with full text, sub-ratings, management responses, sorting and category filters
When to use it
Useful when planning trips or comparing accommodation: the assistant can look up hotels for given dates, weigh prices and ratings across booking sites, and summarize what guests say before a booking decision.
Requirements
Runs locally via npx (Node.js). Requires a SerpAPI account and API key supplied in the SERPAPI_API_KEY environment variable; network access to SerpAPI is needed. Desktop client only.
Before you install
The SerpAPI key is a paid-service credential passed in plain text through the environment; keep it out of shared configs. Queries and hotel searches are sent to SerpAPI and Google Hotels, and results include third-party booking prices that may be stale or region-dependent. The server only reads data; it does not book or pay.

Installation

In SourceWeft

  1. Open Serpapi Hotels in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

SerpAPI Hotels MCP Server

An MCP server for searching Google Hotels via the SerpAPI API. Search for hotels in any area with date ranges, and get back prices, ratings, reviews, and booking information.

Tools

ToolDescription
search_hotelsSearch for hotels with filters for price, rating, star class, amenities, and more
get_hotel_detailsGet detailed info for a specific hotel including review breakdowns and booking prices from multiple sources
get_hotel_reviewsGet individual guest reviews with full text, ratings, sub-ratings, and hotel management responses

Quick Start

Claude Desktop

Add this to your Claude Desktop config file:

json
{  "mcpServers": {    "serpapi-hotels": {      "command": "npx",      "args": ["-y", "serpapi-hotels-mcp-server"],      "env": {        "SERPAPI_API_KEY": "your_api_key_here"      }    }  }}

Manual Setup

bash
# Clone and installcd experimental/serpapi-hotelsnpm run install-all
# Set your API keyexport SERPAPI_API_KEY=your_api_key_here
# Build and runnpm run buildcd local && npm start

Configuration

VariableRequiredDescription
SERPAPI_API_KEYYesYour SerpAPI API key (get one here)

Example Usage

Search for hotels

Search for hotels in New York for March 1-5, 2026, sorted by lowest price

The search_hotels tool will be called with:

  • query: "Hotels in New York"
  • check_in_date: "2026-03-01"
  • check_out_date: "2026-03-05"
  • sort_by: 3

Get hotel details

After finding a hotel, use get_hotel_details with its property_token to get:

  • Prices from multiple booking sources (Booking.com, Hotels.com, Expedia, etc.)
  • Review breakdown by category (cleanliness, location, service)
  • Full amenity list
  • Check-in/out times
  • Nearby places with travel times

Read hotel reviews

After finding a hotel, use get_hotel_reviews with its property_token to get:

  • Full review text from Google and third-party sources (TripAdvisor, etc.)
  • Reviewer ratings with sub-ratings (rooms, service, location)
  • Hotel management responses
  • Sorting by most helpful, most recent, highest/lowest score
  • Category filtering (from get_hotel_details review breakdown)

Available Filters

FilterValues
sort_by3 = lowest price, 8 = highest rating, 13 = most reviewed
rating7 = 3.5+, 8 = 4.0+, 9 = 4.5+
hotel_class"2", "3", "4", "5" (star rating, comma-separated)
min_price / max_pricePrice range per night
free_cancellationtrue/false
special_offerstrue/false
eco_certifiedtrue/false
vacation_rentalstrue = search vacation rentals instead

Development

bash
npm run install-all    # Install all dependenciesnpm run build          # Build the projectnpm run dev            # Development modenpm test               # Run functional testsnpm run test:integration  # Run integration testsnpm run test:manual    # Run manual tests (requires API key)

Project Structure

serpapi-hotels/├── local/              # Stdio transport entry point│   └── src/│       ├── index.ts                      # Main entry point│       └── index.integration-with-mock.ts # Mock entry for integration tests├── shared/             # Core business logic│   └── src/│       ├── server.ts         # MCP server factory│       ├── tools.ts          # Tool registration│       ├── resources.ts      # Resource handlers│       ├── types.ts          # TypeScript types│       ├── logging.ts        # Logging utilities│       ├── tools/            # Individual tool implementations│       │   ├── search-hotels.ts│       │   ├── get-hotel-details.ts│       │   └── get-hotel-reviews.ts│       └── serpapi-client/   # SerpAPI client│           ├── serpapi-client.integration-mock.ts│           └── lib/│               ├── parse-property.ts│               ├── search-hotels.ts│               ├── get-hotel-details.ts│               └── get-hotel-reviews.ts└── tests/    ├── functional/       # Unit tests with mocks    ├── integration/      # Full MCP protocol tests    ├── manual/           # Real API tests    └── mocks/            # Mock implementations

Source: experimental/serpapi-hotels/README.md at commit 0ed34de

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.0.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts