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.

Live now: all 43 tools, free — reservations, listings, guests, calendars, guest messaging, financial reports, pricing and listing writes, operations, reviews, webhooks, and IoT/property-health. No license key, no paid tier.

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 10 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). The first and only MCP server for Guesty — all 43 tools free.

Full tool surface: 43 tools registered, all free — 42 Guesty tools (23 read-only, 15 write/guest-messaging including get_conversations, and 4 IoT/property-health) plus get_license_info, which reports this server's own licensing state and makes no Guesty API call. There are no paid tiers. GUESTY_MCP_LICENSE_KEY is optional and does not change what you can call.

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

Everything is free. All 43 tools work with no license key. Paid-prefix keys are still recognized (they show up in get_license_info) but are not required and unlock nothing extra — there is nothing extra to unlock. Set or omit GUESTY_MCP_LICENSE_KEY; access is the same either way.

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

Server & Licensing

It is counted in the 43 registered tools but not in the "42 Guesty tools" figure, because it reports our licensing state rather than doing anything with your Guesty account: 42 Guesty tools + this one = 43.

IoT & Property Health

These four tools are free like everything else. They read the local IoT database (IOT_DB_PATH) that the optional webhook receiver (src/webhook/iot-receiver-server.js) populates. With no devices reporting they return empty device and alert lists, a low readiness score that names each missing signal, and null IoT fields in the health snapshot — not errors — and the Guesty-side fields still fill in.

Use Cases

• Guest Communication: guest-messaging tools draft and send replies grounded in 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
• Connected Tools: give every MCP-compatible client in your stack access to the same 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 -- Battle-tested on our own 10-property STR portfolio. Built for our own use, shared with the STR community.

License

MIT