openbnb-org/mcp-server-airbnb

A comprehensive MCP Bundle for searching Airbnb listings with advanced filtering capabilities and detailed property information retrieval. Built as a Model Context Protocol (MCP) server packaged in the MCP Bundle (MCPB) format for easy installation and use with compatible AI applications.
---
🚀 Prefer not to run a local server? Try openbnb.ai
> **👉 openbnb.ai is a hosted MCP server that solves the same problem — searching Airbnb listings — without any local setup.**
If you don't want to deal with installing and running this server yourself, **openbnb.ai** is a separate, fully-hosted alternative you can connect to directly from your MCP client. It goes beyond what this open-source server offers:
- ✅ **Zero setup** — no Node, no npx, no config files, no updates to manage
- ✅ **Advanced filters** — richer search controls beyond the base tools here
- ✅ **MCP UI** — interactive UI components for browsing results, not just plain text
- ✅ **Managed & maintained** — kept running for you
Head to **openbnb.ai** for setup instructions and the connection details for your MCP client.
If you'd rather self-host the open-source server, read on.
---
Features
🔍 Advanced Search Capabilities
- **Location-based search** with support for cities, states, and regions
- **International location support** via client-side geocoding, so non-US queries (e.g. "Paris, France", "Copenhagen, Denmark") return results in the right city
- **Google Maps Place ID** integration for precise location targeting
- **Property type filtering** for entire homes, private rooms, shared rooms, or hotel rooms
- **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 MCPB user settings
Installation
For Claude Desktop
This extension is packaged as an MCP Bundle (.mcpb) file. To install:
1. Download the .mcpb file from the latest release
2. Open the file — Claude Desktop will show an installation dialog
3. Configure the extension settings as needed
To ignore robots.txt, open Claude Desktop settings, navigate to the extension, and enable the **Ignore robots.txt** toggle.
For Cursor, etc.
Before starting make sure Node.js is installed on your desktop for npx to work.
1. Go to: Cursor Settings > Tools & Integrations > New MCP Server
2. Add one the following to your mcp.json:
To ignore robots.txt for all requests, use this version with --ignore-robots-txt args
3. Restart.
Configuration
The extension provides the following user-configurable options:
Ignore robots.txt
- **Type**: Boolean (checkbox)
- **Default**: false
- **Description**: Bypass robots.txt restrictions when making requests to Airbnb
- **Recommendation**: Keep disabled unless needed for testing purposes
Disable third-party geocoding
- **Type**: Boolean (checkbox)
- **Environment variable**: DISABLE_GEOCODING
- **Default**: false
- **Description**: Skip the Photon/Nominatim geocoding step and let Airbnb resolve the location string on its own. Enabling this restores the pre-PR behavior — every search goes only to airbnb.com, no third-party calls.