$git clone https://github.com/openbnb-org/mcp-server-airbnbA 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 appl
| 1 | [](https://www.npmjs.com/package/@openbnb/mcp-server-airbnb) |
| 2 | |
| 3 | # Airbnb Search & Listings - MCP Bundle (MCPB) |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | --- |
| 8 | |
| 9 | ## 🚀 Prefer not to run a local server? Try [openbnb.ai](https://openbnb.ai/) |
| 10 | |
| 11 | > **👉 [openbnb.ai](https://openbnb.ai/) is a hosted MCP server that solves the same problem — searching Airbnb listings — without any local setup.** |
| 12 | |
| 13 | If you don't want to deal with installing and running this server yourself, **[openbnb.ai](https://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: |
| 14 | |
| 15 | - ✅ **Zero setup** — no Node, no `npx`, no config files, no updates to manage |
| 16 | - ✅ **Advanced filters** — richer search controls beyond the base tools here |
| 17 | - ✅ **MCP UI** — interactive UI components for browsing results, not just plain text |
| 18 | - ✅ **Managed & maintained** — kept running for you |
| 19 | |
| 20 | Head to **[openbnb.ai](https://openbnb.ai/)** for setup instructions and the connection details for your MCP client. |
| 21 | |
| 22 | If you'd rather self-host the open-source server, read on. |
| 23 | |
| 24 | --- |
| 25 | |
| 26 | ## Features |
| 27 | |
| 28 | ### 🔍 Advanced Search Capabilities |
| 29 | - **Location-based search** with support for cities, states, and regions |
| 30 | - **International location support** via client-side geocoding, so non-US queries (e.g. "Paris, France", "Copenhagen, Denmark") return results in the right city |
| 31 | - **Google Maps Place ID** integration for precise location targeting |
| 32 | - **Property type filtering** for entire homes, private rooms, shared rooms, or hotel rooms |
| 33 | - **Date filtering** with check-in and check-out date support |
| 34 | - **Guest configuration** including adults, children, infants, and pets |
| 35 | - **Price range filtering** with minimum and maximum price constraints |
| 36 | - **Pagination support** for browsing through large result sets |
| 37 | |
| 38 | ### 🏠 Detailed Property Information |
| 39 | - **Comprehensive listing details** including amenities, policies, and highlights |
| 40 | - **Location information** with coordinates and neighborhood details |
| 41 | - **House rules and policies** for informed booking decisions |
| 42 | - **Property descriptions** and key features |
| 43 | - **Direct links** to Airbnb listings for easy booking |
| 44 | |
| 45 | ### 🛡️ Security & Compliance |
| 46 | - **Robots.txt compliance** with configurable override for testing |
| 47 | - **Request timeout management** to prevent hanging requests |
| 48 | - **Enhanced error handling** with detailed logging |
| 49 | - **Rate limiting awareness** and respectful API usage |
| 50 | - **Secure configuration** through MCPB user settings |
| 51 | |
| 52 | ## Installation |
| 53 | |
| 54 | ### For Claude Desktop |
| 55 | This extension is packaged as an MCP Bundle (`.mcpb`) file. To install: |
| 56 | |
| 57 | 1. Download the `.mcpb` file from the [latest release](https://github.com/openbnb-org/mcp-server-airbnb/releases/latest) |
| 58 | 2. Open the file — Claude Desktop will show an installation dialog |
| 59 | 3. Configure the extension settings as needed |
| 60 | |
| 61 | To ignore robots.txt, open Claude Desktop settings, navigate to the extension, and enable the **Ignore robots.txt** toggle. |
| 62 | |
| 63 | ### For Cursor, etc. |
| 64 | |
| 65 | Before starting make sure [Node.js](https://nodejs.org/) is installed on your desktop for `npx` to work. |
| 66 | 1. Go to: Cursor Settings > Tools & Integrations > New MCP Server |
| 67 | |
| 68 | 2. Add one the following to your `mcp.json`: |
| 69 | ```json |
| 70 | { |
| 71 | "mcpServers": { |
| 72 | "airbnb": { |
| 73 | "command": "npx", |
| 74 | "args": [ |
| 75 | "-y", |
| 76 | "@openbnb/mcp-server-airbnb" |
| 77 | ] |
| 78 | } |
| 79 | } |
| 80 | } |
| 81 | ``` |
| 82 | |
| 83 | To ignore robots.txt for all requests, use this version with `--ignore-robots-txt` args |
| 84 | |
| 85 | ```json |
| 86 | { |
| 87 | "mcpServers": { |
| 88 | "airbnb": { |
| 89 | "command": "npx", |
| 90 | "args": [ |
| 91 | "-y", |
| 92 | "@openbnb/mcp-server |