guesty-mcp-server - npm
npm
Search<br>Sign UpSign In
guesty-mcp-server<br>0.9.3 • Public • Published 21 hours ago<br>Readme<br>Code Beta<br>3 Dependencies<br>0 Dependents<br>14 Versions<br>Guesty MCP Server
The first MCP (Model Context Protocol) server for Guesty property management. Connect AI agents directly to your Guesty account to manage reservations, communicate with guests, track finances, and update pricing -- all autonomously.
43 tools covering reservations, listings, guests, messaging, financials, tasks, calendars, webhooks, and pricing — plus 1 IoT tool (get_readiness_score) and 3 Enterprise-tier aggregators (get_property_health, submit_checkout_photos, get_maintenance_alerts) for property health aggregation, checkout photo intake, and portfolio maintenance alerts.
Want AI to handle your guest messages 24/7? Guesty Copilot -- AI guest management for Guesty hosts, built on this MCP server. Now in beta.
Stay updated: Sign up for release notes and new tool announcements
v0.9.2 (2026-05-21) — Paid tiers launching v1.0 next week. Free tier (23 read-only tools) is fully functional now: reservations, listings, guests, calendars, financial reports, operations, reviews, and webhook reads. Write operations (create/update/delete) and the full 43-tool surface ship in v1.0 with Stripe-backed paid-tier activation. Until then, paid-tier license keys return a NOT YET WIRED — PAID TIERS LAUNCH v1.0 refusal — set or omit GUESTY_MCP_LICENSE_KEY to use the free tier.
Quick Start
npx guesty-mcp-server
Or add to your Claude Code settings (~/.claude/settings.json):
"mcpServers": {<br>"guesty": {<br>"command": "npx",<br>"args": ["-y", "guesty-mcp-server"],<br>"env": {<br>"GUESTY_CLIENT_ID": "your-client-id",<br>"GUESTY_CLIENT_SECRET": "your-client-secret"
Get Guesty API Credentials
Log into Guesty Dashboard
Go to Settings > API (or Marketplace > API Credentials)
Create an API application with open-api scope
Copy your Client ID and Client Secret
All 43 Tools
Reservations & Guests
Tool<br>Description
get_reservations<br>Fetch reservations with filters (dates, listing, status, guest)
create_reservation<br>Create direct bookings (website to Guesty)
update_reservation<br>Update reservation status, dates, guest info, or add notes
search_reservations<br>Search by guest name, email, or confirmation code
get_reservation_financials<br>Detailed financial breakdown for a reservation
create_reservation_note<br>Add internal notes to a reservation
get_guests<br>Search guest database by name or email
get_guest_by_id<br>Get detailed guest profile
Listings & Calendar
Tool<br>Description
get_listing<br>Get property details or list all properties
update_listing<br>Update title, description, amenities, min nights, max guests
get_calendar<br>Check availability and pricing by date
update_calendar<br>Block/unblock dates, set minimum nights
get_calendar_blocks<br>Get blocked dates with reasons
get_listing_occupancy<br>Calculate occupancy rate over a date range
get_photos<br>Fetch listing photos with captions
update_photos<br>Replace or reorder listing photos
Messaging
Tool<br>Description
get_conversations<br>Fetch guest message history
send_guest_message<br>Send messages to guests in conversations
Financials & Pricing
Tool<br>Description
get_financials<br>Revenue, payouts, and commission data
update_pricing<br>Update base price or date-specific pricing
get_listing_pricing<br>Get base price, discounts, and fee details
update_listing_pricing<br>Update base price, cleaning fee, discounts
get_owner_statements<br>Owner revenue statements and reports
get_expenses<br>Track operational expenses
create_expense<br>Create new expense records
get_revenue_summary<br>Aggregated revenue across all listings
Operations
Tool<br>Description
get_tasks<br>Fetch cleaning and maintenance tasks
create_task<br>Create cleaning or maintenance tasks
get_reviews<br>Fetch guest reviews from all channels
respond_to_review<br>Post responses to guest reviews
get_channels<br>List connected booking channels per property
get_supported_languages<br>Get supported languages for a listing
Automation & Integrations
Tool<br>Description
get_automation_rules<br>List automation and workflow rules
get_webhooks<br>List registered webhooks
create_webhook<br>Register new webhook for event notifications
delete_webhook<br>Remove a registered webhook
get_custom_fields<br>Fetch custom fields for listings or reservations
get_account_info<br>Get account info and subscription details
Enterprise Tier
Tool<br>Description
get_property_health<br>Aggregate health signal per property: reservation status, open maintenance alerts, review-score, last-clean timestamp, IoT hub status
submit_checkout_photos<br>Accept post-checkout photo uploads and log them to the property's maintenance/cleaning record
get_maintenance_alerts<br>List or filter open maintenance alerts for a property or portfolio
Requires GUESTY_MCP_LICENSE_KEY with an Enterprise key (gmcp_ent_*). See pricing.
Use Cases
Guest Communication : AI agents auto-respond to guest inquiries using real reservation data
Revenue Management : Pull financial...