Airbnb MCP Server

For clients like Cursor, you can install the server using npx. Ensure Node.js is installed on your system.

1. Open Cursor Settings > Tools & Integrations > New MCP Server.
2. Add the following configuration to your mcp.json file.

To ignore robots.txt for all requests, include the --ignore-robots-txt argument in the args array.

{
  "mcpServers": {
    "airbnb": {
      "command": "npx",
      "args": [
        "-y",
        "@openbnb/mcp-server-airbnb"
      ]
    }
  }
}

If you are developing or testing the server locally, use the following commands.

Build commands:

# Install dependencies
npm install

# Build the project
npm run build

# Watch for changes during development
npm run watch

Testing the server directly:

# Run with robots.txt compliance (default)
node dist/index.js

# Run with robots.txt ignored (for testing)
node dist/index.js --ignore-robots-txt

The Airbnb MCP server is packaged as an MCP Bundle (.mcpb) file for easy installation in Claude Desktop.

1. Download the .mcpb file from the latest release.
2. Open the downloaded file; Claude Desktop will automatically trigger an installation dialog.
3. Follow the prompts to configure extension settings.

To bypass robots.txt restrictions in Claude Desktop, open the Claude Desktop settings, navigate to the Airbnb extension, and enable the Ignore robots.txt toggle.

The server provides two main configuration options to control behavior:

Ignore robots.txt

• Type: Boolean
• Default: false
• Description: Bypasses robots.txt restrictions when making requests to Airbnb. Recommended to keep disabled unless needed for testing.

Disable third-party geocoding

• Type: Boolean (Environment Variable: DISABLE_GEOCODING)
• Default: false
• Description: Skips the Photon/Nominatim geocoding step and lets Airbnb resolve the location string.
• Warning: Enabling this may cause non-US searches (e.g., "Paris, France") to return incorrect results because Airbnb's internal geocoder is less accurate for international locations.

Retrieve comprehensive information about a specific Airbnb listing.

Parameters:

• id (required): The unique Airbnb listing ID.
• checkin (optional): Date in YYYY-MM-DD format.
• checkout (optional): Date in YYYY-MM-DD format.
• adults (optional): Number of adults (default: 1).
• children (optional): Number of children (default: 0).
• infants (optional): Number of infants (default: 0).
• pets (optional): Number of pets (default: 0).
• ignoreRobotsText (optional): Override robots.txt for this specific request.

Returns: Detailed data including location coordinates, amenities, house rules, policies, property descriptions, and a direct link to the listing.

The server behavior can be modified using the following environment variables:

• IGNORE_ROBOTS_TXT: Set to "true" to bypass Airbnb's robots.txt restrictions. This is useful if you encounter errors stating a path is disallowed.
• DISABLE_GEOCODING: Set to "true" to skip third-party geocoding (Photon/Nominatim). When enabled, the server relies on Airbnb's own server-side geocoder for the location string.

Use the airbnb_search tool to find Airbnb listings based on location, dates, and guest counts. The tool supports advanced filtering such as price ranges and property types. If a placeId (Google Maps Place ID) is provided, it overrides the location parameter. The tool also provides a cursor parameter for handling pagination in search results.

{
  "name": "airbnb_search",
  "arguments": {
    "location": "Paris, France",
    "checkin": "2024-12-01",
    "checkout": "2024-12-05",
    "adults": 2,
    "minPrice": 100,
    "maxPrice": 500,
    "propertyType": "entire_home"
  }
}

Use the airbnb_listing_details tool to retrieve comprehensive information about a specific Airbnb property using its unique listing ID. You can optionally provide check-in/check-out dates and guest counts to get availability-specific details. The returned data includes location information, house rules, highlights, descriptions, and amenities.

{
  "name": "airbnb_listing_details",
  "arguments": {
    "id": "LISTING_ID_HERE",
    "checkin": "2024-12-01",
    "checkout": "2024-12-05",
    "adults": 2
  }
}

The following properties are available for the airbnb_listing_details tool: