Airbnb

What is mcp-server-airbnb?

mcp-server-airbnb is an MCP (Multi-Cloud Platform) server designed to interact with Airbnb. It provides tools to search for Airbnb listings and retrieve detailed information about specific listings.

How to use mcp-server-airbnb?

mcp-server-airbnb can be installed and used with Claude Desktop or via Smithery. For Claude Desktop, you need to add a configuration to your claude_desktop_config.json file, specifying the command to run the server using npx. You can also choose to ignore robots.txt rules during installation. Alternatively, you can install it automatically via Smithery using a simple npx command.

Key Features of mcp-server-airbnb

• Search Functionality: Allows searching for Airbnb listings based on various criteria like location, check-in/check-out dates, number of guests, and price range.
• Listing Details Retrieval: Provides detailed information for a specific Airbnb listing, including description, host details, amenities, and pricing.
• Robots.txt Compliance: Respects Airbnb's robots.txt rules by default, with an option to ignore them.
• No API Key Required: Operates without the need for an Airbnb API key.
• Structured Data Output: Returns data in a structured JSON format.
• Efficient Data Handling: Reduces context load by flattening and picking relevant data.

Use Cases of mcp-server-airbnb

• Travel Planning: Users can search for accommodations on Airbnb directly through integrated platforms.
• Data Collection: Developers can use it to collect Airbnb listing data for analysis or other applications.
• Application Development: Integrate Airbnb search and listing details into custom applications.

FAQ from mcp-server-airbnb

Q: Does mcp-server-airbnb require an Airbnb API key? A: No, it does not require an API key.

Q: Does mcp-server-airbnb respect Airbnb's robots.txt rules? A: Yes, it respects robots.txt rules by default, but you have the option to ignore them during setup.

Airbnb MCP Server

MCP Server for searching Airbnb and get listing details.

Tools

1. airbnb_search

   • Search for Airbnb listings
   • Required Input: location (string)
   • Optional Inputs:
     • placeId (string)
     • checkin (string, YYYY-MM-DD)
     • checkout (string, YYYY-MM-DD)
     • adults (number)
     • children (number)
     • infants (number)
     • pets (number)
     • minPrice (number)
     • maxPrice (number)
     • cursor (string)
     • ignoreRobotsText (boolean)
   • Returns: Array of listings with details like name, price, location, etc.

2. airbnb_listing_details

   • Get detailed information about a specific Airbnb listing
   • Required Input: id (string)
   • Optional Inputs:
     • checkin (string, YYYY-MM-DD)
     • checkout (string, YYYY-MM-DD)
     • adults (number)
     • children (number)
     • infants (number)
     • pets (number)
     • ignoreRobotsText (boolean)
   • Returns: Detailed listing information including description, host details, amenities, pricing, etc.

Features

• Respects Airbnb's robots.txt rules
• Uses cheerio for HTML parsing
• No API key required
• Returns structured JSON data
• Reduces context load by flattening and picking data

Setup

Installing on Claude Desktop

Before starting make sure Node.js is installed on your desktop for npx to work.

1. Go to: Settings > Developer > Edit Config

2. Add the following to your claude_desktop_config.json:

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

To ignore robots.txt for all requests, use this version with --ignore-robots-txt args

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

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

Other Option: Installing via Smithery

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

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

Build (for devs)

npm install
npm run build

License

This MCP server is licensed under the MIT License.

Disclaimer

Airbnb is a trademark of Airbnb, Inc. OpenBnB is not related to Airbnb, Inc. or its subsidiaries