Claude Code · Claude Desktop · claude.ai
Claude can't connect to Airbnb on its own: as of September 2026, Airbnb has no official MCP server or public API. Three third-party routes work, and AirROI's Airbnb MCP server is the one for market data. Connect Claude to Airbnb occupancy, ADR, revenue and comps with one command in Claude Code, or a config entry in Claude Desktop.
MCP protocol 2025-11-25Registry com.airroi/mcp
claude mcp add --transport http airroi \
https://mcp.airroi.com \
--header "X-API-KEY: YOUR_API_KEY" --scope userPaste your API key over the highlighted placeholder, run it, then type /mcp in Claude Code.
Claude has no built-in Airbnb access, and Airbnb publishes no Claude connector. Every route that works runs through a third-party MCP server, and each one does a different job: market data from AirROI, your own bookings from your property-management software, or stay searches from a community scraper.
Analyze a market
This guideAirROI
Occupancy, ADR, RevPAR, revenue, comps, booking pace and live search rank for any market in 190+ countries.
Run your own listings
Hospitable, Guesty, Lodgify, dynamic-pricing tools
Reads and acts on your own reservations, messages, calendars and prices through your software account.
Search stays to book
Community open-source scrapers (run locally)
Loads public airbnb.com pages when you ask and returns listings with links to book.
Airbnb's API is invitation-only for software partners and covers the listings they manage, not the market. Many hosts run a PMS server and AirROI side by side. The Airbnb MCP server overview defines the three kinds; Compare Airbnb MCP servers weighs them by price and failure mode.
claude mcp add command registers AirROI's server with your API key in the X-API-KEY header, and --scope user makes it available in every project. Type /mcp to confirm the connection, then ask your first market question.Create a key on the API key activation page after a $10 minimum deposit. Tool calls start at $0.01, with the same per-call pricing as the REST API; tools/list isn't billed.
Run this with your key in place of the highlighted placeholder. --scope user saves the server to ~/.claude.json for every project; --scope project writes a shared .mcp.json instead, so keep the key out of it if you commit it. Syntax per Anthropic's Claude Code MCP docs.
claude mcp add --transport http airroi \
https://mcp.airroi.com \
--header "X-API-KEY: YOUR_API_KEY" --scope userType /mcp inside Claude Code: airroi should show as connected with its 29 tools. From a terminal, claude mcp list prints ✔ Connected next to it.
claude mcp get airroi # shows the URL and the X-API-KEY header
claude mcp list # lists airroi with its connection statusTry "What's the occupancy and ADR for 2-bedroom homes in Nashville?" Claude picks the tools, asks permission to run them, and names the market, filter and period behind each number.
Which Claude account works
Claude Code needs a Pro, Max, Team, Enterprise or Console account; the free claude.ai plan doesn't include it, so use Claude Desktop there.
Don't have Claude Code?
# macOS, Linux, WSL (recommended native installer)
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Or: brew install --cask claude-code · winget install Anthropic.ClaudeCodeAnthropic's setup guide recommends the native installer. Run claude once to sign in.
Claude Desktop's config file starts local servers, so it reaches AirROI's remote server through mcp-remote, a small Node.js bridge that runs with npx. Add one entry to claude_desktop_config.json with your key in the env block, fully quit and reopen the app, and the AirROI tools appear under Connectors.
npx needs Node.js 18 or later. Check with node --version.airroi entry into mcpServers and put your key in the env block.{
"mcpServers": {
"airroi": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.airroi.com",
"--header",
"X-API-KEY:${AIRROI_API_KEY}"
],
"env": { "AIRROI_API_KEY": "YOUR_API_KEY" }
}
}
}No spaces around the colon
Keep X-API-KEY:${AIRROI_API_KEY} as written. Claude Desktop on Windows doesn't escape spaces in args, so a space after the colon splits the header, as the mcp-remote README warns.
| File | macOS | Windows |
|---|---|---|
| Config | ~/Library/Application Support/Claude/claude_desktop_config.json | %APPDATA%\Claude\claude_desktop_config.json |
| MCP logs | ~/Library/Logs/Claude/mcp*.log | %APPDATA%\Claude\logs |
Local config works on every Claude plan, Free included; Anthropic's MCP launch post says "All Claude.ai plans support connecting MCP servers to the Claude Desktop app." Your assistant still never loads airbnb.com: answers come from mcp.airroi.com.
On claude.ai and the Claude mobile apps, MCP servers arrive as custom connectors, which connect from Anthropic's cloud rather than your computer. AirROI needs an X-API-KEY header, and a custom connector can send one only if your account is in Anthropic's request-header beta. Most individuals should use Claude Code or Claude Desktop instead.
Custom connectors are available on every plan (Free is limited to one). On Free, Pro and Max you add one yourself under Customize → Connectors; on Team and Enterprise, an Owner adds it under Organization settings → Connectors and members connect to it. Sending an API key needs the dialog's Request headers section, a request-header beta Anthropic has opened to "a limited set of organizations." If you don't see that section, your account doesn't have it.
If yours does, whoever adds the connector:
https://mcp.airroi.com as the URL and chooses No sign-in if asked.x-api-key, pastes the AirROI key and marks it Required.The header isn't always sent
A public report, anthropics/claude-ai-mcp #644, describes a connector that ignored its x-api-key header and started an OAuth sign-in instead. Until that's fixed, use Claude Code or Claude Desktop.
A session run against the live AirROI server asked what a 2BR/2BA condo near 1000 Division St in Nashville could earn on Airbnb. The server answered in 2 tool calls: a $52,600 annual estimate and 25 comps with their trailing-12-month revenue, for $0.30. The full session follows.
Prompt
I'm looking at a 2BR/2BA condo that sleeps 6 near 1000 Division St in Nashville's Gulch. What could it earn on Airbnb, and who are my comps?
2 tool calls
airroi_estimate_revenue$0.20address: 1000 Division St, Nashville, TN 37203 · bedrooms: 2 · baths: 2 · guests: 6 · room_type: entire_home · currency: usd
{
"location": {
"latitude": 36.15,
"longitude": -86.78
},
"revenue": 52595.24,
"average_daily_rate": 280.33,
"occupancy": 0.52,
"percentiles": {
"revenue": {
"avg": 52595.24,
"p25": 34247.79,
"p50": 48660.58,
"p75": 65886.56,
"p90": 86396.09
},
"average_daily_rate": {
"avg": 280.33,
"p25": 204.82,
"p50": 254.97,
"p75": 319.54,
"p90": 401.67
},
"occupancy": {
"avg": 0.52,
"p25": 0.39,
"p50": 0.53,
"p75": 0.66,
"p90": 0.76
}
},
"currency": "USD"
}airroi_find_comparables$0.10address: 1000 Division St, Nashville, TN 37203 · bedrooms: 2 · baths: 2 · guests: 6 · room_type: entire_home · currency: usd
{
"listings": [
{
"listing_id": "1391361174237569422",
"name": "Premier Broadway Retreat | 2 King Suites + Pool",
"type": "Entire rental unit",
"location": "Nashville, Tennessee",
"bedrooms": 2,
"baths": 2,
"guests": 6,
"ttm_revenue": 111640,
"ttm_occupancy": 0.66,
"ttm_adr": 399.7
},
{
"listing_id": "41687118",
"name": "City Retreat: Modern Gulch Pad, Downtown Views!",
"type": "Entire condo",
"location": "Nashville-Davidson, Tennessee",
"bedrooms": 2,
"baths": 2,
"guests": 6,
"ttm_revenue": 89841,
"ttm_occupancy": 0.63,
"ttm_adr": 317.8
},
{
"listing_id": "1042967064049451577",
"name": "Midnight Manor Penthouse Suite The Gulch",
"type": "Entire rental unit",
"location": "Nashville-Davidson, Tennessee",
"bedrooms": 2,
"baths": 2,
"guests": 6,
"ttm_revenue": 81187,
"ttm_occupancy": 0.36,
"ttm_adr": 521.9
},
{
"listing_id": "32568787",
"name": "Perfect Pad in the Gulch! 2BR & Gym!",
"type": "Entire rental unit",
"location": "Nashville-Davidson, Tennessee",
"bedrooms": 2,
"baths": 2,
"guests": 6,
"ttm_revenue": 80721,
"ttm_occupancy": 0.65,
"ttm_adr": 280.6
}
]
}Answer written from these results
AirROI estimates about $52,600 a year on average, with a typical range of $34,200 (25th percentile) to $65,900 (75th percentile), at an ADR near $280 and 52% occupancy. The 25 closest 2BR/2BA comps earned a median of $64,205 over the last 12 months. The strongest, "Premier Broadway Retreat | 2 King Suites + Pool," made $111,640 at 66% occupancy and a $400 ADR. Comp revenue spans $17,303 to $111,640, so which comps you benchmark against matters as much as the average.
The estimate's typical range ran from $34,200 to $65,900, at an ADR near $280 and 52% occupancy. For investor, host and property-manager sessions, see Airbnb MCP use cases.
One per job, with the tools Claude usually calls and their Standard cost.
Market snapshot
“Occupancy, ADR and RevPAR for 2-bedroom entire homes in Nashville, last 12 months?”
airroi_search_marketsairroi_market_summaryTool cost: $0.11
Compare markets
“Compare Austin and Nashville for a 2-bedroom entire home: occupancy, ADR, revenue and competing listings.”
airroi_search_marketsairroi_market_summaryTool cost: $0.22
Underwrite a property
“What could a 3-bed, 2-bath house at [address] earn, and who are its closest comps?”
airroi_estimate_revenueairroi_find_comparablesTool cost: $0.30
Seasonality
“Monthly occupancy and ADR for 3-bedroom homes in Scottsdale over the last 12 months.”
airroi_search_marketsairroi_market_occupancyairroi_market_adrTool cost: $0.21
Booking pace
“How is Gatlinburg pacing for the next three months? Show fill rate and booked rates.”
airroi_search_marketsairroi_market_future_pacingTool cost: $0.21
Competitor check
“Live calendar for Airbnb listing [ID]: open nights, rates, minimum stay and cleaning fee.”
airroi_live_calendarTool cost: $0.20
Outside the US, ask for the local currency. Lisbon in euros took one market lookup and one summary call:
Prompt
How does a 1-bedroom entire apartment perform on Airbnb in Lisbon? Give me occupancy, ADR and annual revenue in euros.
2 tool calls
airroi_search_markets$0.01query: Lisbon
airroi_market_summary$0.10Lisbon, Lisbon, Portugal · room_type = entire_home · bedrooms = 1 · num_months: 12 · currency: native
Answer written from these results
Over the last 12 months, 1-bedroom entire homes in Lisbon averaged 57% occupancy at an ADR of €130.60, for RevPAR of €77.20 and about €20,600 in average annual revenue per listing. Guests book 49 days ahead on average and stay 5.1 nights, against an average minimum stay of 4.1 nights. The segment has about 5,120 active listings.
Claude Code does more than chat about the numbers. With AirROI connected, it calls the tools and then writes the results into files on your machine: a CSV of comps, a notebook with monthly ADR charts, or a script that refreshes your market report. For bulk pulls, the export tool writes up to 100,000 listings to one file.
| What Claude Code writes | You ask | Tools it calls |
|---|---|---|
comps.csvOne row per comp, ready for a spreadsheet. | “Save the 25 closest comps to 1000 Division St, Nashville (2BR/2BA) with their 12-month revenue, occupancy and ADR.” | airroi_find_comparables |
market_trends.ipynbBoth charts plus the monthly table behind them. | “Chart 36 months of ADR and occupancy for 2-bedroom homes in Nashville and Austin.” | airroi_market_adrairroi_market_occupancy |
refresh_report.pyCalls the AirROI REST API with the same key, so it runs without a chat. | “Write a script that refreshes my Scottsdale owner-report numbers every month.” | airroi_market_occupancyairroi_market_adr |
airroi_export handles bulk pulls: every listing matching a market, radius or polygon, as CSV or JSONL behind a 7-day download link. It bills one search call per 10 listings, so 1,000 listings cost $50.00. Scheduled scripts can call the AirROI REST API with the same key.
Prefer Codex? See Use Airbnb data in Codex and ChatGPT. Every tool and its price is in Airbnb analytics MCP tools.
Claude Code and Claude Desktop both work with AirROI today. Claude on the web and mobile works only for accounts in Anthropic's request-header beta. The same API key also works in Codex, Cursor, VS Code and n8n, so one AirROI balance covers every client you use.
| Client | Status | How to connect | Config location | Key goes in | Watch out for |
|---|---|---|---|---|---|
Claude Code | Works | claude mcp add --transport http … --header | ~/.claude.json (user scope) or .mcp.json (project scope) | Header flag | Needs a Pro, Max, Team, Enterprise or Console account |
Claude Desktop | Works via mcp-remote | mcp-remote bridge in claude_desktop_config.json | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows) | env block | No spaces around the colon in --header; needs Node.js; restart the app |
Claude on the web and mobile | Limited (beta) | Custom connector set to No sign-in, with the key under Request headers (beta, limited to some organizations) | Customize → Connectors (Team and Enterprise: owners add it under Organization settings → Connectors) | x-api-key request header | Request headers are a limited beta; community reports the header is sometimes not sent (anthropics/claude-ai-mcp #644) |
Using Cursor, VS Code, Devin Desktop or n8n? The Airbnb MCP setup guide has a copy-ready config for each.
Most failures come down to the key not reaching the server, which then answers 401 Missing API key. Find your symptom below, apply the fix, and restart the client if you edited a config file. Claude Code shows the server's error in claude mcp get airroi, and Claude Desktop writes MCP logs to disk.
| Symptom | Where | Fix |
|---|---|---|
claude mcp list shows ✘ Failed to connect with 401 Missing API key | Claude Code | The header is missing or misspelled. Check claude mcp get airroi, then claude mcp remove airroi and add it again. |
| airroi is missing from /mcp in another project | Claude Code | It was added at local scope, which covers one project. Re-add it with --scope user. |
| spawn npx ENOENT, or npx not found, in the log | Claude Desktop | Install Node.js 18 or later, check node --version, then restart Claude Desktop. |
| Tools missing after you edited the config | Claude Desktop | Fix any JSON syntax error, then quit the app from the menu bar or tray; closing the window isn't enough. |
| 401 Missing API key in the log although the key is right | Claude Desktop on Windows | Spaces around the colon split the argument. Use X-API-KEY:${AIRROI_API_KEY} exactly. |
Claude Desktop keeps its logs in ~/Library/Logs/Claude/mcp*.log on macOS and %APPDATA%\Claude\logs on Windows. mcp.log records connection failures; mcp-server-airroi.log holds the bridge's output.
Run claude mcp add --transport http airroi https://mcp.airroi.com --header "X-API-KEY: YOUR_API_KEY" --scope user with your AirROI API key in place of the placeholder, then type /mcp in Claude Code to confirm airroi is connected. --scope user makes it available in every project.
Add an airroi entry to claude_desktop_config.json that runs npx mcp-remote https://mcp.airroi.com --header X-API-KEY:${AIRROI_API_KEY}, with your key in the env block. The file is at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\Claude\claude_desktop_config.json on Windows. Fully quit and reopen the app, and leave no spaces around the colon in the header.
No. Airbnb doesn't publish one, and directory connectors use OAuth or no sign-in, while AirROI requires an API key on every request. Add AirROI yourself instead: one command in Claude Code or a config entry in Claude Desktop, with the same 29 tools.
Only if your account has Anthropic's request-header beta for custom connectors, which is limited to some organizations. With it, you add AirROI under Customize → Connectors (on Team and Enterprise, an Owner adds it for everyone) and enter your key as an x-api-key request header. Community reports say the header isn't always sent (anthropics/claude-ai-mcp #644), so most individuals should use Claude Code or Claude Desktop.
Claude Desktop's local MCP config works on any plan, including Free: "All Claude.ai plans support connecting MCP servers to the Claude Desktop app," per Anthropic's launch post. Claude Code needs a Pro, Max, Team, Enterprise or Console account. AirROI bills separately, per tool call, after a $10 minimum deposit.
Start with one market and one property type, for example: "How does a 1-bedroom entire apartment perform on Airbnb in Lisbon? Give me occupancy, ADR and annual revenue in euros." In a real session, that returned 57% occupancy, a €130.60 ADR and about €20,600 a year, for $0.11 in tool calls. Then ask for comps, a revenue estimate for an address, or a monthly trend.
Usually the key isn't reaching the server, which answers 401 Missing API key. In Claude Code, claude mcp get airroi shows the error on its Issue line. In Claude Desktop, check the logs (~/Library/Logs/Claude/mcp*.log on macOS, %APPDATA%\Claude\logs on Windows), confirm Node.js is installed for npx, and confirm the --header value has no spaces.
One command in Claude Code, then ask about any of 30,000+ markets in 190+ countries. $10 minimum deposit, then calls from $0.01.
Stay ahead of the curve
Join our newsletter for exclusive insights and updates. No spam ever.