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.

38 tools covering reservations, listings, guests, messaging, financials, tasks, calendars, webhooks, pricing, and more.

Quick Start

npx guesty-mcp-server

Or add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "guesty": {
      "command": "npx",
      "args": ["-y", "guesty-mcp-server"],
      "env": {
        "GUESTY_CLIENT_ID": "your-client-id",
        "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 38 Tools

Reservations & Guests

| Tool | Description | |------|-------------| | get_reservations | Fetch reservations with filters (dates, listing, status, guest) | | create_reservation | Create direct bookings (website to Guesty) | | update_reservation | Update reservation status, dates, guest info, or add notes | | search_reservations | Search by guest name, email, or confirmation code | | get_reservation_financials | Detailed financial breakdown for a reservation | | create_reservation_note | Add internal notes to a reservation | | get_guests | Search guest database by name or email | | get_guest_by_id | Get detailed guest profile |

Listings & Calendar

| Tool | Description | |------|-------------| | get_listing | Get property details or list all properties | | update_listing | Update title, description, amenities, min nights, max guests | | get_calendar | Check availability and pricing by date | | update_calendar | Block/unblock dates, set minimum nights | | get_calendar_blocks | Get blocked dates with reasons | | get_listing_occupancy | Calculate occupancy rate over a date range | | get_photos | Fetch listing photos with captions | | update_photos | Replace or reorder listing photos |

Messaging

| Tool | Description | |------|-------------| | get_conversations | Fetch guest message history | | send_guest_message | Send messages to guests in conversations |

Financials & Pricing

| Tool | Description | |------|-------------| | get_financials | Revenue, payouts, and commission data | | update_pricing | Update base price or date-specific pricing | | get_listing_pricing | Get base price, discounts, and fee details | | update_listing_pricing | Update base price, cleaning fee, discounts | | get_owner_statements | Owner revenue statements and reports | | get_expenses | Track operational expenses | | create_expense | Create new expense records | | get_revenue_summary | Aggregated revenue across all listings |

Operations

| Tool | Description | |------|-------------| | get_tasks | Fetch cleaning and maintenance tasks | | create_task | Create cleaning or maintenance tasks | | get_reviews | Fetch guest reviews from all channels | | respond_to_review | Post responses to guest reviews | | get_channels | List connected booking channels per property | | get_supported_languages | Get supported languages for a listing |

Automation & Integrations

| Tool | Description | |------|-------------| | get_automation_rules | List automation and workflow rules | | get_webhooks | List registered webhooks | | create_webhook | Register new webhook for event notifications | | delete_webhook | Remove a registered webhook | | get_custom_fields | Fetch custom fields for listings or reservations | | get_account_info | Get account info and subscription details |

Use Cases

Guest Communication: AI agents auto-respond to guest inquiries using real reservation data
Revenue Management: Pull financial reports, analyze occupancy, optimize pricing
Operations: Track check-ins/outs, coordinate cleaning schedules, manage availability
Marketing: Identify low-occupancy periods, create targeted promotions
Multi-Agent Teams: Give your entire AI team access to property data

Requirements

Node.js 18+
Guesty account with API access (Professional plan or higher)
MCP-compatible AI client (Claude Code, Cursor, Windsurf, etc.)

API Reference

This server wraps the Guesty Open API. Authentication uses OAuth2 client credentials flow with automatic token caching, retry logic, and rate limit handling.

Built By

DLJ Properties -- Running 7 properties with a fully autonomous AI agent team. Built for our own use, shared with the STR community.

License

MIT

MCP Servers