Skip to content

openbnb-org/mcp-server-airbnb

Repository files navigation

Airbnb MCP Server

smithery badge

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"
      ]
    }
  }
}
  1. 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