create_expense
Create a new expense record for a listing in Guesty.
LABSCO SUMMARY
Writes and guest messages are open — decide what an agent may change before you connect.
Version 0.11.3 opened everything: reservation, listing, calendar and pricing writes, guest messaging and the property-health tools all run with no license key. That makes this a management surface, not only a reporting one — an agent can change prices and message guests, so settle which of those you want it doing first. Two notes from the author are worth carrying: Guesty's reservations endpoint returns only future data, so historical questions go through the calendar instead, and the server runs in production on the author's own rental portfolio.
What it is
A client for a Guesty property-management account, with write and guest-messaging tools alongside the reads as of version 0.11.3.
What you get
- Reservations found the way you actually look for them — filtered by dates, listing, status or guest, or searched by guest name, email or confirmation code — with the financial breakdown for any one of them (get_reservations, search_reservations, get_reservation_financials).
- Guests looked up by name or email, and the full profile behind a booking (get_guests, get_guest_by_id).
- Listings and their calendars: property details or the whole portfolio, availability and pricing by date, blocked dates with their reasons, and occupancy calculated over a range (get_listing, get_calendar, get_calendar_blocks, get_listing_occupancy).
- The money view: revenue, payouts and commission; the base price, discounts and fee detail on a listing; owner statements; recorded expenses; and revenue aggregated across every listing (get_financials, get_listing_pricing, get_owner_statements, get_expenses, get_revenue_summary).
- Operations: cleaning and maintenance tasks, guest reviews pulled from every channel, the booking channels connected per property, and the languages a listing supports (get_tasks, get_reviews, get_channels, get_supported_languages).
- Configuration reads: the automation and workflow rules in place, registered webhooks, custom fields, listing photos with their captions, and the account itself (get_automation_rules, get_webhooks, get_custom_fields, get_photos, get_account_info).
- Changes as well as reads: create and update reservations and add notes to them; update listings, calendars, photos and pricing; record expenses, create tasks, respond to reviews, and register or remove webhooks.
- Guest messaging — read a conversation's history and send the guest a message (get_conversations, send_guest_message).
- Property health: a turnover-readiness score, a per-property health snapshot, checkout-photo uploads and open maintenance alerts, fed by an optional IoT webhook receiver — with nothing reporting they return empty device data, not errors.
- The server's own licensing state, reported without making any Guesty API call (get_license_info).
Requirements
A Guesty account with API access, on the Professional plan or higher, and an API application with the open-api scope, created under Settings, API in the Guesty dashboard — the client ID and secret go in GUESTY_CLIENT_ID and GUESTY_CLIENT_SECRET. Run it with npx guesty-mcp-server over stdio. No license key is needed: GUESTY_MCP_LICENSE_KEY is optional and changes nothing.
Setup effort
One command plus credentials — npx guesty-mcp-server, then supply credentials
USE CASES
01
Answering what is booked next week
Filter reservations by date and listing rather than opening the Guesty calendar.
02
Finding a booking someone emailed you about
Search by guest name, email or confirmation code, then read the guest's profile.
03
Working out what a property earned
Revenue and payouts on one side, recorded expenses on the other, with the owner statement on top.
04
Checking how full the portfolio has been
Occupancy over a date range per listing, alongside revenue aggregated across all of them.
05
Seeing whether the cleaning is covered
Read the tasks against the arrivals rather than checking two systems.
06
Keeping an eye on reviews across channels
Reviews from every connected channel in one place, with the channel list beside them.
43 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_reservation
Create a new reservation/booking in Guesty. Use for direct bookings from your website.
create_reservation_note
Add an internal note to a reservation visible only to the property management team.
create_task
Create a cleaning or maintenance task for a listing.
create_webhook
Register a new webhook to receive event notifications from Guesty.
delete_webhook
Delete a registered webhook by ID.
get_account_info
Get current Guesty account information and subscription details.
get_automation_rules
List automation and workflow rules configured in Guesty.
get_calendar
Fetch calendar availability and pricing for a listing over a date range.
get_calendar_blocks
Get blocked dates and their reasons for a listing over a date range.
get_channels
List connected booking channels (Airbnb, VRBO, Booking.com, etc.) and their status.
get_conversations
Fetch guest conversations/messages from Guesty. Get message history for a reservation or listing.
get_custom_fields
Fetch custom fields configured for listings or reservations.
get_expenses
Fetch operational expenses tracked in Guesty.
get_financials
Fetch financial data including revenue, payouts, and reservation financials.
get_guest_by_id
Get detailed guest profile by guest ID.
get_guests
Fetch guest database/profiles. Search by name or email.
get_license_info
Show current license tier, available tools, and upgrade information.
get_listing
Fetch details about a specific property listing or all listings.
get_listing_occupancy
Calculate occupancy rate for a listing over a date range.
get_listing_pricing
Get pricing details for a listing including base price, weekly/monthly discounts, and extra fees.
get_maintenance_alerts
List or filter open maintenance alerts for a specific property or across the whole portfolio. Supports severity filtering and active-only (unresolved) filtering. IoT-sourced today; future Phase will merge Guesty-native task alerts.
get_owner_statements
Fetch owner revenue statements/reports for properties.
get_photos
Fetch photos for a specific listing including URLs, captions, and sort order.
get_property_health
Aggregate health signal per property: IoT device status + overall IoT state, current reservation status, 50-review average score, and last-clean timestamp. Single-call snapshot for ops dashboards. Sub-fetches that fail degrade gracefully (null value + error note).
get_readiness_score
Calculate a 0-100 Physical Readiness Score for a property before guest check-in. Evaluates temperature, leak detection, door lock, humidity, critical alerts, and baseline photos.
get_reservation_financials
Get detailed financial breakdown for a specific reservation including payments, charges, and adjustments.
get_reservations
Fetch reservations from Guesty. Filter by date range, listing, status, or guest name.
get_revenue_summary
Get aggregated revenue summary across all or specific listings for a date range.
get_reviews
Fetch guest reviews for your properties from all channels.
get_supported_languages
Get supported languages configured for a listing.
get_tasks
Fetch cleaning and maintenance tasks from Guesty.
get_webhooks
List all registered webhooks for your Guesty account.
respond_to_review
Post a response to a guest review.
search_reservations
Search reservations by guest name, email, or confirmation code.
send_guest_message
Send a message to a guest in a Guesty conversation.
submit_checkout_photos
Accept post-checkout photo uploads and log them to the property's maintenance/cleaning record. Photos are queued for downstream inspection workflows (Phase 2 vision comparison).
update_calendar
Block or unblock dates, set minimum nights, or update availability for a listing.
update_listing
Update listing details such as title, description, amenities, min nights, and max guests.
update_listing_pricing
Update pricing for a listing — base price, cleaning fee, extra person fee, and discounts.
update_photos
Replace or reorder photos for a listing. Provide the full array of photos in desired order.
update_pricing
Update the base price for a listing on specific dates or the default base price.
update_reservation
Update reservation details such as status, dates, guest info, or add notes.
BEFORE YOU INSTALL
What to know first
Tools you get
43 tools when we connected. All free. Version 0.11.3 has one more than we saw when we connected, 44 in all: 25 that read your Guesty account, 14 that change it or message guests, 4 property-health tools, plus get_license_info, which reports the server's own licensing state and makes no Guesty API call.
Requires
- npx on PATH
- Node.js 18+
- GUESTY_CLIENT_ID in your environment
- GUESTY_CLIENT_SECRET in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 43 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx guesty-mcp-serverMCP Clients
Claude Code
CLAUDE CODE · JSON
{
"mcpServers": {
"guesty": {
"command": "npx",
"args": [
"-y",
"guesty-mcp-server"
],
"env": {
"GUESTY_CLIENT_ID": "<YOUR_GUESTY_CLIENT_ID>",
"GUESTY_CLIENT_SECRET": "<YOUR_GUESTY_CLIENT_SECRET>"
}
}
}
}Add this to your project's .mcp.json. In the Guesty dashboard, create an API application with the open-api scope under Settings → API; <YOUR_GUESTY_CLIENT_ID> and <YOUR_GUESTY_CLIENT_SECRET> are its Client ID and Client Secret.
