Skip to content
Back to search

mcp-server-airbnb

Search Airbnb using your AI Agent

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/openbnb-org--mcp-server-airbnb/badge.svg)](/listings/openbnb-org--mcp-server-airbnb)

HTML

<a href="/listings/openbnb-org--mcp-server-airbnb"><img src="/api/listings/openbnb-org--mcp-server-airbnb/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

For Claude Desktop

This extension is packaged as an MCP Bundle (`.mcpb`) file. To install:

1. Download the `.mcpb` file from the [latest release](https://github.com/openbnb-org/mcp-server-airbnb/releases/latest) 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](https://nodejs.org/) 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`: ```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

```json { "mcpServers": { "airbnb": { "command": "npx", "args": [ "-y", "@openbnb/mcp-server-airbnb", "--ignore-robots-txt" ] } } } ``` 3. Restart.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 291 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [![downloads](https://img.shields.io/npm/dm/@openbnb/mcp-server-airbnb)](https://www.npmjs.com/package/@openbnb/mcp-server-airbnb)
  2. # Airbnb Search & Listings - MCP Bundle (MCPB)
  3. 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.
  4. ---
  5. ## 🚀 Prefer not to run a local server? Try [openbnb.ai](https://openbnb.ai/)
  6. > **👉 [openbnb.ai](https://openbnb.ai/) is a hosted MCP server that solves the same problem — searching Airbnb listings — without any local setup.**
  7. 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:
  8. - ✅ **Zero setup** — no Node, no `npx`, no config files, no updates to manage
  9. - ✅ **Advanced filters** — richer search controls beyond the base tools here
  10. - ✅ **MCP UI** — interactive UI components for browsing results, not just plain text
  11. - ✅ **Managed & maintained** — kept running for you
  12. Head to **[openbnb.ai](https://openbnb.ai/)** for setup instructions and the connection details for your MCP client.
  13. If you'd rather self-host the open-source server, read on.
  14. ---
  15. ## Features
  16. ### 🔍 Advanced Search Capabilities
  17. - **Location-based search** with support for cities, states, and regions
  18. - **International location support** via client-side geocoding, so non-US queries (e.g. "Paris, France", "Copenhagen, Denmark") return results in the right city
  19. - **Google Maps Place ID** integration for precise location targeting
  20. - **Property type filtering** for entire homes, private rooms, shared rooms, or hotel rooms
  21. - **Date filtering** with check-in and check-out date support
  22. - **Guest configuration** including adults, children, infants, and pets
  23. - **Price range filtering** with minimum and maximum price constraints
  24. - **Pagination support** for browsing through large result sets
  25. ### 🏠 Detailed Property Information
  26. - **Comprehensive listing details** including amenities, policies, and highlights
  27. - **Location information** with coordinates and neighborhood details
  28. - **House rules and policies** for informed booking decisions
  29. - **Property descriptions** and key features
  30. - **Direct links** to Airbnb listings for easy booking
  31. ### 🛡️ Security & Compliance
  32. - **Robots.txt compliance** with configurable override for testing
  33. - **Request timeout management** to prevent hanging requests
  34. - **Enhanced error handling** with detailed logging
  35. - **Rate limiting awareness** and respectful API usage
  36. - **Secure configuration** through MCPB user settings
  37. ## Installation
  38. ### For Claude Desktop
  39. This extension is packaged as an MCP Bundle (`.mcpb`) file. To install:
  40. 1. Download the `.mcpb` file from the [latest release](https://github.com/openbnb-org/mcp-server-airbnb/releases/latest)
  41. 2. Open the file — Claude Desktop will show an installation dialog
  42. 3. Configure the extension settings as needed
  43. To ignore robots.txt, open Claude Desktop settings, navigate to the extension, and enable the **Ignore robots.txt** toggle.
  44. ### For Cursor, etc.
  45. Before starting make sure [Node.js](https://nodejs.org/) is installed on your desktop for `npx` to work.
  46. 1. Go to: Cursor Settings > Tools & Integrations > New MCP Server
  47. 2. Add one the following to your `mcp.json`:
  48. ```json
  49. {
  50. "mcpServers": {
  51. "airbnb": {
  52. "command": "npx",
  53. "args": [
  54. "-y",
  55. "@openbnb/mcp-server-airbnb"
  56. ]
  57. }
  58. }
  59. }
  60. ```
  61. To ignore robots.txt for all requests, use this version with `--ignore-robots-txt` args
  62. ```json
  63. {
  64. "mcpServers": {
  65. "airbnb": {
  66. "command": "npx",
  67. "args": [
  68. "-y",
  69. "@openbnb/mcp-server-airbnb",
  70. "--ignore-robots-txt"
  71. ]
  72. }
  73. }
  74. }
  75. ```
  76. 3. Restart.
  77. ## Configuration
  78. The extension provides the following user-configurable options:
  79. ### Ignore robots.txt
  80. - **Type**: Boolean (checkbox)
  81. - **Default**: `false`
  82. - **Description**: Bypass robots.txt restrictions when making requests to Airbnb
  83. - **Recommendation**: Keep disabled unless needed for testing purposes
  84. ### Disable third-party geocoding
  85. - **Type**: Boolean (checkbox)
  86. - **Environment variable**: `DISABLE_GEOCODING`
  87. - **Default**: `false`
  88. - **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.
  89. - **Recommendation**: Keep disabled unless you specifically need zero third-party outbound traffic. With it enabled, non-US searches could return incorrect results. See [External Services](#external-services).
  90. ## Tools
  91. ### `airbnb_search`
  92. Search for Airbnb listings with comprehensive filtering options.
  93. **Parameters:**
  94. - `location` (required): Location to search (e.g., "San Francisco, CA"). When supplied without `placeId`, the server geocodes this string client-side via Photon/Nominatim — see [External Services](#external-services).
  95. - `placeId` (optional): Google Maps Place ID. Overrides `location` and skips client-side geocoding entirely (no third-party calls).
  96. - `checkin` (optional): Check-in date in YYYY-MM-DD format
  97. - `checkout` (optional): Check-out date in YYYY-MM-DD format
  98. - `adults` (optional): Number of adults (default: 1)
  99. - `children` (optional): Number of children (default: 0)
  100. - `infants` (optional): Number of infants (default: 0)
  101. - `pets` (optional): Number of pets (default: 0)
  102. - `minPrice` (optional): Minimum price per night
  103. - `maxPrice` (optional): Maximum price per night
  104. - `cursor` (optional): Pagination cursor for browsing results
  105. - `propertyType` (optional): Filter by property type — `entire_home`, `private_room`, `shared_room`, or `hotel_room`
  106. - `ignoreRobotsText` (optional): Override robots.txt for this request
  107. **Returns:**
  108. - Search results with property details, pricing, and direct links
  109. - Pagination information for browsing additional results
  110. - Search URL for reference
  111. ### `airbnb_listing_details`
  112. Get detailed information about a specific Airbnb listing.
  113. **Parameters:**
  114. - `id` (required): Airbnb listing ID
  115. - `checkin` (optional): Check-in date in YYYY-MM-DD format
  116. - `checkout` (optional): Check-out date in YYYY-MM-DD format
  117. - `adults` (optional): Number of adults (default: 1)
  118. - `children` (optional): Number of children (default: 0)
  119. - `infants` (optional): Number of infants (default: 0)
  120. - `pets` (optional): Number of pets (default: 0)
  121. - `ignoreRobotsText` (optional): Override robots.txt for this request
  122. **Returns:**
  123. - Detailed property information including:
  124. - Location details with coordinates
  125. - Amenities and facilities, as `seeAllAmenitiesGroups` — an object keyed by amenity category, so a category can be addressed directly. Amenities Airbnb shows struck through arrive under its own `"Not included"` category:
  126. ```json
  127. {
  128. "seeAllAmenitiesGroups": {
  129. "Bathroom": "Hair dryer",
  130. "Heating and cooling": "AC - split type ductless system, Heating",
  131. "Not included": "Dryer, Hot water"
  132. }
  133. }
  134. ```
  135. - House rules and policies
  136. - Property highlights and descriptions
  137. - Direct link to the listing
  138. ## Technical Details
  139. ### Architecture
  140. - **Runtime**: Node.js 18+
  141. - **Protocol**: Model Context Protocol (MCP) via stdio transport
  142. - **Format**: MCP Bundle (MCPB) v0.3
  143. - **Dependencies**: Minimal external dependencies for security and reliability
  144. ### External Services
  145. In addition to `airbnb.com`, the server makes geocoding requests to two third-party services to translate location queries into accurate map bounding boxes. This bypasses Airbnb's own server-side geocoder, which produces incorrect results for many non-US queries (e.g. "Paris, France" lands in Vendée; "Copenhagen, Denmark" lands in Wisconsin).
  146. | Service | Endpoint | Used for | Notes |
  147. | --- | --- | --- | --- |
  148. | [Photon](https://photon.komoot.io/) | `photon.komoot.io` | Primary geocoder, called on every search without `placeId` | Free OSM-based service hosted by Komoot. One request per search. |
  149. | [Nominatim](https://nominatim.openstreetmap.org/) | `nominatim.openstreetmap.org` | Fallback geocoder, called only when Photon does not return a bounding box | Subject to the [OSMF usage policy](https://operations.osmfoundation.org/policies/nominatim/) (max ~1 req/sec). |
  150. Each search sends only the `location` string from the request to the geocoder — no other request fields, no IP geolocation, no tracking identifiers. The location string itself is, of course, the same string the user typed.
  151. **Opting out:** there are two ways to skip the geocoders:
  152. - **Per-request:** supply an explicit `placeId`. When `placeId` is present, the server uses Airbnb's own place lookup directly with no third-party calls.
  153. - **Globally:** set the environment variable `DISABLE_GEOCODING=true`. The server will skip Photon/Nominatim entirely and pass the raw location string to Airbnb. This restores the pre-PR behavior for every search and guarantees zero third-party outbound traffic — at the cost of broken results for non-US locations that Airbnb's own geocoder mishandles. Defaults to `false`.
  154. If a geocoder is unreachable or returns no result, the server falls back to sending the location string to Airbnb directly, exactly as it did before — so the worst case for an outage is that international searches degrade to the previous (broken) behavior, not that the search fails entirely.
  155. ### Error Handling
  156. - Comprehensive error logging with timestamps
  157. - Graceful degradation when Airbnb's page structure changes
  158. - Timeout protection for network requests
  159. - Detailed error messages for troubleshooting
  160. ### Security Measures
  161. - Robots.txt compliance by default
  162. - Request timeout limits
  163. - Input validation and sanitization
  164. - Secure environment variable handling
  165. - No sensitive data storage
  166. ### Performance
  167. - Efficient HTML parsing with Cheerio
  168. - Request caching where appropriate
  169. - Minimal memory footprint
  170. - Fast startup and response times
  171. ## Compatibility
  172. - **Platforms**: macOS, Windows, Linux
  173. - **Node.js**: 18.0.0 or higher
  174. - **Claude Desktop**: 0.10.0 or higher
  175. - **Other MCP clients**: Compatible with any MCP-supporting application
  176. ## Development
  177. ### Building from Source
  178. ```bash
  179. # Install dependencies
  180. npm install
  181. # Build the project
  182. npm run build
  183. # Watch for changes during development
  184. npm run watch
  185. ```
  186. ### Testing
  187. ```bash
  188. # Build, then run both suites
  189. npm test
  190. ```
  191. `npm test` drives the built server over stdio and calls the tools for real:
  192. - `test-extension.js` — MCP handshake, tool listing, a search, listing details, and the geocoding paths (Photon, Nominatim fallback)
  193. - `test-amenities.js` — amenity extraction across several live listings, checking that amenities Airbnb strikes through never appear as ones the listing offers
  194. Both hit `airbnb.com` and the geocoders over the network, so they need connectivity and can fail if Airbnb changes its page structure — that's the point of them, but it also means they aren't suitable as an unattended CI gate.
  195. The server can also be run directly:
  196. ```bash
  197. # Run with robots.txt compliance (default)
  198. node dist/index.js
  199. # Run with robots.txt ignored (for testing)
  200. node dist/index.js --ignore-robots-txt
  201. ```
  202. ## Legal and Ethical Considerations
  203. - **Respect Airbnb's Terms of Service**: This extension is for legitimate research and booking assistance
  204. - **Robots.txt Compliance**: The extension respects robots.txt by default
  205. - **Rate Limiting**: Be mindful of request frequency to avoid overwhelming Airbnb's servers
  206. - **Data Usage**: Only extract publicly available information for legitimate purposes
  207. ## Support
  208. - **Issues**: Report bugs and feature requests on [GitHub Issues](https://github.com/openbnb-org/mcp-server-airbnb/issues)
  209. - **Documentation**: Additional documentation available in the repository
  210. - **Community**: Join discussions about MCP and MCPB development
  211. ## License
  212. MIT License - see [LICENSE](LICENSE) file for details.
  213. ## Contributing
  214. Contributions are welcome! Please read the contributing guidelines and submit pull requests for any improvements.
  215. ---
  216. **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.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.