mcp-server-airbnb
by: openbnb-org
mcp server airbnb
📌Overview
Purpose: To provide a server for searching Airbnb listings and obtaining detailed information about specific listings.
Overview: The MCP Server for Airbnb enables users to search for and retrieve Airbnb listings with essential details while adhering to Airbnb's usage policies. It simplifies the process of accessing listing data through user-friendly commands, making it an efficient tool for planning trips that involve Airbnb accommodations.
Key Features:
-
Airbnb Search: Allows users to search for Airbnb listings based on various optional parameters, returning structured JSON data about each listing without requiring an API key.
-
Listing Details: Provides in-depth information about specific listings, including pricing, amenities, and host details, ensuring users have all necessary information for making informed rental decisions.
Airbnb MCP Server
MCP Server for searching Airbnb and retrieving listing details.
Tools
1. airbnb_search
- Description: 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
- Description: 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 you start, ensure Node.js is installed for npx
to work.
- Go to: Settings > Developer > Edit Config
- 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:
{
"mcpServers": {
"airbnb": {
"command": "npx",
"args": [
"-y",
"@openbnb/mcp-server-airbnb",
"--ignore-robots-txt"
]
}
}
}
- Restart Claude Desktop and plan your next trip that includes 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 Developers)
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 affiliated with Airbnb, Inc. or its subsidiaries.