Airbnb MCP server for AI agents
Let Claude, ChatGPT or your own agent read Airbnb: 9 typed functions through one MCP server. No Airbnb API key needed.
- Site
- airbnb.com
- Functions
- 9
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Airbnb alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/airbnbOne MCP server for Airbnb and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
bookListingReserve or book an Airbnb stay: returns the checkout link, never books or pays.Arguments
Name Type Required args{ url?: string, id?: string, checkin: string, checkout: string, adults?: number, currency?: string }Yes Returns
AirbnbCheckoutHandoff// The checkout handoff: where the PERSON finishes. Bowmark never pays, books or orders. // Switch on `status`; a status you do not recognise means "show the person `url` and stop". interface AirbnbCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; // the https page to open on the site urlKind?: "carries_items" | "signed_in_cart" | "product_page"; // ready_to_checkout only: does the link carry the items, or only open the item's page reason?: string; // unavailable only: out_of_stock | not_available_for_dates | not_sold_online | region_not_served | quantity_unavailable | empty_cart detail?: string; // unavailable only: one sentence saying why account: { site: string; hint: string; signedInAs?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string } | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/bookListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.bookListing({ id: "not-a-listing", checkin: { $daysFromNow: 60 }, checkout: { $daysFromNow: 64 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.bookListing({ "id": "not-a-listing", "checkin": {"$daysFromNow": 60}, "checkout": {"$daysFromNow": 64} }))curl -X POST https://api.bowmark.ai/v1/sites/airbnb/bookListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"not-a-listing","checkin":{"$daysFromNow":60},"checkout":{"$daysFromNow":64}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.bookListing({ id: "not-a-listing", checkin: { $daysFromNow: 60 }, checkout: { $daysFromNow: 64 } });getHostProfileA vacation rental host's public Airbnb profile (airbnb.com/users/show/<id>): name, about text, where they live, Superhost and identity-verified…Arguments
Name Type Required args{ hostId?: string, url?: string, listing?: string }Yes Returns
AirbnbHostProfileinterface AirbnbHostListing { id: string; title: string | null; propertyType: string | null; // the site's own labels, read the values off a result, never guess one from prose bedrooms: number | null; beds: number | null; bathrooms: number | null; rating: number | null; reviewCount: number | null; isSuperhost: boolean; photoUrl: string | null; url: string; } interface AirbnbHostProfile { id: string; url: string; name: string | null; about: string | null; location: string | null; isSuperhost: boolean; isIdentityVerified: boolean; /** What the host has verified, e.g. ["Identity", "Email address"]. */ verifications: string[]; yearsHosting: number | null; monthsHosting: number | null; memberForYears: number | null; /** e.g. "Verified since January 2019". */ verifiedSince: string | null; rating: number | null; reviewCount: number | null; languages: string | null; /** How many listings the host runs; 'listings' holds the first page of them. */ listingCount: number | null; listings: AirbnbHostListing[]; /** A few of the guest reviews the profile page shows, newest first. */ recentReviews: Array<{ date: string | null; rating: number | null; text: string | null; reviewerName: string | null }>; profilePhotoUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/getHostProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.getHostProfile({ hostId: "57441707" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.getHostProfile({"hostId": "57441707"}))curl -X POST https://api.bowmark.ai/v1/sites/airbnb/getHostProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"hostId":"57441707"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.getHostProfile({ hostId: "57441707" });getListingIs one Airbnb vacation rental available for given dates, and what does it cost per night: pass its /rooms/<id> url (or the id that search returns).Arguments
Name Type Required args{ url?: string, id?: string, checkin?: string, checkout?: string, adults?: number, months?: number, currency?: string }Yes Returns
AirbnbListingAvailabilityinterface AirbnbCalendarDay { date: string; available: boolean; availableForCheckin: boolean; availableForCheckout: boolean; minNights: number | null; maxNights: number | null; } interface AirbnbQuote { total: string | null; originalTotal: string | null; qualifier: string | null; nights: number | null; nightlyRate: string | null; lines: Array<{ description: string; price: string | null }>; } interface AirbnbListingAvailability { id: string; url: string; currency: string; checkin: string | null; checkout: string | null; adults: number; available: boolean | null; unavailableReason: string | null; quote: AirbnbQuote | null; calendar: AirbnbCalendarDay[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/getListingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.getListing({ id: "48491509", months: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.getListing({"id": "48491509", "months": 1}))curl -X POST https://api.bowmark.ai/v1/sites/airbnb/getListing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"48491509","months":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.getListing({ id: "48491509", months: 1 });getListingDetailsEverything the Airbnb listing page (airbnb.com/rooms/<id>) shows about one vacation rental or short-term stay, no dates needed: title, property type…Arguments
Name Type Required args{ url?: string, id?: string }Yes Returns
AirbnbListingDetailsinterface AirbnbAmenity { group: string | null; title: string; /** False for the "Not included" rows the site also lists. */ available: boolean; note: string | null; } interface AirbnbListingDetails { id: string; url: string; title: string | null; /** The site's own headline, e.g. "Entire chalet in Mont-Tremblant, Canada". */ propertyType: string | null; spaceType: string | null; description: string | null; guests: number | null; bedrooms: number | null; beds: number | null; bathrooms: number | null; rating: number | null; reviewCount: number | null; isGuestFavorite: boolean; categoryRatings: Array<{ category: string; rating: number | null }>; /** Share of reviews per star, e.g. { stars: 5, share: 0.83 }. */ ratingDistribution: Array<{ stars: number; share: number }>; highlights: Array<{ headline: string; body: string | null }>; amenities: AirbnbAmenity[]; sleeping: Array<{ room: string; beds: string[] }>; houseRules: Array<{ group: string; rule: string; detail: string | null }>; safety: string[]; petsAllowed: boolean | null; location: { label: string | null; latitude: number | null; longitude: number | null; exact: boolean | null; breadcrumbs: Array<{ title: string; url: string }>; nearbyCities: Array<{ title: string; url: string }>; }; host: { id: string | null; name: string | null; isSuperhost: boolean; isVerified: boolean; reviewCount: number | null; rating: number | null; yearsHosting: number | null; responseRate: string | null; responseTime: string | null; coHosts: string[]; }; photos: Array<{ url: string; caption: string | null; room: string | null }>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/getListingDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.getListingDetails({ id: "48491509" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.getListingDetails({"id": "48491509"}))curl -X POST https://api.bowmark.ai/v1/sites/airbnb/getListingDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"48491509"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.getListingDetails({ id: "48491509" });getListingReviewsGuest reviews of one Airbnb vacation rental, read from the listing page's own reviews panel: each with star rating, date, full text, reviewer first…Arguments
Name Type Required args{ url?: string, id?: string, sort?: "mostRecent" | "highestRated" | "lowestRated" | "bestQuality", limit?: number, offset?: number }Yes Returns
AirbnbListingReviewsinterface AirbnbReview { id: string; rating: number | null; /** ISO timestamp the review was posted. */ date: string | null; /** The site's own display date, e.g. "October 2026". */ displayDate: string | null; text: string | null; language: string | null; reviewerName: string | null; reviewerLocation: string | null; /** e.g. "Stayed a few nights". */ stayNote: string | null; hostResponse: string | null; } interface AirbnbListingReviews { id: string; url: string; sort: "mostRecent" | "highestRated" | "lowestRated" | "bestQuality"; /** All reviews the listing has, not only this page. */ totalCount: number | null; offset: number; reviews: AirbnbReview[]; /** Pass as 'offset' for the next page; null when this was the last. */ nextOffset: number | null; /** Guest-mentioned topics with counts, e.g. { tag: "Location", count: 124 }. */ topics: Array<{ tag: string; count: number }>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/getListingReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.getListingReviews({ id: "48491509", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.getListingReviews({"id": "48491509", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/airbnb/getListingReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"48491509","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.getListingReviews({ id: "48491509", limit: 3 });getPriceQuoteThe total price of staying at one Airbnb vacation rental for given dates, with every line the booking panel shows (nightly rate times nights…Arguments
Name Type Required args{ url?: string, id?: string, checkin: string, checkout: string, adults?: number, currency?: string }Yes Returns
AirbnbListingAvailabilityinterface AirbnbCalendarDay { date: string; available: boolean; availableForCheckin: boolean; availableForCheckout: boolean; minNights: number | null; maxNights: number | null; } interface AirbnbQuote { total: string | null; originalTotal: string | null; qualifier: string | null; nights: number | null; nightlyRate: string | null; lines: Array<{ description: string; price: string | null }>; } interface AirbnbListingAvailability { id: string; url: string; currency: string; checkin: string | null; checkout: string | null; adults: number; available: boolean | null; unavailableReason: string | null; quote: AirbnbQuote | null; calendar: AirbnbCalendarDay[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/getPriceQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.getPriceQuote({ id: "48491509", checkin: { $daysFromNow: 60 }, checkout: { $daysFromNow: 64 }, adults: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.getPriceQuote({ "id": "48491509", "checkin": {"$daysFromNow": 60}, "checkout": {"$daysFromNow": 64}, "adults": 2 }))curl -X POST https://api.bowmark.ai/v1/sites/airbnb/getPriceQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"48491509","checkin":{"$daysFromNow":60},"checkout":{"$daysFromNow":64},"adults":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.getPriceQuote({ id: "48491509", checkin: { $daysFromNow: 60 }, checkout: { $daysFromNow: 64 }, adults: 2 });listTripsThe signed-in guest's own trips from the Trips tab (airbnb.com/trips).Arguments
Name Type Required args{ limit?: number }No Returns
AirbnbTripsinterface AirbnbTrip { id: string; // the site's global id internalId: string | null; // the numeric id /trips/v1/<internalId> takes title: string | null; status: string; // the site's own word: "UPCOMING" | "PAST" | "PENDING" | "CANCELED" cancelled: boolean; upcoming: boolean; startTime: string | null; // ISO, as the site sends it endTime: string | null; imageUrl: string | null; url: string | null; // the trip's own page } interface AirbnbTrips { trips: AirbnbTrip[]; // newest first; [] when the caller has none }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/listTripsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.listTrips();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.listTrips())curl -X POST https://api.bowmark.ai/v1/sites/airbnb/listTrips \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.listTrips();searchSearch vacation rentals and short-term stays (homes, apartments, cabins, rooms) on Airbnb for a free-text location (e.g. "San Francisco", "Austin…Arguments
Name Type Required args{ location: string, checkin?: string, checkout?: string, adults?: number, children?: number, infants?: number, pets?: number, minPrice?: number, maxPrice?: number, roomType?: "entire_home" | "private_room" | "shared_room" | "hotel_room", minBedrooms?: number, minBeds?: number, minBathrooms?: number, page?: number }Yes Returns
AirbnbListing[]interface AirbnbListing { id: string; title: string; subtitle: string | null; rating: number | null; reviewCount: number | null; price: string | null; photoUrl: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.search({ location: "San Francisco", checkin: { $daysFromNow: 30 }, checkout: { $daysFromNow: 35 }, adults: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.search({ "location": "San Francisco", "checkin": {"$daysFromNow": 30}, "checkout": {"$daysFromNow": 35}, "adults": 2 }))curl -X POST https://api.bowmark.ai/v1/sites/airbnb/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"location":"San Francisco","checkin":{"$daysFromNow":30},"checkout":{"$daysFromNow":35},"adults":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.search({ location: "San Francisco", checkin: { $daysFromNow: 30 }, checkout: { $daysFromNow: 35 }, adults: 2 });searchExperiencesTours, classes and things to do (Airbnb Experiences: guided walks, cooking classes, activities) for a city, from the place's own things-to-do page…Arguments
Name Type Required args{ location: string }Yes Returns
AirbnbExperience[]interface AirbnbExperience { id: string; title: string; category: string | null; city: string | null; description: string | null; rating: number | null; reviewCount: number | null; photoUrl: string | null; url: string; /** The landing page's own shelf, e.g. "Top-rated activities". */ shelf: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/airbnb/searchExperiencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.airbnb.searchExperiences({ location: "Lisbon, Portugal" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.airbnb.searchExperiences({"location": "Lisbon, Portugal"}))curl -X POST https://api.bowmark.ai/v1/sites/airbnb/searchExperiences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"location":"Lisbon, Portugal"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.airbnb.searchExperiences({ location: "Lisbon, Portugal" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/airbnb/<function> - OpenAPI
/v1/sites/airbnb/openapi.json