Hostaway MCP by usefulapi is an MCP server published by io.usefulapi, hosted at hostaway.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 23 tools, including hostaway_list_users, hostaway_list_listings, hostaway_get_listing, hostaway_list_reservations, hostaway_get_reservation.
Manage Hostaway listings, reservations, calendar, guest messages, reviews and tasks.
4,231 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the connected Hostaway account's users/team members with their ids, names, user-group names (roles) and job titles (positions), when supplied by Hostaway. Set includeEmails=true only when email addresses are needed; emails are omitted by default. Use an API key authorized to view the account's staff directory: Hostaway enforces the key's resource access, and an access denial is returned as an error. Read-only: does not change users, roles or permissions. Verification codes and unrelated user fields are never returned. Hostaway: GET /v1/users (no documented pagination filters).
| Parameter | Type | Description |
|---|---|---|
| includeEmails | boolean | Include staff email addresses when needed. Omitted/false returns names, roles and positions only; Hostaway API permissions still apply. |
{
"name": "hostaway_list_users",
"title": "List account team members",
"description": "List the connected Hostaway account's users/team members with their ids, names, user-group names (roles) and job titles (positions), when supplied by Hostaway. Set includeEmails=true only when email addresses are needed; emails are omitted by default. Use an API key authorized to view the account's staff directory: Hostaway enforces the key's resource access, and an access denial is returned as an error. Read-only: does not change users, roles or permissions. Verification codes and unrelated user fields are never returned. Hostaway: GET /v1/users (no documented pagination filters).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"includeEmails": {
"type": "boolean",
"description": "Include staff email addresses when needed. Omitted/false returns names, roles and positions only; Hostaway API permissions still apply."
}
}
},
"annotations": {
"title": "List account team members",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| city | string | City. |
| limit | integer | Maximum records to return (1-500). |
| match | string | Search by listing name. |
| offset | integer | Records to skip from the start. |
| country | string | Country. |
| sortOrder | string | Sort order. |
| specialStatus | array | Filter by status; omit for both active and archived. |
| propertyTypeId | integer | Property type id. |
| includeResources | boolean | Include attached sub-resources (sent as includeResources=1). |
| availabilityDateEnd | string | Only listings available until (YYYY-MM-DD). |
| availabilityDateStart |
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}.
| Parameter | Type | Description |
|---|---|---|
| listingId * | integer | Listing id. |
| includeResources | boolean | Include attached sub-resources (sent as includeResources=1). |
{
"name": "hostaway_get_listing",
"title": "Get one listing",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"listingId"
],
"properties": {
"listingId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Listing id.",
"exclusiveMinimum": 0
},
"includeResources": {
"type": "boolean",
"description": "Include attached sub-resources (sent as includeResources=1)."
}
}
},
"annotations": {
"title": "Get one listing",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum records to return (1-500). |
| match | string | Search by guest name. |
| offset | integer | Records to skip from the start. |
| afterId | integer | Cursor: the id of the last reservation from the previous page (offset is then ignored). |
| endDate | string | Upper bound for dateType (YYYY-MM-DD). |
| dateType | string | Which date startDate/endDate bound (only on accounts with the new reservations query; 'cancellation' also restricts to cancelled). |
| channelId | integer | Only this channel id. |
| isStarred | boolean | Only starred. |
| listingId | integer |
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}.
| Parameter | Type | Description |
|---|---|---|
| reservationId * | integer | Hostaway reservation id. |
{
"name": "hostaway_get_reservation",
"title": "Get one reservation",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"reservationId"
],
"properties": {
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Hostaway reservation id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get one reservation",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum records to return (1-500). |
| offset | integer | Records to skip from the start. |
| reservationId * | integer | Hostaway reservation id. |
{
"name": "hostaway_get_reservation_logs",
"title": "Get reservation change history",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"reservationId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum records to return (1-500)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Records to skip from the start."
},
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Hostaway reservation id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get reservation change history",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| endDate * | string | Last day (YYYY-MM-DD). |
| listingId * | integer | Listing id. |
| startDate * | string | First day (YYYY-MM-DD). |
| includeResources | boolean | Include attached sub-resources (sent as includeResources=1). |
{
"name": "hostaway_get_calendar",
"title": "Get listing calendar",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"listingId",
"startDate",
"endDate"
],
"properties": {
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day (YYYY-MM-DD)."
},
"listingId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Listing id.",
"exclusiveMinimum": 0
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day (YYYY-MM-DD)."
},
"includeResources": {
"type": "boolean",
"description": "Include attached sub-resources (sent as includeResources=1)."
}
}
},
"annotations": {
"title": "Get listing calendar",
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| markup | number | Price markup multiplier (must be more than 1.0). |
| listingId * | integer | Listing id. |
| endingDate * | string | Departure date (YYYY-MM-DD). |
| startingDate * | string | Arrival date (YYYY-MM-DD). |
| numberOfGuests * | integer | Number of guests. |
| reservationCouponId | integer | Reservation coupon id to apply. |
{
"name": "hostaway_calculate_price",
"title": "Quote a stay",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"listingId",
"startingDate",
"endingDate",
"numberOfGuests"
],
"properties": {
"markup": {
"type": "number",
"minimum": 1,
"description": "Price markup multiplier (must be more than 1.0)."
},
"listingId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Listing id.",
"exclusiveMinimum": 0
},
"endingDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Departure date (YYYY-MM-DD)."
},
"startingDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Arrival date (YYYY-MM-DD)."
},
"numberOfGuests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Number of guests."
},
"reservationCouponId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reservation coupon id to apply.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Quote a stay",
"readOnlyHint": true
}
}List guest conversations (the unified inbox across channels), each with its latest message and linked reservation. Filter to one reservation. Hostaway: GET /v1/conversations.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum records to return (1-500). |
| offset | integer | Records to skip from the start. |
| reservationId | integer | Only conversations for this reservation. |
| includeResources | boolean | Include attached sub-resources (sent as includeResources=1). |
{
"name": "hostaway_list_conversations",
"title": "List guest conversations",
"description": "List guest conversations (the unified inbox across channels), each with its latest message and linked reservation. Filter to one reservation. Hostaway: GET /v1/conversations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum records to return (1-500)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Records to skip from the start."
},
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only conversations for this reservation.",
"exclusiveMinimum": 0
},
"includeResources": {
"type": "boolean",
"description": "Include attached sub-resources (sent as includeResources=1)."
}
}
},
"annotations": {
"title": "List guest conversations",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum records to return (1-500). |
| offset | integer | Records to skip from the start. |
| conversationId * | integer | Conversation id. |
| includeScheduledMessages | boolean | Also return scheduled / failed / paused messages. |
{
"name": "hostaway_list_conversation_messages",
"title": "Read a conversation",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversationId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum records to return (1-500)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Records to skip from the start."
},
"conversationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Conversation id.",
"exclusiveMinimum": 0
},
"includeScheduledMessages": {
"type": "boolean",
"description": "Also return scheduled / failed / paused messages."
}
}
},
"annotations": {
"title": "Read a conversation",
"readOnlyHint": true
}
}List the saved guest-message templates: name, description, message text with {{placeholders}}, and the listing, channel and template group each one belongs to. Use it to audit template wording, for example to find the templates that hold check-in instructions or door codes. With reservationId, Hostaway fills the placeholders with that reservation's data (the result then holds guest data). Read-only. The Hostaway Public API has no endpoint for message automations: their triggers, conditions (such as payment status) and schedules cannot be read or changed here, only in the Hostaway dashboard. To see the messages already scheduled for a guest, use hostaway_list_conversation_messages with includeScheduledMessages. Channel ids: 2000 direct, 2018 airbnbOfficial, 2002 homeaway/Vrbo, 2005 bookingcom, 2007 expedia, 2013 bookingengine, 2019 marriott, 2020 partner, 2022 google. Hostaway: GET /v1/messageTemplates.
| Parameter | Type | Description |
|---|---|---|
| channelId | integer | Only templates for this channel id. |
| listingMapId | integer | Only templates for this listing (the listing id). |
| reservationId | integer | Fill the placeholders with this reservation's data. |
| messageTemplateGroupId | integer | Only templates in this template group. |
{
"name": "hostaway_list_message_templates",
"title": "List message templates",
"description": "List the saved guest-message templates: name, description, message text with {{placeholders}}, and the listing, channel and template group each one belongs to. Use it to audit template wording, for example to find the templates that hold check-in instructions or door codes. With reservationId, Hostaway fills the placeholders with that reservation's data (the result then holds guest data). Read-only. The Hostaway Public API has no endpoint for message automations: their triggers, conditions (such as payment status) and schedules cannot be read or changed here, only in the Hostaway dashboard. To see the messages already scheduled for a guest, use hostaway_list_conversation_messages with includeScheduledMessages. Channel ids: 2000 direct, 2018 airbnbOfficial, 2002 homeaway/Vrbo, 2005 bookingcom, 2007 expedia, 2013 bookingengine, 2019 marriott, 2020 partner, 2022 google. Hostaway: GET /v1/messageTemplates.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"channelId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only templates for this channel id."
},
"listingMapId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only templates for this listing (the listing id).",
"exclusiveMinimum": 0
},
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fill the placeholders with this reservation's data.",
"exclusiveMinimum": 0
},
"messageTemplateGroupId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only templates in this template group.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List message templates",
"readOnlyHint": true
}
}One saved guest-message template by id. Without reservationId the message text keeps its {{placeholders}}; with reservationId Hostaway returns the text as that guest would get it (the result then holds guest data). Read-only; message automations are not in the Hostaway Public API. Hostaway: GET /v1/messageTemplates/{messageTemplateId} or GET /v1/reservations/{reservationId}/messageTemplates/{messageTemplateId}.
| Parameter | Type | Description |
|---|---|---|
| reservationId | integer | Fill the placeholders with this reservation's data. |
| messageTemplateId * | integer | Message template id (from hostaway_list_message_templates). |
{
"name": "hostaway_get_message_template",
"title": "Get one message template",
"description": "One saved guest-message template by id. Without reservationId the message text keeps its {{placeholders}}; with reservationId Hostaway returns the text as that guest would get it (the result then holds guest data). Read-only; message automations are not in the Hostaway Public API. Hostaway: GET /v1/messageTemplates/{messageTemplateId} or GET /v1/reservations/{reservationId}/messageTemplates/{messageTemplateId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"messageTemplateId"
],
"properties": {
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Fill the placeholders with this reservation's data.",
"exclusiveMinimum": 0
},
"messageTemplateId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Message template id (from hostaway_list_message_templates).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get one message template",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| type | string | Review direction. |
| limit | integer | Maximum records to return (1-500). |
| offset | integer | Records to skip from the start. |
| sortBy | string | Sort field. |
| statuses | array | Review statuses. |
| guestName | string | Partial, case-insensitive guest-name match. |
| ratingMax | number | Maximum rating (0-10). |
| ratingMin | number | Minimum rating (0-10). |
| sortOrder | string | Sort direction (default desc). |
| hasHostReply | boolean | true = only replied-to reviews; false = only unanswered. |
| listingMapIds | array |
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum records to return (1-500). |
| match | string | Text search. |
| offset | integer | Records to skip from the start. |
| status | string | Task status. |
| channelId | integer | Channel id. |
| reservationId | integer | Only tasks for this reservation. |
| shouldEndByEnd | string | Deadline until (YYYY-MM-DD). |
| canStartFromEnd | string | Start window until (YYYY-MM-DD). |
| shouldEndByStart | string | Deadline from (YYYY-MM-DD). |
| canStartFromStart | string | Start window from (YYYY-MM-DD). |
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum records to return (1-500). |
| offset | integer | Records to skip from the start. |
{
"name": "hostaway_list_expenses",
"title": "List expenses and extras",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum records to return (1-500)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Records to skip from the start."
}
}
},
"annotations": {
"title": "List expenses and extras",
"readOnlyHint": true
}
}List the account's owner statements (id and name). Hostaway: GET /v1/ownerStatements.
No parameters.
{
"name": "hostaway_list_owner_statements",
"title": "List owner statements",
"description": "List the account's owner statements (id and name). Hostaway: GET /v1/ownerStatements.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List owner statements",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| ownerStatementId * | integer | Owner statement id. |
{
"name": "hostaway_get_owner_statement",
"title": "Get one owner statement",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ownerStatementId"
],
"properties": {
"ownerStatementId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Owner statement id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get one owner statement",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| pets | integer | Pets. |
| phone | string | Guest phone, e.g. +15125551212. |
| adults | integer | Adults. |
| comment | string | Free-text comment. |
| infants | integer | Infants. |
| children | integer | Children. |
| currency | string | Currency code, e.g. USD. |
| doorCode | string | Door / lock code for this stay. |
| hostNote | string | Internal host note (not shown to the guest). |
| channelId | any | 2000 direct (default), 2002 homeaway, 2020 partner. |
| guestCity |
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}.
| Parameter | Type | Description |
|---|---|---|
| pets | integer | Pets. |
| phone | string | Guest phone, e.g. +15125551212. |
| adults | integer | Adults. |
| comment | string | Free-text comment. |
| infants | integer | Infants. |
| children | integer | Children. |
| doorCode | string | Door / lock code for this stay. |
| hostNote | string | Internal host note (not shown to the guest). |
| guestCity | string | Guest city. |
| guestName | string | Guest full name. |
| guestNote | string |
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.
| Parameter | Type | Description |
|---|---|---|
| note | string | Calendar note. |
| price | number | Nightly price. |
| endDate * | string | Last day to change (YYYY-MM-DD). |
| listingId * | integer | Listing id. |
| startDate * | string | First day to change (YYYY-MM-DD). |
| isAvailable | boolean | false blocks the days, true opens them (single-unit listings). |
| maximumStay | integer | Maximum nights. |
| minimumStay | integer | Minimum nights. |
| closedOnArrival | boolean | Closed to arrival. |
| closedOnDeparture |
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.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Message text. |
| conversationId * | integer | Conversation id (see hostaway_list_conversations). |
| communicationType | string | Delivery method (Hostaway default: email). |
{
"name": "hostaway_send_message",
"title": "Send a guest message",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversationId",
"body"
],
"properties": {
"body": {
"type": "string",
"minLength": 1,
"description": "Message text."
},
"conversationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Conversation id (see hostaway_list_conversations).",
"exclusiveMinimum": 0
},
"communicationType": {
"enum": [
"email",
"channel",
"sms",
"whatsapp"
],
"type": "string",
"description": "Delivery method (Hostaway default: email)."
}
}
},
"annotations": {
"title": "Send a guest message",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| cost | number | Task cost. |
| color | string | Colour in hex, e.g. #FF8800. |
| title * | string | Task title. |
| status | string | pending, confirmed, inProgress, completed or cancelled. |
| priority | integer | Priority. |
| description | string | Task description. |
| shouldEndBy | string | Deadline ("YYYY-MM-DD HH:MM:SS", UTC). |
| canStartFrom | string | Earliest start time ("YYYY-MM-DD HH:MM:SS", UTC). |
| costCurrency | string | Cost currency, e.g. USD. |
| listingMapId | integer | Listing id the task belongs to. |
| categoriesMap | array |
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}.
| Parameter | Type | Description |
|---|---|---|
| cost | number | Task cost. |
| color | string | Colour in hex, e.g. #FF8800. |
| title | string | Task title. |
| status | string | pending, confirmed, inProgress, completed or cancelled. |
| taskId * | integer | Task id. |
| priority | integer | Priority. |
| description | string | Task description. |
| shouldEndBy | string | Deadline ("YYYY-MM-DD HH:MM:SS", UTC). |
| canStartFrom | string | Earliest start time ("YYYY-MM-DD HH:MM:SS", UTC). |
| costCurrency | string | Cost currency, e.g. USD. |
| listingMapId | integer | Listing id the task belongs to. |
Tools for Hostaway, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which guests check in over the next 7 days, and at which properties?"; "Show me the latest guest reviews and their ratings across my listings."; "What would a 5-night stay for 2 guests at my beach house cost starting June 12?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Hostaway data. Free plan: 50 tool calls per month. Run hostaway_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run hostaway_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run hostaway_upgrade without a plan: it returns both plans, each with a payment link for the user to open. hostaway_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| string |
| Only listings available from (YYYY-MM-DD). |
| availabilityGuestNumber | integer | Only listings that fit this many guests. |
{
"name": "hostaway_list_listings",
"title": "List listings",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"city": {
"type": "string",
"description": "City."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum records to return (1-500)."
},
"match": {
"type": "string",
"description": "Search by listing name."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Records to skip from the start."
},
"country": {
"type": "string",
"description": "Country."
},
"sortOrder": {
"enum": [
"name",
"nameReversed",
"order",
"orderReversed",
"contactName",
"contactNameReversed",
"latestActivity",
"latestActivityDesc"
],
"type": "string",
"description": "Sort order."
},
"specialStatus": {
"type": "array",
"items": {
"enum": [
"active",
"archived"
],
"type": "string"
},
"description": "Filter by status; omit for both active and archived."
},
"propertyTypeId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Property type id."
},
"includeResources": {
"type": "boolean",
"description": "Include attached sub-resources (sent as includeResources=1)."
},
"availabilityDateEnd": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only listings available until (YYYY-MM-DD)."
},
"availabilityDateStart": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only listings available from (YYYY-MM-DD)."
},
"availabilityGuestNumber": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Only listings that fit this many guests."
}
}
},
"annotations": {
"title": "List listings",
"readOnlyHint": true
}
}| Only reservations for this listing. |
| sortOrder | string | Sort order. |
| startDate | string | Lower bound for dateType (YYYY-MM-DD). |
| guestEmail | string | Filter by guest email. |
| isArchived | boolean | Archived or not. |
| arrivalEndDate | string | Arrival on or before (YYYY-MM-DD). |
| assigneeUserId | integer | Only reservations assigned to this user. |
| arrivalStartDate | string | Arrival on or after (YYYY-MM-DD). |
| departureEndDate | string | Departure on or before (YYYY-MM-DD). |
| includeResources | boolean | Include attached sub-resources (sent as includeResources=1). |
| latestActivityEnd | string | Latest activity on or before (YYYY-MM-DD). |
| departureStartDate | string | Departure on or after (YYYY-MM-DD). |
| latestActivityStart | string | Latest activity on or after (YYYY-MM-DD). |
| includeCancellationPolicy | boolean | Attach the cancellation-policy snapshot to each reservation. |
| hasUnreadConversationMessages | boolean | Only reservations with unread guest messages. |
{
"name": "hostaway_list_reservations",
"title": "List reservations",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum records to return (1-500)."
},
"match": {
"type": "string",
"description": "Search by guest name."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Records to skip from the start."
},
"afterId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Cursor: the id of the last reservation from the previous page (offset is then ignored).",
"exclusiveMinimum": 0
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Upper bound for dateType (YYYY-MM-DD)."
},
"dateType": {
"enum": [
"arrival",
"departure",
"creation",
"cancellation"
],
"type": "string",
"description": "Which date startDate/endDate bound (only on accounts with the new reservations query; 'cancellation' also restricts to cancelled)."
},
"channelId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only this channel id."
},
"isStarred": {
"type": "boolean",
"description": "Only starred."
},
"listingId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only reservations for this listing.",
"exclusiveMinimum": 0
},
"sortOrder": {
"enum": [
"arrivalDate",
"arrivalDateDesc",
"lastConversationMessageSent",
"lastConversationMessageSentDesc",
"lastConversationMessageReceived",
"lastConversationMessageReceivedDesc",
"latestActivity",
"latestActivityDesc",
"updatedOn"
],
"type": "string",
"description": "Sort order."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Lower bound for dateType (YYYY-MM-DD)."
},
"guestEmail": {
"type": "string",
"description": "Filter by guest email."
},
"isArchived": {
"type": "boolean",
"description": "Archived or not."
},
"arrivalEndDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Arrival on or before (YYYY-MM-DD)."
},
"assigneeUserId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only reservations assigned to this user.",
"exclusiveMinimum": 0
},
"arrivalStartDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Arrival on or after (YYYY-MM-DD)."
},
"departureEndDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Departure on or before (YYYY-MM-DD)."
},
"includeResources": {
"type": "boolean",
"description": "Include attached sub-resources (sent as includeResources=1)."
},
"latestActivityEnd": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Latest activity on or before (YYYY-MM-DD)."
},
"departureStartDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Departure on or after (YYYY-MM-DD)."
},
"latestActivityStart": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Latest activity on or after (YYYY-MM-DD)."
},
"includeCancellationPolicy": {
"type": "boolean",
"description": "Attach the cancellation-policy snapshot to each reservation."
},
"hasUnreadConversationMessages": {
"type": "boolean",
"description": "Only reservations with unread guest messages."
}
}
},
"annotations": {
"title": "List reservations",
"readOnlyHint": true
}
}| Only reviews for these listing ids. |
| reservationId | integer | Hostaway reservation id. |
| submittedAtEnd | string | Submitted on or before (YYYY-MM-DD). |
| departureDateEnd | string | Reservation departure on or before (YYYY-MM-DD). |
| submittedAtStart | string | Submitted on or after (YYYY-MM-DD). |
| departureDateStart | string | Reservation departure on or after (YYYY-MM-DD). |
{
"name": "hostaway_list_reviews",
"title": "List reviews",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"guest-to-host",
"host-to-guest"
],
"type": "string",
"description": "Review direction."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum records to return (1-500)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Records to skip from the start."
},
"sortBy": {
"enum": [
"id",
"rating",
"submittedAt",
"arrivalDate",
"departureDate",
"guestName",
"listingMapId",
"status"
],
"type": "string",
"description": "Sort field."
},
"statuses": {
"type": "array",
"items": {
"enum": [
"awaiting",
"pending",
"scheduled",
"submitted",
"published",
"expired"
],
"type": "string"
},
"description": "Review statuses."
},
"guestName": {
"type": "string",
"description": "Partial, case-insensitive guest-name match."
},
"ratingMax": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Maximum rating (0-10)."
},
"ratingMin": {
"type": "number",
"maximum": 10,
"minimum": 0,
"description": "Minimum rating (0-10)."
},
"sortOrder": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (default desc)."
},
"hasHostReply": {
"type": "boolean",
"description": "true = only replied-to reviews; false = only unanswered."
},
"listingMapIds": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"description": "Only reviews for these listing ids."
},
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Hostaway reservation id.",
"exclusiveMinimum": 0
},
"submittedAtEnd": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Submitted on or before (YYYY-MM-DD)."
},
"departureDateEnd": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Reservation departure on or before (YYYY-MM-DD)."
},
"submittedAtStart": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Submitted on or after (YYYY-MM-DD)."
},
"departureDateStart": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Reservation departure on or after (YYYY-MM-DD)."
}
}
},
"annotations": {
"title": "List reviews",
"readOnlyHint": true
}
}{
"name": "hostaway_list_tasks",
"title": "List tasks",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Maximum records to return (1-500)."
},
"match": {
"type": "string",
"description": "Text search."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Records to skip from the start."
},
"status": {
"enum": [
"pending",
"confirmed",
"inProgress",
"completed",
"cancelled"
],
"type": "string",
"description": "Task status."
},
"channelId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Channel id."
},
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only tasks for this reservation.",
"exclusiveMinimum": 0
},
"shouldEndByEnd": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Deadline until (YYYY-MM-DD)."
},
"canStartFromEnd": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start window until (YYYY-MM-DD)."
},
"shouldEndByStart": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Deadline from (YYYY-MM-DD)."
},
"canStartFromStart": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start window from (YYYY-MM-DD)."
}
}
},
"annotations": {
"title": "List tasks",
"readOnlyHint": true
}
}| string |
| Guest city. |
| guestName | string | Guest full name. |
| guestNote | string | Note from the guest. |
| guestEmail | string | Guest email. |
| totalPrice | number | Total price of the stay. |
| arrivalDate * | string | Arrival date (YYYY-MM-DD). |
| checkInTime | integer | Check-in time (hour of day, 0-23). |
| checkOutTime | integer | Check-out time (hour of day, 0-23). |
| guestAddress | string | Guest street address. |
| guestCountry | string | Guest country (ISO 3166 code, e.g. US). |
| guestZipCode | string | Guest ZIP / postal code. |
| listingMapId * | integer | Listing id to book. |
| departureDate * | string | Departure date (YYYY-MM-DD). |
| guestLastName | string | Guest last name. |
| doorCodeVendor | string | Lock vendor. |
| guestFirstName | string | Guest first name. |
| numberOfGuests | integer | Total number of guests. |
| doorCodeInstruction | string | Door-code instructions. |
{
"name": "hostaway_create_reservation",
"title": "Create a reservation",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"listingMapId",
"arrivalDate",
"departureDate"
],
"properties": {
"pets": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pets."
},
"phone": {
"type": "string",
"description": "Guest phone, e.g. +15125551212."
},
"adults": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Adults."
},
"comment": {
"type": "string",
"description": "Free-text comment."
},
"infants": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Infants."
},
"children": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Children."
},
"currency": {
"type": "string",
"description": "Currency code, e.g. USD."
},
"doorCode": {
"type": "string",
"description": "Door / lock code for this stay."
},
"hostNote": {
"type": "string",
"description": "Internal host note (not shown to the guest)."
},
"channelId": {
"anyOf": [
{
"type": "number",
"const": 2000
},
{
"type": "number",
"const": 2002
},
{
"type": "number",
"const": 2020
}
],
"description": "2000 direct (default), 2002 homeaway, 2020 partner."
},
"guestCity": {
"type": "string",
"description": "Guest city."
},
"guestName": {
"type": "string",
"description": "Guest full name."
},
"guestNote": {
"type": "string",
"description": "Note from the guest."
},
"guestEmail": {
"type": "string",
"description": "Guest email."
},
"totalPrice": {
"type": "number",
"minimum": 0,
"description": "Total price of the stay."
},
"arrivalDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Arrival date (YYYY-MM-DD)."
},
"checkInTime": {
"type": "integer",
"maximum": 23,
"minimum": 0,
"description": "Check-in time (hour of day, 0-23)."
},
"checkOutTime": {
"type": "integer",
"maximum": 23,
"minimum": 0,
"description": "Check-out time (hour of day, 0-23)."
},
"guestAddress": {
"type": "string",
"description": "Guest street address."
},
"guestCountry": {
"type": "string",
"description": "Guest country (ISO 3166 code, e.g. US)."
},
"guestZipCode": {
"type": "string",
"description": "Guest ZIP / postal code."
},
"listingMapId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Listing id to book.",
"exclusiveMinimum": 0
},
"departureDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Departure date (YYYY-MM-DD)."
},
"guestLastName": {
"type": "string",
"description": "Guest last name."
},
"doorCodeVendor": {
"type": "string",
"description": "Lock vendor."
},
"guestFirstName": {
"type": "string",
"description": "Guest first name."
},
"numberOfGuests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Total number of guests."
},
"doorCodeInstruction": {
"type": "string",
"description": "Door-code instructions."
}
}
},
"annotations": {
"title": "Create a reservation",
"destructiveHint": true
}
}| Note from the guest. |
| guestEmail | string | Guest email. |
| arrivalDate | string | New arrival date (YYYY-MM-DD). |
| checkInTime | integer | Check-in time (hour of day, 0-23). |
| checkOutTime | integer | Check-out time (hour of day, 0-23). |
| guestAddress | string | Guest street address. |
| guestCountry | string | Guest country (ISO 3166 code, e.g. US). |
| guestZipCode | string | Guest ZIP / postal code. |
| departureDate | string | New departure date (YYYY-MM-DD). |
| guestLastName | string | Guest last name. |
| reservationId * | integer | Hostaway reservation id. |
| doorCodeVendor | string | Lock vendor. |
| guestFirstName | string | Guest first name. |
| numberOfGuests | integer | Total number of guests. |
| doorCodeInstruction | string | Door-code instructions. |
{
"name": "hostaway_update_reservation",
"title": "Update a reservation",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"reservationId"
],
"properties": {
"pets": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pets."
},
"phone": {
"type": "string",
"description": "Guest phone, e.g. +15125551212."
},
"adults": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Adults."
},
"comment": {
"type": "string",
"description": "Free-text comment."
},
"infants": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Infants."
},
"children": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Children."
},
"doorCode": {
"type": "string",
"description": "Door / lock code for this stay."
},
"hostNote": {
"type": "string",
"description": "Internal host note (not shown to the guest)."
},
"guestCity": {
"type": "string",
"description": "Guest city."
},
"guestName": {
"type": "string",
"description": "Guest full name."
},
"guestNote": {
"type": "string",
"description": "Note from the guest."
},
"guestEmail": {
"type": "string",
"description": "Guest email."
},
"arrivalDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "New arrival date (YYYY-MM-DD)."
},
"checkInTime": {
"type": "integer",
"maximum": 23,
"minimum": 0,
"description": "Check-in time (hour of day, 0-23)."
},
"checkOutTime": {
"type": "integer",
"maximum": 23,
"minimum": 0,
"description": "Check-out time (hour of day, 0-23)."
},
"guestAddress": {
"type": "string",
"description": "Guest street address."
},
"guestCountry": {
"type": "string",
"description": "Guest country (ISO 3166 code, e.g. US)."
},
"guestZipCode": {
"type": "string",
"description": "Guest ZIP / postal code."
},
"departureDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "New departure date (YYYY-MM-DD)."
},
"guestLastName": {
"type": "string",
"description": "Guest last name."
},
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Hostaway reservation id.",
"exclusiveMinimum": 0
},
"doorCodeVendor": {
"type": "string",
"description": "Lock vendor."
},
"guestFirstName": {
"type": "string",
"description": "Guest first name."
},
"numberOfGuests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Total number of guests."
},
"doorCodeInstruction": {
"type": "string",
"description": "Door-code instructions."
}
}
},
"annotations": {
"title": "Update a reservation",
"destructiveHint": true
}
}| boolean |
| Closed to departure. |
| desiredUnitsToSell | integer | Multi-unit listings: units to sell (0 blocks). |
{
"name": "hostaway_update_calendar",
"title": "Update listing calendar",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"listingId",
"startDate",
"endDate"
],
"properties": {
"note": {
"type": "string",
"description": "Calendar note."
},
"price": {
"type": "number",
"minimum": 0,
"description": "Nightly price."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day to change (YYYY-MM-DD)."
},
"listingId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Listing id.",
"exclusiveMinimum": 0
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day to change (YYYY-MM-DD)."
},
"isAvailable": {
"type": "boolean",
"description": "false blocks the days, true opens them (single-unit listings)."
},
"maximumStay": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum nights.",
"exclusiveMinimum": 0
},
"minimumStay": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Minimum nights.",
"exclusiveMinimum": 0
},
"closedOnArrival": {
"type": "boolean",
"description": "Closed to arrival."
},
"closedOnDeparture": {
"type": "boolean",
"description": "Closed to departure."
},
"desiredUnitsToSell": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Multi-unit listings: units to sell (0 blocks)."
}
}
},
"annotations": {
"title": "Update listing calendar",
"destructiveHint": true
}
}| Categories: 1 cleaning, 2 maintenance, 3 check-in, 4 check-out, 5 back office, 6 other. |
| reservationId | integer | Reservation id the task relates to. |
| assigneeUserId | integer | User id to assign the task to. |
| costDescription | string | Cost description. |
| supervisorUserId | integer | Supervisor user id. |
{
"name": "hostaway_create_task",
"title": "Create a task",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title"
],
"properties": {
"cost": {
"type": "number",
"description": "Task cost."
},
"color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Colour in hex, e.g. #FF8800."
},
"title": {
"type": "string",
"minLength": 1,
"description": "Task title."
},
"status": {
"enum": [
"pending",
"confirmed",
"inProgress",
"completed",
"cancelled"
],
"type": "string",
"description": "pending, confirmed, inProgress, completed or cancelled."
},
"priority": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Priority."
},
"description": {
"type": "string",
"description": "Task description."
},
"shouldEndBy": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "Deadline (\"YYYY-MM-DD HH:MM:SS\", UTC)."
},
"canStartFrom": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "Earliest start time (\"YYYY-MM-DD HH:MM:SS\", UTC)."
},
"costCurrency": {
"type": "string",
"description": "Cost currency, e.g. USD."
},
"listingMapId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Listing id the task belongs to.",
"exclusiveMinimum": 0
},
"categoriesMap": {
"type": "array",
"items": {
"type": "integer",
"maximum": 6,
"minimum": 1
},
"description": "Categories: 1 cleaning, 2 maintenance, 3 check-in, 4 check-out, 5 back office, 6 other."
},
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reservation id the task relates to.",
"exclusiveMinimum": 0
},
"assigneeUserId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "User id to assign the task to.",
"exclusiveMinimum": 0
},
"costDescription": {
"type": "string",
"description": "Cost description."
},
"supervisorUserId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Supervisor user id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create a task",
"destructiveHint": true
}
}| categoriesMap | array | Categories: 1 cleaning, 2 maintenance, 3 check-in, 4 check-out, 5 back office, 6 other. |
| reservationId | integer | Reservation id the task relates to. |
| assigneeUserId | integer | User id to assign the task to. |
| resolutionNote | string | Resolution note. |
| costDescription | string | Cost description. |
| supervisorUserId | integer | Supervisor user id. |
{
"name": "hostaway_update_task",
"title": "Update a task",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"taskId"
],
"properties": {
"cost": {
"type": "number",
"description": "Task cost."
},
"color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Colour in hex, e.g. #FF8800."
},
"title": {
"type": "string",
"minLength": 1,
"description": "Task title."
},
"status": {
"enum": [
"pending",
"confirmed",
"inProgress",
"completed",
"cancelled"
],
"type": "string",
"description": "pending, confirmed, inProgress, completed or cancelled."
},
"taskId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Task id.",
"exclusiveMinimum": 0
},
"priority": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Priority."
},
"description": {
"type": "string",
"description": "Task description."
},
"shouldEndBy": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "Deadline (\"YYYY-MM-DD HH:MM:SS\", UTC)."
},
"canStartFrom": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "Earliest start time (\"YYYY-MM-DD HH:MM:SS\", UTC)."
},
"costCurrency": {
"type": "string",
"description": "Cost currency, e.g. USD."
},
"listingMapId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Listing id the task belongs to.",
"exclusiveMinimum": 0
},
"categoriesMap": {
"type": "array",
"items": {
"type": "integer",
"maximum": 6,
"minimum": 1
},
"description": "Categories: 1 cleaning, 2 maintenance, 3 check-in, 4 check-out, 5 back office, 6 other."
},
"reservationId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reservation id the task relates to.",
"exclusiveMinimum": 0
},
"assigneeUserId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "User id to assign the task to.",
"exclusiveMinimum": 0
},
"resolutionNote": {
"type": "string",
"description": "Resolution note."
},
"costDescription": {
"type": "string",
"description": "Cost description."
},
"supervisorUserId": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Supervisor user id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update a task",
"destructiveHint": true
}
}