Verified against Amadeus Service Optimization help documentation and partner integration docs, July 2026. Sources at the bottom.
Can you connect HotSOS to Claude? Yes, but not the way you connect a modern SaaS tool. HotSOS, the Amadeus service optimization platform that runs work orders for full-service hotels, has no public API, no self-serve developer portal, and no MCP server. What it does have is a built-in Download As Excel export on the service orders list and a set of operational reports. Drop those files into Claude and it becomes a very good analyst for your service order history: response times, recurring defects, workload by trade, rooms that keep coming back.
If your property already holds HotSOS API credentials from Amadeus, obtained through your Implementation Project Manager, there is a third path: your IT team can wrap that API in a small MCP server so Claude queries service orders live. This guide covers all three, honestly labeled.
What you can ask Claude once the data is in front of it
These are the questions a director of engineering or executive housekeeper actually cares about, and they map directly onto what HotSOS captures. According to the Amadeus help documentation, the Service Order Detail report covers who started each task, who completed it, how long it took, which locations required service orders, and which orders were never started or were stopped mid-task. That is exactly the raw material Claude needs.
- "Here is last month's service order export. Which 10 rooms generated the most engineering orders, and what were the issues?"
- "What is our average time from order creation to completion, broken out by trade?"
- "Which service orders sat unstarted for more than 24 hours, and does that cluster on particular days or shifts?"
- "Find recurring defects: issue types that show up in the same room more than once in 90 days."
- "Compare this month's export to last month's. Are housekeeping response times improving or getting worse?"
- "Draft the maintenance summary for the morning ops meeting from yesterday's completed orders."
Claude handles the cross-tabulation, trend math, and drafting. HotSOS remains the system of record; nothing in this guide writes data back.
Prerequisites
For paths 1 and 2 you need only two things: a HotSOS login with access to the service orders list or reports at your property, and Claude, either claude.ai in a browser or the Claude Desktop app. No IT ticket, no credentials beyond what you already use every shift. Path 3 additionally requires HotSOS API credentials from Amadeus and someone comfortable writing a small Node.js or Python service.
The Excel export
This is the workhorse. According to the Amadeus Service Optimization help documentation, the service orders list supports a Filter Builder panel for narrowing to specific data and a Download As Excel action that saves the filtered list as a spreadsheet.
- In HotSOS, open the service orders list.
- Use the Filter Builder to scope what you want to analyze: a date range, a trade, a status, a floor. Each list view keeps its own filters.
- Click Download As Excel.
- Start a chat with Claude, attach the file, and ask your question. For recurring analysis, create a Claude Project called something like "HotSOS weekly" and keep a standing instruction such as: Every file I upload is a HotSOS service order export. Always report completion time by trade and flag repeat locations.
The whole loop takes two or three minutes and needs no approvals. It is also the safest possible integration: read-only by construction, because Claude only ever sees a file you chose to export.
The operational reports
HotSOS ships a set of operational reports. The Amadeus help documentation lists them: Executive Summary, Frequency, Inspection Frequency, Inspection Log, Inspection Order Form Details, Meter Reading with Graphs, Productivity, Property PM Progress, Service Order Detail, and Work Order Form. Each report takes standard parameters; per the documentation, the date range defaults to yesterday and the time range defaults to 12:00 AM to 11:59 PM, both adjustable.
- Tap the reports icon in the left sidebar, then Operational.
- Pick the report. For response time and defect analysis, Service Order Detail is the dense one. For a leadership recap, Executive Summary.
- Set the parameters and tap the Run Report icon. A notification lands in your Messages List when the report is ready.
- Save the report output and hand it to Claude the same way as the Excel export, with a prompt about what you want pulled out of it.
Reports and exports complement each other: the export gives Claude row-level data to compute on, while a report like the Executive Summary gives it the framing your GM already recognizes. Uploading both and asking Claude to reconcile them is a genuinely useful sanity check.
The partner API, wrapped in your own MCP server
The HotSOS API is real, and a live integration ecosystem runs on it. But access is gated. Pandium's connector documentation states that the connector authenticates with basic auth using an API base URL, username, and password, and says plainly: for more information on how to utilize the HotSOS API, reach out to your Amadeus Implementation Project Manager. PolyAI's integration documentation similarly lists a REST or SOAP endpoint (its example is https://ifc.emea.hot-sos.net/api/service.svc/rest) with credentials provided by Amadeus.
So the honest version of this path is:
- Ask Amadeus first. Your Implementation Project Manager or account team is the only route to API documentation and credentials. If you are a brand or management company, this usually rides on your existing enterprise relationship.
- Once you hold credentials, the technical lift is small: an MCP server is a lightweight program that exposes API calls to Claude as tools. Anthropic's Model Context Protocol SDKs (TypeScript and Python) make a read-only wrapper, with tools like list-service-orders and get-service-order, an afternoon of work for whoever owns your integrations.
- Keep it read-only. HotSOS dispatches real people to real rooms. Claude should analyze the queue, not write to it, at least until your team has lived with the read-only version for a while.
We are deliberately not publishing endpoint-by-endpoint sample code here, because the HotSOS API surface is not publicly documented and pretending otherwise is how vague guides get written. If you have the credentials and the Amadeus docs in hand, our Guesty and Breezeway guides show the exact MCP server pattern to copy, tool definitions, config file and all.
Which path is yours?
| Path | Who can do it | Freshness | Effort |
|---|---|---|---|
| 1. Excel export | Anyone with a HotSOS login | As fresh as your last download | Minutes, no approvals |
| 2. Reports | Anyone with report access | Run on demand; date range defaults to yesterday | Minutes, no approvals |
| 3. API + MCP | Properties holding Amadeus-issued credentials | Live queries | An Amadeus conversation, then an afternoon of IT time |
A note on the photos. HotSOS caps attachments at 6 photos or 10 MB per service order, per the Amadeus help documentation, so the photo trail on each order is thin by design: enough to document the fix, not enough to systematically catch what nobody wrote an order for.
That gap is what RapidEye works on: AI inspection intelligence that analyzes room and turnover photo documentation to surface damage and defects before they become guest-reported service orders. If your team already photographs rooms, it plugs into that habit. Or see our API if you want detections in your own stack.
Troubleshooting
I can't find Download As Excel
The Download As Excel action lives on the service orders list in the web application, not in every HotSOS Mobile view. If you work primarily from the mobile app, do exports from a desktop session. If the list view loads but the action is missing, your role's permissions are the likely cause; ask your HotSOS administrator.
The export has codes instead of readable names
HotSOS properties lean heavily on standardized issue codes. Claude handles this well if you help it once: paste your property's issue code list into the chat (or the Project's instructions) and tell Claude to translate codes to plain English in every answer. Do the same for location and trade codes.
My report never shows up
Reports run asynchronously. Per the Amadeus documentation, a notification alerts you when the report is available to view in your Messages List, so check there rather than waiting on the report screen. Very wide date ranges take longer; if a big report stalls, narrow the range and run it in slices. Claude can stitch the slices back together.
Someone is selling us a "HotSOS AI connector"
Ask one question: where do the API credentials come from? Legitimate integrations (Pandium, PolyAI, and the rest of the ecosystem) authenticate with credentials issued by Amadeus, and any real vendor will say so immediately. If the answer is evasive, the product is likely automating a browser session against your HotSOS login, which is fragile and probably violates your agreement.
Is it safe to upload service order data to Claude?
Treat exports as operational data: they contain room numbers, staff names, and sometimes guest names. Use a Claude plan whose data handling your property has reviewed and approved (Anthropic publishes its commercial data terms; Claude for Work is the plan tier built for business data), strip guest-identifying columns if policy requires it, and check with your brand's data team if you operate under a franchise agreement.
FAQ
Does HotSOS have a public API?
No. The API exists and powers a real integration ecosystem, but it is partner and enterprise gated. Vendors that connect to it document that credentials, an API base URL with username and password, or an API key, are provided by Amadeus, and Pandium's docs direct customers to their Amadeus Implementation Project Manager for API information. There is no portal where a hotel can self-serve a key.
Does HotSOS have an MCP server?
No. As of July 2026 we could find no official Amadeus MCP server for HotSOS and no community server on npm, GitHub, or the public MCP directories. If that changes, this page will be updated; it is exactly the kind of thing Amadeus could ship on top of the existing API.
Can you connect HotSOS to Claude at all?
Yes, three ways: the built-in Download As Excel export from the service orders list, the operational reports such as Service Order Detail, and, for properties holding Amadeus-issued API credentials, a self-built MCP server wrapping the partner API. For most teams the export path is the right answer and takes minutes.
How many photos can a HotSOS service order hold?
Up to 6 photos or 10 MB per service order, per the Amadeus Service Optimization help documentation. Attachments can be viewed, downloaded, or deleted from the order's Attachments section.
What about writing back, having Claude create service orders?
Technically possible on path 3 only, since guest-facing tools like PolyAI already log requests into HotSOS through the API. We recommend against it as a starting point: begin read-only, build trust in the analysis, and add writes only with your Amadeus contact's blessing and a human confirming each order.
Sources
- Service orders (Amadeus Service Optimization help): Filter Builder and Download As Excelhttps://help.amadeus-hospitality.com/operations/service-optimization/content/service-orders.html
- Service order attachments (Amadeus help): 6 photos or 10 MB per service orderhttps://help.amadeus-hospitality.com/operations/service-optimization/hotsos/content/service-orders-attach.html
- Overview: Reports (Amadeus help): report list and Messages List deliveryhttps://help.amadeus-hospitality.com/operations/service-optimization/hotsos/content/reports-overview.html
- Service Order Detail report (Amadeus help)https://help.amadeus-hospitality.com/operations/service-optimization/hotsos/content/service-order-detail-report.html
- Standard report parameters (Amadeus help): date and time range defaultshttps://help.amadeus-hospitality.com/operations/service-optimization/hotsos/content/report-standard-parameters.html
- HotSOS connector (Pandium docs): basic auth and the Amadeus Implementation Project Manager routehttps://docs.pandium.com/connectors/connectors-101/hotsos
- HotSOS integration (PolyAI docs): REST/SOAP endpoint, credentials provided by Amadeushttps://docs.poly.ai/integrations/hotSOS
- HotSOS Optimization (Amadeus Hospitality product page)https://www.amadeus-hospitality.com/service-optimization-software/hotsos/
HotSOS is a product of Amadeus Hospitality. RapidEye is not affiliated with or endorsed by Amadeus; references are editorial. Details verified against the sources above in July 2026; if Amadeus ships a public API or MCP server, this page will be updated.
More guides in this series
All Claude guides
Every PMS and ops platform we have connected to Claude, with working code where the API allows it.
Hotel PMSConnect Cloudbeds to Claude
The hotel-side PMS guide, for properties on Cloudbeds rather than an enterprise stack.
Ops platformConnect Breezeway to Claude
The short-term rental counterpart to HotSOS, and the MCP pattern to copy for path 3.

