Guesty MCP Server

The first MCP (Model Context Protocol) server for Guesty property management. Connect any MCP-compatible AI client (Claude, ChatGPT, Copilot, Cline) to your Guesty account — manage reservations, communicate with guests, track finances, update pricing.

Just shipped v0.9.3 (2026-05-23): 23 free read-only tools — reservations, listings, guests, calendars, financial reports, operations, reviews, and webhook reads — live now. The full 43-tool surface (write/destructive ops + webhook management) ships behind a paid tier in v1.0 next week.

Why MCP: Guesty is one of the larger PMS platforms in the short-term-rental space and no MCP integration existed. Every major PMS will need one — we built the first.

Built in production on 8 of our own short-term rentals. Node.js + MCP SDK + Express, MIT licensed. Things we learned: Guesty's /reservations endpoint only returns future data (we use the calendar endpoint for historical), and the SSE transport doesn't run on Vercel serverless (expected). 2,112 lifetime npm downloads, 676 in the last 30 days.

Full tool surface: 43 tools across 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).

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": {
    "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

1. Log into Guesty Dashboard

2. Go to Settings > API (or Marketplace > API Credentials)

3. Create an API application with open-api scope

4. Copy your Client ID and Client Secret

All 43 Tools

Reservations & Guests

Listings & Calendar

Messaging

Financials & Pricing

Operations

Automation & Integrations

Enterprise Tier

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 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.)

Environment Variables

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