Airbnb

🚀 Airbnb MCP Server

An MCP server for searching Airbnb listings and retrieving detailed accommodation information. The results include direct links to Airbnb listing pages.

✨ Features

• Comply with Airbnb's robots.txt rules.
• Use cheerio for HTML analysis.
• No API key is required.
• Return structured JSON data.
• Reduce context burden through flattened and selective data return.
• Provide direct links to Airbnb listing pages.

📦 Installation

Installation on Claude Desktop

Before you start, make sure Node.js (https://nodejs.org/) is installed on your computer so that npx can run properly.

1. Open: Settings > Developer > Modify Configuration.
2. Add the following content to the claude_desktop_config.json file:

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

If you want to ignore the robots.txt file for all requests, use the version with the --ignore-robots-txt parameter:

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

3. Restart Claude Desktop and plan your next trip with Airbnb listings!

Other Option: Installation via Smithery

To install automatically via Smithery, run the following command:

# Install with default values to package.json
npx smithery install @domoteek/mcp-server-airbnb

# Or specify the configuration file path (optional)
npx smithery install --config your configFile.js @domoteek/mcp-server-airbnb

🔧 Compilation

If you need to compile from the source code, run the following command:

npm install

📚 Documentation

Tools

1. airbnb_search

• Search for Airbnb listings.
• Required parameters: location (string).
• Optional parameters:
  • placeId (string).
  • checkin (string, AAAA-MM-DD).
  • checkout (string, AAAA-MM-DD).
  • adults (number).
  • children (number).
  • infants (number).
  • pets (number).
  • minPrice (number).
  • maxPrice (number).
  • cursor (string).
  • ignoreRobotsText (boolean).
• Returns: An array containing information such as listing names, prices, and locations. Each listing includes a url that directly links to the Airbnb page.

2. airbnb_listing_details

• Get detailed information about a specific Airbnb listing.
• Required parameters: id (string).
• Optional parameters:
  • checkin (string, AAAA-MM-DD).
  • checkout (string, AAAA-MM-DD).
  • adults (number).
  • children (number).
  • infants (number).
  • pets (number).
  • ignoreRobotsText (boolean).
• Returns: Detailed information including listing descriptions, host information, facilities, prices, etc. The response includes a url that directly links to the Airbnb listing page.

📄 License

This project was created by Domino Liu and is open-sourced under the MIT License.

Project URL Documentation URL

⚠️ Important Note

Airbnb's user agreement prohibits accessing its website through automated means. Please comply with relevant laws and regulations when using this library.