Hostaway MCP by usefulapi
by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi
Manage Hostaway listings, reservations, calendar, guest messages, reviews and tasks.
20 tools: 6 can delete or cancel things, 1 change things and 13 only read.
Scanned Oct 21, 2026
- Deletes or cancels6Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things1Claude Code: ask: see these tools
- Only reads13Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http hostaway https://hostaway.usefulapi.io/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
20 tools
Deletes or cancels 6Claude Code: deny
hostaway_create_reservationCreate a new reservation on a listing (it blocks the calendar and syncs to connected channels).No findings
Why it is in this group
- The name "hostaway_create_reservation" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Create a new reservation on a listing (it blocks the calendar and syncs to connected channels). Only channelId 2000 (direct, the default), 2002 (homeaway) or 2020 (partner) are accepted. To price it correctly, call hostaway_calculate_price first and pass its total as totalPrice. Overbooking protection is always left on. Hostaway: POST /v1/reservations.
Annotations the server declares
- title: Create a reservation
- destructiveHint: true
hostaway_create_taskCreate an operational task — e.g.No findings
Why it is in this group
- The name "hostaway_create_task" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Create an operational task — e.g. a cleaning after a checkout or a maintenance job — optionally tied to a listing and reservation, assigned to a user, with a time window, category and cost. Hostaway: POST /v1/tasks.
Annotations the server declares
- title: Create a task
- destructiveHint: true
hostaway_send_messageSend a message to the guest in a conversation — it is delivered immediately and cannot be recalled.No findings
Why it is in this group
- The name "hostaway_send_message" says "send": a word for sending, and what is sent cannot be taken back.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Send a message to the guest in a conversation — it is delivered immediately and cannot be recalled. Delivered by email by default, or via the booking channel, SMS or WhatsApp. Attachments are not supported. Rate-limited by Hostaway to 30 messages per minute. Hostaway: POST /v1/conversations/{conversationId}/messages.
Annotations the server declares
- title: Send a guest message
- destructiveHint: true
hostaway_update_calendarChange availability and/or pricing for a date range on one listing, pushed to every connected channel: block (isAvailable=false) or open days, set the nightly price, min/max stay, …No findings
Why it is in this group
- The name "hostaway_update_calendar" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Change availability and/or pricing for a date range on one listing, pushed to every connected channel: block (isAvailable=false) or open days, set the nightly price, min/max stay, closed-to-arrival/departure, or a note. For multi-unit listings set desiredUnitsToSell instead of isAvailable (0 blocks). Hostaway: PUT /v1/listings/{listingId}/calendar.
Annotations the server declares
- title: Update listing calendar
- destructiveHint: true
hostaway_update_reservationChange fields on an existing reservation — guest details and counts, dates, check-in/out hours, door code, host note or comment.No findings
Why it is in this group
- The name "hostaway_update_reservation" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Change fields on an existing reservation — guest details and counts, dates, check-in/out hours, door code, host note or comment. Send only the fields to change. The listing cannot be changed, and this tool never cancels or reprices a booking. Date changes on channel bookings may be overwritten by the channel. Hostaway: PUT /v1/reservations/{reservationId}.
Annotations the server declares
- title: Update a reservation
- destructiveHint: true
hostaway_update_taskUpdate a task — change its status (e.g.No findings
Why it is in this group
- The name "hostaway_update_task" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Update a task — change its status (e.g. completed), reassign it, move its window, or add a resolution note. Send only the fields to change. Hostaway: PUT /v1/tasks/{taskId}.
Annotations the server declares
- title: Update a task
- destructiveHint: true
Changes things 1Claude Code: ask
hostaway_calculate_priceCalculate what a stay at a listing would cost — total price plus the component breakdown (base rate, cleaning fee, taxes, discounts).No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Calculate what a stay at a listing would cost — total price plus the component breakdown (base rate, cleaning fee, taxes, discounts). A calculation only: nothing is booked or held. Hostaway: POST /v1/listings/{listingId}/calendar/priceDetails (version 2).
Annotations the server declares
- title: Quote a stay
- readOnlyHint: true
Only reads 13Claude Code: allow
hostaway_get_calendarDay-by-day availability and pricing for one listing over a date range: status (available, blocked, reserved, pending), nightly price, min/max stay, closed-to-arrival/departure and …No findings
Why it is in this group
- The name "hostaway_get_calendar" says "get": a word for reading.
Description, as the server wrote it Day-by-day availability and pricing for one listing over a date range: status (available, blocked, reserved, pending), nightly price, min/max stay, closed-to-arrival/departure and notes. Set includeResources to see the reservations occupying each day. Hostaway: GET /v1/listings/{listingId}/calendar.
Annotations the server declares
- title: Get listing calendar
- readOnlyHint: true
hostaway_get_listingFetch a single listing by id — full details including description, house rules, amenities, images, fees, taxes, cancellation policy and access info (door code, wifi).No findings
Why it is in this group
- The name "hostaway_get_listing" says "get": a word for reading.
Description, as the server wrote it Fetch a single listing by id — full details including description, house rules, amenities, images, fees, taxes, cancellation policy and access info (door code, wifi). Hostaway: GET /v1/listings/{listingId}.
Annotations the server declares
- title: Get one listing
- readOnlyHint: true
hostaway_get_owner_statementFetch one owner statement — the filter it was generated with (listings, date range), summary and per-reservation financial data, grand totals, expenses, and owner / property-manage…No findings
Why it is in this group
- The name "hostaway_get_owner_statement" says "get": a word for reading.
Description, as the server wrote it Fetch one owner statement — the filter it was generated with (listings, date range), summary and per-reservation financial data, grand totals, expenses, and owner / property-manager details. Hostaway: GET /v1/ownerStatement/{ownerStatementId}.
Annotations the server declares
- title: Get one owner statement
- readOnlyHint: true
hostaway_get_reservationFetch a single reservation by its Hostaway id — guest contact details, dates, guest counts, price breakdown, payment state, door code, notes, channel and cancellation policy.No findings
Why it is in this group
- The name "hostaway_get_reservation" says "get": a word for reading.
Description, as the server wrote it Fetch a single reservation by its Hostaway id — guest contact details, dates, guest counts, price breakdown, payment state, door code, notes, channel and cancellation policy. Hostaway: GET /v1/reservations/{reservationId}.
Annotations the server declares
- title: Get one reservation
- readOnlyHint: true
hostaway_get_reservation_logsThe audit trail for one reservation: every field change with previous and new value, when, and by which user (most recent first).No findings
Why it is in this group
- The name "hostaway_get_reservation_logs" says "get": a word for reading.
Description, as the server wrote it The audit trail for one reservation: every field change with previous and new value, when, and by which user (most recent first). Useful for 'who changed these dates / this price?'. Hostaway: GET /v1/reservations/{reservationId}/logs.
Annotations the server declares
- title: Get reservation change history
- readOnlyHint: true
hostaway_list_conversation_messagesThe messages in one guest conversation — body, direction (isIncoming), channel/email/SMS type, send status and timestamps.No findings
Why it is in this group
- The name "hostaway_list_conversation_messages" says "list": a word for reading.
Description, as the server wrote it The messages in one guest conversation — body, direction (isIncoming), channel/email/SMS type, send status and timestamps. By default only sent messages; set includeScheduledMessages to also see scheduled, paused or failed ones. Hostaway: GET /v1/conversations/{conversationId}/messages.
Annotations the server declares
- title: Read a conversation
- readOnlyHint: true
hostaway_list_conversationsList guest conversations (the unified inbox across channels), each with its latest message and linked reservation.No findings
Why it is in this group
- The name "hostaway_list_conversations" says "list": a word for reading.
Description, as the server wrote it List guest conversations (the unified inbox across channels), each with its latest message and linked reservation. Filter to one reservation. Hostaway: GET /v1/conversations.
Annotations the server declares
- title: List guest conversations
- readOnlyHint: true
hostaway_list_expensesList expenses (negative amounts) and extras (positive amounts) recorded against listings and reservations, with date, concept, categories and the owner statements they appear on.No findings
Why it is in this group
- The name "hostaway_list_expenses" says "list": a word for reading.
Description, as the server wrote it List expenses (negative amounts) and extras (positive amounts) recorded against listings and reservations, with date, concept, categories and the owner statements they appear on. Hostaway: GET /v1/expenses.
Annotations the server declares
- title: List expenses and extras
- readOnlyHint: true
hostaway_list_listingsList the account's properties (listings) with name, address, capacity, base price, fees and check-in times.No findings
Why it is in this group
- The name "hostaway_list_listings" says "list": a word for reading.
Description, as the server wrote it List the account's properties (listings) with name, address, capacity, base price, fees and check-in times. Filter by name, city, country, property type, availability for a date range and guest count, or active/archived status. Hostaway: GET /v1/listings.
Annotations the server declares
- title: List listings
- readOnlyHint: true
hostaway_list_owner_statementsList the account's owner statements (id and name).No findings
Why it is in this group
- The name "hostaway_list_owner_statements" says "list": a word for reading.
Description, as the server wrote it List the account's owner statements (id and name). Hostaway: GET /v1/ownerStatements.
Annotations the server declares
- title: List owner statements
- readOnlyHint: true
hostaway_list_reservationsList reservations across all channels (Airbnb, Vrbo, Booking.com, direct…) with guest, dates, status, price and channel.No findings
Why it is in this group
- The name "hostaway_list_reservations" says "list": a word for reading.
Description, as the server wrote it List reservations across all channels (Airbnb, Vrbo, Booking.com, direct…) with guest, dates, status, price and channel. Filter by listing, channel, arrival/departure window, guest name or email, unread messages, and more. Default order is newest first; for large accounts page with afterId (the id of the last reservation on the previous page). Channel ids: 2000 direct, 2018 airbnbOfficial, 2002 homeaway/Vrbo, 2005 bookingcom, 2007 expedia, 2013 bookingengine, 2019 marriott, 2020 partner, 2022 google. Hostaway: GET /v1/reservations.
Annotations the server declares
- title: List reservations
- readOnlyHint: true
hostaway_list_reviewsList guest-to-host and host-to-guest reviews with rating (0-10), public review, private feedback and the host's reply.No findings
Why it is in this group
- The name "hostaway_list_reviews" says "list": a word for reading.
Description, as the server wrote it List guest-to-host and host-to-guest reviews with rating (0-10), public review, private feedback and the host's reply. Filter by listings, reservation, type, status, rating range, dates, guest name, or whether the host has replied. Hostaway: GET /v1/reviews.
Annotations the server declares
- title: List reviews
- readOnlyHint: true
hostaway_list_tasksList operational tasks (cleaning, maintenance, check-in/out) with assignee, status, time window and cost.No findings
Why it is in this group
- The name "hostaway_list_tasks" says "list": a word for reading.
Description, as the server wrote it List operational tasks (cleaning, maintenance, check-in/out) with assignee, status, time window and cost. Filter by reservation, status, text match, channel, or start/deadline windows. Hostaway: GET /v1/tasks.
Annotations the server declares
- title: List tasks
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.16.3. Values in angle brackets are yours to fill in.
claude mcp add --transport http hostaway https://hostaway.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__hostaway__hostaway_list_listings",
"mcp__hostaway__hostaway_get_listing",
"mcp__hostaway__hostaway_list_reservations",
"mcp__hostaway__hostaway_get_reservation",
"mcp__hostaway__hostaway_get_reservation_logs",
"mcp__hostaway__hostaway_get_calendar",
"mcp__hostaway__hostaway_list_conversations",
"mcp__hostaway__hostaway_list_conversation_messages",
"mcp__hostaway__hostaway_list_reviews",
"mcp__hostaway__hostaway_list_tasks",
"mcp__hostaway__hostaway_list_expenses",
"mcp__hostaway__hostaway_list_owner_statements",
"mcp__hostaway__hostaway_get_owner_statement"
],
"ask": [
"mcp__hostaway__hostaway_calculate_price"
],
"deny": [
"mcp__hostaway__hostaway_create_reservation",
"mcp__hostaway__hostaway_update_reservation",
"mcp__hostaway__hostaway_update_calendar",
"mcp__hostaway__hostaway_send_message",
"mcp__hostaway__hostaway_create_task",
"mcp__hostaway__hostaway_update_task"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as hostaway. Review it before you use it.