Airbnb Search & Listings
Enables searching for Airbnb listings with advanced filtering (location, dates, guests, price range) and retrieving detailed property information including amenities, policies, and house rules.
Supports Google Maps Place ID integration for precise location targeting when searching Airbnb listings.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Airbnb Search & Listings find a 2-bedroom apartment in Paris for 4 guests from June 15-22 under $200 per night"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Airbnb Search & Listings - Desktop Extension (DXT)
A comprehensive Desktop Extension for searching Airbnb listings with advanced filtering capabilities and detailed property information retrieval. Built as a Model Context Protocol (MCP) server packaged in the Desktop Extension (DXT) format for easy installation and use with compatible AI applications.
Features
🔍 Advanced Search Capabilities
Location-based search with support for cities, states, and regions
Google Maps Place ID integration for precise location targeting
Date filtering with check-in and check-out date support
Guest configuration including adults, children, infants, and pets
Price range filtering with minimum and maximum price constraints
Pagination support for browsing through large result sets
🏠 Detailed Property Information
Comprehensive listing details including amenities, policies, and highlights
Location information with coordinates and neighborhood details
House rules and policies for informed booking decisions
Property descriptions and key features
Direct links to Airbnb listings for easy booking
🛡️ Security & Compliance
Robots.txt compliance with configurable override for testing
Request timeout management to prevent hanging requests
Enhanced error handling with detailed logging
Rate limiting awareness and respectful API usage
Secure configuration through DXT user settings
Related MCP server: Airbnb MCP Server
Installation
For Claude Desktop
This extension is packaged as a Desktop Extension (DXT) file. To install:
Download the
.dxtfile from the releases pageOpen your compatible AI application (e.g., Claude Desktop)
Install the extension through the application's extension manager
Configure the extension settings as needed
For Cursor, etc.
Before starting make sure Node.js is installed on your desktop for npx to work.
Go to: Cursor Settings > Tools & Integrations > New MCP Server
Add one the following to your
mcp.json:{ "mcpServers": { "airbnb": { "command": "npx", "args": [ "-y", "@openbnb/mcp-server-airbnb" ] } } }To ignore robots.txt for all requests, use this version with
--ignore-robots-txtargs{ "mcpServers": { "airbnb": { "command": "npx", "args": [ "-y", "@openbnb/mcp-server-airbnb", "--ignore-robots-txt" ] } } }Restart.
Configuration
The extension provides the following user-configurable options:
Ignore robots.txt
Type: Boolean (checkbox)
Default:
falseDescription: Bypass robots.txt restrictions when making requests to Airbnb
Recommendation: Keep disabled unless needed for testing purposes
Tools
airbnb_search
Search for Airbnb listings with comprehensive filtering options.
Parameters:
location(required): Location to search (e.g., "San Francisco, CA")placeId(optional): Google Maps Place ID (overrides location)checkin(optional): Check-in date in YYYY-MM-DD formatcheckout(optional): Check-out date in YYYY-MM-DD formatadults(optional): Number of adults (default: 1)children(optional): Number of children (default: 0)infants(optional): Number of infants (default: 0)pets(optional): Number of pets (default: 0)minPrice(optional): Minimum price per nightmaxPrice(optional): Maximum price per nightcursor(optional): Pagination cursor for browsing resultsignoreRobotsText(optional): Override robots.txt for this request
Returns:
Search results with property details, pricing, and direct links
Pagination information for browsing additional results
Search URL for reference
airbnb_listing_details
Get detailed information about a specific Airbnb listing.
Parameters:
id(required): Airbnb listing IDcheckin(optional): Check-in date in YYYY-MM-DD formatcheckout(optional): Check-out date in YYYY-MM-DD formatadults(optional): Number of adults (default: 1)children(optional): Number of children (default: 0)infants(optional): Number of infants (default: 0)pets(optional): Number of pets (default: 0)ignoreRobotsText(optional): Override robots.txt for this request
Returns:
Detailed property information including:
Location details with coordinates
Amenities and facilities
House rules and policies
Property highlights and descriptions
Direct link to the listing
Technical Details
Architecture
Runtime: Node.js 18+
Protocol: Model Context Protocol (MCP) via stdio transport
Format: Desktop Extension (DXT) v0.1
Dependencies: Minimal external dependencies for security and reliability
Error Handling
Comprehensive error logging with timestamps
Graceful degradation when Airbnb's page structure changes
Timeout protection for network requests
Detailed error messages for troubleshooting
Security Measures
Robots.txt compliance by default
Request timeout limits
Input validation and sanitization
Secure environment variable handling
No sensitive data storage
Performance
Efficient HTML parsing with Cheerio
Request caching where appropriate
Minimal memory footprint
Fast startup and response times
Compatibility
Platforms: macOS, Windows, Linux
Node.js: 18.0.0 or higher
Claude Desktop: 0.10.0 or higher
Other MCP clients: Compatible with any MCP-supporting application
Development
Building from Source
# Install dependencies
npm install
# Build the project
npm run build
# Watch for changes during development
npm run watchTesting
The extension can be tested by running the MCP server directly:
# Run with robots.txt compliance (default)
node dist/index.js
# Run with robots.txt ignored (for testing)
node dist/index.js --ignore-robots-txtLegal and Ethical Considerations
Respect Airbnb's Terms of Service: This extension is for legitimate research and booking assistance
Robots.txt Compliance: The extension respects robots.txt by default
Rate Limiting: Be mindful of request frequency to avoid overwhelming Airbnb's servers
Data Usage: Only extract publicly available information for legitimate purposes
Support
Issues: Report bugs and feature requests on GitHub Issues
Documentation: Additional documentation available in the repository
Community: Join discussions about MCP and DXT development
License
MIT License - see LICENSE file for details.
Contributing
Contributions are welcome! Please read the contributing guidelines and submit pull requests for any improvements.
Note: This extension is not affiliated with Airbnb, Inc. It is an independent tool designed to help users search and analyze publicly available Airbnb listings.
Available Tools
4 toolsairbnb_listing_detailsC
Get detailed information about a specific Airbnb listing. Provide direct links to the user
Inputs: id (required), checkin, checkout, adults, +4 more.
airbnb_searchC
Search for Airbnb listings with various filters and pagination. Provide direct links to the user
Inputs: location (required), placeId, checkin, checkout, +8 more.
analyzeListingPhotosC
Analyze photos from an Airbnb listing
Inputs: id (required).
getListingPhotosC
Extract photo URLs from an Airbnb listing
Inputs: id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools have some overlap that could cause confusion, particularly between 'analyzeListingPhotos' and 'getListingPhotos' which both handle listing photos but with different purposes (analysis vs. extraction). However, 'airbnb_listing_details' and 'airbnb_search' are clearly distinct for specific listing retrieval and general search, respectively, and descriptions help clarify the photo-related tools.
Naming is inconsistent with mixed conventions: 'airbnb_listing_details' and 'airbnb_search' use snake_case with a prefix, while 'analyzeListingPhotos' and 'getListingPhotos' use camelCase without the prefix. This lack of a predictable pattern across all tools makes the set less coherent and harder for agents to navigate intuitively.
With 4 tools, the count is borderline for the server's purpose of Airbnb search and listings. It feels thin, as core operations like booking, user reviews, or price updates are missing, but it covers basic search and listing details, which might be sufficient for a limited scope. A typical server in this domain would benefit from more tools to handle a fuller lifecycle.
There are significant gaps in the tool surface for the Airbnb domain. While search and listing details are covered, essential operations like booking a listing, managing reservations, accessing user reviews, or updating pricing are missing. This incompleteness will likely cause agent failures when trying to perform common tasks beyond basic lookup and photo analysis.
Maintenance
Related MCP Connectors
Airbnb stays by location and dates, and full listing details, as structured JSON.
Airbnb search, listing details, and calendar availability as clean structured data.
Searchable directory of Airbnb listings — discover properties and retrieve direct Airbnb links.
Airbnb stays worldwide: search by place, dates, guests with total prices and links; listing details.
Related MCP Servers
- AlicenseAqualityDmaintenanceSearch for Airbnb listings and get detailed information about specific properties. Effortlessly plan your next trip with structured data and no API key required, while respecting Airbnb's guidelines.2562MIT
- AlicenseBqualityDmaintenanceEnables searching for Airbnb listings and retrieving detailed accommodation information with direct links to Airbnb pages.21MIT
- AlicenseBqualityDmaintenanceEnables searching for Airbnb listings and retrieving detailed property information including pricing, amenities, and host details without requiring an API key.62MIT
- AlicenseBqualityDmaintenanceEnables searching for Airbnb listings and retrieving detailed property information including pricing, amenities, and host details without requiring an API key.23MIT