Airbnb MCP Server

by MCP-Mirror

364 downloads Not rated yet MIT license
GitHub

About

An MCP server that searches Airbnb and retrieves listing details. It provides two tools—airbnbsearch and airbnblistingdetails—for use with AI assistants like Claude. No API key is required, and it respects Airbnb’s robots.txt rules by default.

Details

License
MIT license

Explore

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Airbnb MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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!

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

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

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)

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "airbnb mcp server": {
            "openbnb-org_mcp-server-airbnb": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@openbnb-org/mcp-server-airbnb",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "openbnb-org_mcp-server-airbnb": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@openbnb-org/mcp-server-airbnb",
            "--client",
            "claude"
        ]
    }
}
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"
      ]
    }
  }
}
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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.