# Google Hotels

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Empower your agents to search for hotels using Arcade."
  author="Arcade"
  authType="API Key"
  versions={["0.1.0"]}
/>

<Badges repo="arcadeai/arcade-google-hotels" />

The Arcade Google Hotels MCP Sever lets you search for hotels with ease. Use this tool to build intelligent agents and applications that search for hotels worldwide.

## Available Tools

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    [
      "GoogleHotels.SearchHotels",
      "Retrieve hotel search results using the Google Hotels API.",
    ],
  ]}
/>

## GoogleHotels.SearchHotels

Retrieve hotel search results using the Google Hotels API.

**Parameters**

- **`location`** _(string, required)_: Location to search for hotels, e.g., a city name, a state, etc.
- **`check_in_date`** _(string, required)_: Check-in date in YYYY-MM-DD format.
- **`check_out_date`** _(string, required)_: Check-out date in YYYY-MM-DD format.
- **`query`** _(string, optional)_: Anything that would be used in a regular Google Hotels search.
- **`currency`** _(string, optional)_: Currency code for prices. Defaults to 'USD'.
- **`min_price`** _(int, optional)_: Minimum price per night. Defaults to no minimum.
- **`max_price`** _(int, optional)_: Maximum price per night. Defaults to no maximum.
- **`num_adults`** _(int, optional)_: Number of adults per room. Defaults to 2.
- **`num_children`** _(int, optional)_: Number of children per room. Defaults to 0.
- **`sort_by`** _(enum ([GoogleHotelsSortBy](#googlehotelssortby)), optional)_: The sorting order of the results. Defaults to RELEVANCE.
- **`num_results`** _(int, optional)_: Maximum number of results to return. Defaults to 5. Max 20.

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the tool directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/search/google_hotels/search_hotels_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/search/google_hotels/search_hotels_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Auth

The Arcade Google Hotels MCP Sever uses the [SerpAPI](https://serpapi.com/) to search for hotels from Google Hotels.

- **Secret:**
  - `SERP_API_KEY`: Your SerpAPI API key.

<Callout type="info">
  Setting the `SERP_API_KEY` secret is only required if you are
  [self-hosting](/guides/deployment-hosting/configure-engine) Arcade. If you're
  using Arcade Cloud, the secret is already set for you. To manage your secrets,
  go to the [Secrets page](https://api.arcade.dev/dashboard/auth/secrets) in the
  Arcade Dashboard.
</Callout>

## Reference

## GoogleHotelsSortBy

Defines the sorting options for hotel search results.

- **`RELEVANCE`**: Sort by the most relevant results.
- **`LOWEST_PRICE`**: Sort by the lowest price available.
- **`HIGHEST_RATING`**: Sort by the highest customer ratings.
- **`MOST_REVIEWED`**: Sort by the most reviewed hotels.

<ToolFooter pipPackageName="arcade_google_hotels" />