Openbnb Org MCP Server Airbnb

🚀 Airbnb MCP Server

An MCP server for searching Airbnb listings and retrieving detailed information.

🚀 Quick Start

This Airbnb MCP Server is designed to search for Airbnb listings and obtain detailed information about them. You can use the provided tools to perform searches and get specific details.

✨ Features

• Respect Airbnb's robots.txt rules.
• Use cheerio for HTML parsing.
• No API key is required.
• Return structured JSON data.
• Reduce context load through data flattening and selection.

📦 Installation

Installation on Claude Desktop

Before you start, make sure you have Node.js installed so that npx can be used.

1. Go to: Settings > Developer > Edit Configuration.
2. Add the following content to your claude_desktop_config.json:

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

To ignore the robots.txt rules for all requests, use the following version with the --ignore-robots-txt parameter:

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

3. Restart Claude Desktop and plan your next trip including Airbnbs!

Other Option: Installation via Smithery

To automatically install mcp-server-airbnb to Claude Desktop via Smithery:

npx -y @smithery/cli install @openbnb-org/mcp-server-airbnb --client claude

💻 Usage Examples

Basic Usage

1. airbnb_search

This tool is used to search for Airbnb listings.

Required Input:
- `location` (string): The location to search for listings.

Optional Input:
- `placeId` (string): The ID of the place.
- `checkin` (string, YYYY-MM-DD): The check-in date.
- `checkout` (string, YYYY-MM-DD): The check-out date.
- `adults` (number): The number of adults.
- `children` (number): The number of children.
- `infants` (number): The number of infants.
- `pets` (number): The number of pets.
- `minPrice` (number): The minimum price.
- `maxPrice` (number): The maximum price.
- `cursor` (string): The cursor for pagination.
- `ignoreRobotsText` (boolean): Whether to ignore the robots.txt rules.

Return:
A list of listings containing information such as name, price, and location.

2. airbnb_listing_details

This tool is used to get detailed information about a specific Airbnb listing.

Required Input:
- `id` (string): The ID of the listing.

Optional Input:
- `checkin` (string, YYYY-MM-DD): The check-in date.
- `checkout` (string, YYYY-MM-DD): The check-out date.
- `adults` (number): The number of adults.
- `children` (number): The number of children.
- `infants` (number): The number of infants.
- `pets` (number): The number of pets.
- `ignoreRobotsText` (boolean): Whether to ignore the robots.txt rules.

Return:
Detailed listing information, including description, host details, amenities, price, etc.

🔧 Technical Details (For Developers)

Build

npm install
npm run build

📄 License

Please refer to the project's license file for detailed information.

Disclaimer

Please refer to the project's disclaimer file for detailed information.