mcp-server-airbnb

MCP.Pizza Chef: openbnb-org

The mcp-server-airbnb is an MCP server that enables real-time searching of Airbnb listings and fetching detailed information about specific properties. It supports filtering by location, dates, guest count, price range, and more, providing structured data about listings such as name, price, and location. This server facilitates integration of Airbnb data into AI workflows and applications, allowing models to access and interact with Airbnb rental information efficiently.

Use This MCP server To

Search Airbnb listings by location and date range Retrieve detailed information for specific Airbnb properties Filter listings by guest count and price range Integrate Airbnb rental data into AI-powered travel assistants Enable real-time Airbnb availability checks in chatbots Automate vacation rental recommendations based on user preferences Fetch Airbnb listing details for itinerary planning Support multi-criteria Airbnb search in travel apps

README

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

mcp-server-airbnb FAQ

How do I specify the location for an Airbnb search?
Use the 'location' string input to define the search area for listings.
Can I filter Airbnb listings by price range?
Yes, you can use 'minPrice' and 'maxPrice' optional inputs to filter listings within a specific price range.
How do I get detailed information about a specific Airbnb listing?
Use the 'airbnb_listing_details' tool with the listing's 'id' to retrieve detailed property data.
Is it possible to search Airbnb listings for specific dates?
Yes, provide 'checkin' and 'checkout' dates in YYYY-MM-DD format to filter availability.
Can I specify the number of guests for the search?
Yes, optional inputs include 'adults', 'children', 'infants', and 'pets' to tailor search results.
What kind of data does the server return for listings?
It returns an array of listings with details like name, price, location, and availability.
Does the server support pagination for large search results?
Yes, use the 'cursor' parameter to paginate through search results.
Can this MCP server be integrated with AI models like GPT-4 or Claude?
Yes, it is designed to provide structured Airbnb data to LLMs such as GPT-4, Claude, and Gemini for enhanced travel-related workflows.