guesty-mcp-server 0.9.4 → 0.9.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -5,19 +5,19 @@
|
|
|
5
5
|
|
|
6
6
|
The first MCP (Model Context Protocol) server for [Guesty](https://guesty.com) 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.
|
|
7
7
|
|
|
8
|
-
**Just shipped v0.9.
|
|
8
|
+
**Just shipped v0.9.5:** 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.
|
|
9
9
|
|
|
10
10
|
**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.
|
|
11
11
|
|
|
12
|
-
**Built in production** on
|
|
12
|
+
**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 — 23 free read-only tools live now.**
|
|
13
13
|
|
|
14
|
-
Full tool surface: **43 tools**
|
|
14
|
+
Full tool surface: **43 tools total** — 23 free read-only tools live now; the full **39-tool Pro** tier (adds 16 write/guest-messaging tools) and a **4-tool Enterprise IoT** add-on (`get_readiness_score`, `get_property_health`, `submit_checkout_photos`, `get_maintenance_alerts`) unlock at v1.0.
|
|
15
15
|
|
|
16
16
|
> **Want AI to handle your guest messages 24/7?** [Guesty Copilot](https://guestycopilot.com) -- AI guest management for Guesty hosts, built on this MCP server. Now in beta.
|
|
17
17
|
|
|
18
18
|
> **Stay updated:** [Sign up for release notes and new tool announcements](https://guestycopilot.com#signup)
|
|
19
19
|
|
|
20
|
-
> **v0.9.
|
|
20
|
+
> **v0.9.5 — Paid tiers launching v1.0.** 23 free read-only tools live now: reservations, listings, guests, calendars, financial reports, operations, reviews, and webhook reads. 39-tool Pro + 4-tool Enterprise IoT unlock at v1.0 with Stripe-backed 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.
|
|
21
21
|
|
|
22
22
|
## Quick Start
|
|
23
23
|
|
|
@@ -124,11 +124,11 @@ Requires `GUESTY_MCP_LICENSE_KEY` with an Enterprise key (`gmcp_ent_*`). See [pr
|
|
|
124
124
|
|
|
125
125
|
## Use Cases
|
|
126
126
|
|
|
127
|
-
- **Guest Communication**:
|
|
127
|
+
- **Guest Communication**: guest-messaging tools draft and send replies grounded in real reservation data
|
|
128
128
|
- **Revenue Management**: Pull financial reports, analyze occupancy, optimize pricing
|
|
129
129
|
- **Operations**: Track check-ins/outs, coordinate cleaning schedules, manage availability
|
|
130
130
|
- **Marketing**: Identify low-occupancy periods, create targeted promotions
|
|
131
|
-
- **
|
|
131
|
+
- **Connected Tools**: give every MCP-compatible client in your stack access to the same property data
|
|
132
132
|
|
|
133
133
|
## Requirements
|
|
134
134
|
|
|
@@ -150,7 +150,7 @@ This server wraps the [Guesty Open API](https://open-api.guesty.com/api-docs). A
|
|
|
150
150
|
|
|
151
151
|
## Built By
|
|
152
152
|
|
|
153
|
-
[DLJ Properties](https://tinyhomeboutiques.com) --
|
|
153
|
+
[DLJ Properties](https://tinyhomeboutiques.com) -- Battle-tested on our own 10-property STR portfolio. Built for our own use, shared with the STR community.
|
|
154
154
|
|
|
155
155
|
## License
|
|
156
156
|
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Guesty MCP Server
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/guesty-mcp-server)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
|
|
6
|
+
The first MCP (Model Context Protocol) server for [Guesty](https://guesty.com) 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.
|
|
7
|
+
|
|
8
|
+
**Just shipped v0.9.4 (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.
|
|
9
|
+
|
|
10
|
+
**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.
|
|
11
|
+
|
|
12
|
+
**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.**
|
|
13
|
+
|
|
14
|
+
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`).
|
|
15
|
+
|
|
16
|
+
> **Want AI to handle your guest messages 24/7?** [Guesty Copilot](https://guestycopilot.com) -- AI guest management for Guesty hosts, built on this MCP server. Now in beta.
|
|
17
|
+
|
|
18
|
+
> **Stay updated:** [Sign up for release notes and new tool announcements](https://guestycopilot.com#signup)
|
|
19
|
+
|
|
20
|
+
> **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.
|
|
21
|
+
|
|
22
|
+
## Quick Start
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
npx guesty-mcp-server
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Or add to your Claude Code settings (`~/.claude/settings.json`):
|
|
29
|
+
|
|
30
|
+
```json
|
|
31
|
+
{
|
|
32
|
+
"mcpServers": {
|
|
33
|
+
"guesty": {
|
|
34
|
+
"command": "npx",
|
|
35
|
+
"args": ["-y", "guesty-mcp-server"],
|
|
36
|
+
"env": {
|
|
37
|
+
"GUESTY_CLIENT_ID": "your-client-id",
|
|
38
|
+
"GUESTY_CLIENT_SECRET": "your-client-secret"
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Get Guesty API Credentials
|
|
46
|
+
|
|
47
|
+
1. Log into [Guesty Dashboard](https://app.guesty.com)
|
|
48
|
+
2. Go to **Settings > API** (or Marketplace > API Credentials)
|
|
49
|
+
3. Create an API application with `open-api` scope
|
|
50
|
+
4. Copy your **Client ID** and **Client Secret**
|
|
51
|
+
|
|
52
|
+
## All 43 Tools
|
|
53
|
+
|
|
54
|
+
### Reservations & Guests
|
|
55
|
+
| Tool | Description |
|
|
56
|
+
|------|-------------|
|
|
57
|
+
| `get_reservations` | Fetch reservations with filters (dates, listing, status, guest) |
|
|
58
|
+
| `create_reservation` | Create direct bookings (website to Guesty) |
|
|
59
|
+
| `update_reservation` | Update reservation status, dates, guest info, or add notes |
|
|
60
|
+
| `search_reservations` | Search by guest name, email, or confirmation code |
|
|
61
|
+
| `get_reservation_financials` | Detailed financial breakdown for a reservation |
|
|
62
|
+
| `create_reservation_note` | Add internal notes to a reservation |
|
|
63
|
+
| `get_guests` | Search guest database by name or email |
|
|
64
|
+
| `get_guest_by_id` | Get detailed guest profile |
|
|
65
|
+
|
|
66
|
+
### Listings & Calendar
|
|
67
|
+
| Tool | Description |
|
|
68
|
+
|------|-------------|
|
|
69
|
+
| `get_listing` | Get property details or list all properties |
|
|
70
|
+
| `update_listing` | Update title, description, amenities, min nights, max guests |
|
|
71
|
+
| `get_calendar` | Check availability and pricing by date |
|
|
72
|
+
| `update_calendar` | Block/unblock dates, set minimum nights |
|
|
73
|
+
| `get_calendar_blocks` | Get blocked dates with reasons |
|
|
74
|
+
| `get_listing_occupancy` | Calculate occupancy rate over a date range |
|
|
75
|
+
| `get_photos` | Fetch listing photos with captions |
|
|
76
|
+
| `update_photos` | Replace or reorder listing photos |
|
|
77
|
+
|
|
78
|
+
### Messaging
|
|
79
|
+
| Tool | Description |
|
|
80
|
+
|------|-------------|
|
|
81
|
+
| `get_conversations` | Fetch guest message history |
|
|
82
|
+
| `send_guest_message` | Send messages to guests in conversations |
|
|
83
|
+
|
|
84
|
+
### Financials & Pricing
|
|
85
|
+
| Tool | Description |
|
|
86
|
+
|------|-------------|
|
|
87
|
+
| `get_financials` | Revenue, payouts, and commission data |
|
|
88
|
+
| `update_pricing` | Update base price or date-specific pricing |
|
|
89
|
+
| `get_listing_pricing` | Get base price, discounts, and fee details |
|
|
90
|
+
| `update_listing_pricing` | Update base price, cleaning fee, discounts |
|
|
91
|
+
| `get_owner_statements` | Owner revenue statements and reports |
|
|
92
|
+
| `get_expenses` | Track operational expenses |
|
|
93
|
+
| `create_expense` | Create new expense records |
|
|
94
|
+
| `get_revenue_summary` | Aggregated revenue across all listings |
|
|
95
|
+
|
|
96
|
+
### Operations
|
|
97
|
+
| Tool | Description |
|
|
98
|
+
|------|-------------|
|
|
99
|
+
| `get_tasks` | Fetch cleaning and maintenance tasks |
|
|
100
|
+
| `create_task` | Create cleaning or maintenance tasks |
|
|
101
|
+
| `get_reviews` | Fetch guest reviews from all channels |
|
|
102
|
+
| `respond_to_review` | Post responses to guest reviews |
|
|
103
|
+
| `get_channels` | List connected booking channels per property |
|
|
104
|
+
| `get_supported_languages` | Get supported languages for a listing |
|
|
105
|
+
|
|
106
|
+
### Automation & Integrations
|
|
107
|
+
| Tool | Description |
|
|
108
|
+
|------|-------------|
|
|
109
|
+
| `get_automation_rules` | List automation and workflow rules |
|
|
110
|
+
| `get_webhooks` | List registered webhooks |
|
|
111
|
+
| `create_webhook` | Register new webhook for event notifications |
|
|
112
|
+
| `delete_webhook` | Remove a registered webhook |
|
|
113
|
+
| `get_custom_fields` | Fetch custom fields for listings or reservations |
|
|
114
|
+
| `get_account_info` | Get account info and subscription details |
|
|
115
|
+
|
|
116
|
+
### Enterprise Tier
|
|
117
|
+
| Tool | Description |
|
|
118
|
+
|------|-------------|
|
|
119
|
+
| `get_property_health` | Aggregate health signal per property: reservation status, open maintenance alerts, review-score, last-clean timestamp, IoT hub status |
|
|
120
|
+
| `submit_checkout_photos` | Accept post-checkout photo uploads and log them to the property's maintenance/cleaning record |
|
|
121
|
+
| `get_maintenance_alerts` | List or filter open maintenance alerts for a property or portfolio |
|
|
122
|
+
|
|
123
|
+
Requires `GUESTY_MCP_LICENSE_KEY` with an Enterprise key (`gmcp_ent_*`). See [pricing](https://guestycopilot.com/pricing).
|
|
124
|
+
|
|
125
|
+
## Use Cases
|
|
126
|
+
|
|
127
|
+
- **Guest Communication**: AI agents auto-respond to guest inquiries using real reservation data
|
|
128
|
+
- **Revenue Management**: Pull financial reports, analyze occupancy, optimize pricing
|
|
129
|
+
- **Operations**: Track check-ins/outs, coordinate cleaning schedules, manage availability
|
|
130
|
+
- **Marketing**: Identify low-occupancy periods, create targeted promotions
|
|
131
|
+
- **Multi-Agent Teams**: Give your entire AI team access to property data
|
|
132
|
+
|
|
133
|
+
## Requirements
|
|
134
|
+
|
|
135
|
+
- Node.js 18+
|
|
136
|
+
- Guesty account with API access (Professional plan or higher)
|
|
137
|
+
- MCP-compatible AI client (Claude Code, Cursor, Windsurf, etc.)
|
|
138
|
+
|
|
139
|
+
## Environment Variables
|
|
140
|
+
|
|
141
|
+
| Variable | Default | Purpose |
|
|
142
|
+
|----------|---------|---------|
|
|
143
|
+
| `GUESTY_CLIENT_ID` | — | OAuth2 client id (required) |
|
|
144
|
+
| `GUESTY_CLIENT_SECRET` | — | OAuth2 client secret (required) |
|
|
145
|
+
| `IOT_WEBHOOK_PORT` | `3100` | Port for the Enterprise-tier IoT webhook receiver stub (`src/webhook/iot-receiver-server.js`). Local/reverse-proxy only — do not expose publicly. Production requires a reverse proxy that terminates TLS and enforces real HMAC against `IOT_WEBHOOK_SECRET`. |
|
|
146
|
+
|
|
147
|
+
## API Reference
|
|
148
|
+
|
|
149
|
+
This server wraps the [Guesty Open API](https://open-api.guesty.com/api-docs). Authentication uses OAuth2 client credentials flow with automatic token caching, retry logic, and rate limit handling.
|
|
150
|
+
|
|
151
|
+
## Built By
|
|
152
|
+
|
|
153
|
+
[DLJ Properties](https://tinyhomeboutiques.com) -- Battle-tested on our own 10-property STR portfolio. Built for our own use, shared with the STR community.
|
|
154
|
+
|
|
155
|
+
## License
|
|
156
|
+
|
|
157
|
+
MIT
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
# Guesty MCP Server
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/guesty-mcp-server)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
|
|
6
|
+
The first MCP (Model Context Protocol) server for [Guesty](https://guesty.com) 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.
|
|
7
|
+
|
|
8
|
+
**Just shipped v0.9.4 (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.
|
|
9
|
+
|
|
10
|
+
**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.
|
|
11
|
+
|
|
12
|
+
**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). **779 downloads in the last 30 days.**
|
|
13
|
+
|
|
14
|
+
Full tool surface: **43 tools total** — 23 free read-only tools live now; the full **39-tool Pro** tier (adds 16 write/guest-messaging tools) and a **4-tool Enterprise IoT** add-on (`get_readiness_score`, `get_property_health`, `submit_checkout_photos`, `get_maintenance_alerts`) unlock at v1.0.
|
|
15
|
+
|
|
16
|
+
> **Want AI to handle your guest messages 24/7?** [Guesty Copilot](https://guestycopilot.com) -- AI guest management for Guesty hosts, built on this MCP server. Now in beta.
|
|
17
|
+
|
|
18
|
+
> **Stay updated:** [Sign up for release notes and new tool announcements](https://guestycopilot.com#signup)
|
|
19
|
+
|
|
20
|
+
> **v0.9.4 — Paid tiers launching v1.0.** 23 free read-only tools live now: reservations, listings, guests, calendars, financial reports, operations, reviews, and webhook reads. 39-tool Pro + 4-tool Enterprise IoT unlock at v1.0 with Stripe-backed 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.
|
|
21
|
+
|
|
22
|
+
## Quick Start
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
npx guesty-mcp-server
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Or add to your Claude Code settings (`~/.claude/settings.json`):
|
|
29
|
+
|
|
30
|
+
```json
|
|
31
|
+
{
|
|
32
|
+
"mcpServers": {
|
|
33
|
+
"guesty": {
|
|
34
|
+
"command": "npx",
|
|
35
|
+
"args": ["-y", "guesty-mcp-server"],
|
|
36
|
+
"env": {
|
|
37
|
+
"GUESTY_CLIENT_ID": "your-client-id",
|
|
38
|
+
"GUESTY_CLIENT_SECRET": "your-client-secret"
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Get Guesty API Credentials
|
|
46
|
+
|
|
47
|
+
1. Log into [Guesty Dashboard](https://app.guesty.com)
|
|
48
|
+
2. Go to **Settings > API** (or Marketplace > API Credentials)
|
|
49
|
+
3. Create an API application with `open-api` scope
|
|
50
|
+
4. Copy your **Client ID** and **Client Secret**
|
|
51
|
+
|
|
52
|
+
## All 43 Tools
|
|
53
|
+
|
|
54
|
+
### Reservations & Guests
|
|
55
|
+
| Tool | Description |
|
|
56
|
+
|------|-------------|
|
|
57
|
+
| `get_reservations` | Fetch reservations with filters (dates, listing, status, guest) |
|
|
58
|
+
| `create_reservation` | Create direct bookings (website to Guesty) |
|
|
59
|
+
| `update_reservation` | Update reservation status, dates, guest info, or add notes |
|
|
60
|
+
| `search_reservations` | Search by guest name, email, or confirmation code |
|
|
61
|
+
| `get_reservation_financials` | Detailed financial breakdown for a reservation |
|
|
62
|
+
| `create_reservation_note` | Add internal notes to a reservation |
|
|
63
|
+
| `get_guests` | Search guest database by name or email |
|
|
64
|
+
| `get_guest_by_id` | Get detailed guest profile |
|
|
65
|
+
|
|
66
|
+
### Listings & Calendar
|
|
67
|
+
| Tool | Description |
|
|
68
|
+
|------|-------------|
|
|
69
|
+
| `get_listing` | Get property details or list all properties |
|
|
70
|
+
| `update_listing` | Update title, description, amenities, min nights, max guests |
|
|
71
|
+
| `get_calendar` | Check availability and pricing by date |
|
|
72
|
+
| `update_calendar` | Block/unblock dates, set minimum nights |
|
|
73
|
+
| `get_calendar_blocks` | Get blocked dates with reasons |
|
|
74
|
+
| `get_listing_occupancy` | Calculate occupancy rate over a date range |
|
|
75
|
+
| `get_photos` | Fetch listing photos with captions |
|
|
76
|
+
| `update_photos` | Replace or reorder listing photos |
|
|
77
|
+
|
|
78
|
+
### Messaging
|
|
79
|
+
| Tool | Description |
|
|
80
|
+
|------|-------------|
|
|
81
|
+
| `get_conversations` | Fetch guest message history |
|
|
82
|
+
| `send_guest_message` | Send messages to guests in conversations |
|
|
83
|
+
|
|
84
|
+
### Financials & Pricing
|
|
85
|
+
| Tool | Description |
|
|
86
|
+
|------|-------------|
|
|
87
|
+
| `get_financials` | Revenue, payouts, and commission data |
|
|
88
|
+
| `update_pricing` | Update base price or date-specific pricing |
|
|
89
|
+
| `get_listing_pricing` | Get base price, discounts, and fee details |
|
|
90
|
+
| `update_listing_pricing` | Update base price, cleaning fee, discounts |
|
|
91
|
+
| `get_owner_statements` | Owner revenue statements and reports |
|
|
92
|
+
| `get_expenses` | Track operational expenses |
|
|
93
|
+
| `create_expense` | Create new expense records |
|
|
94
|
+
| `get_revenue_summary` | Aggregated revenue across all listings |
|
|
95
|
+
|
|
96
|
+
### Operations
|
|
97
|
+
| Tool | Description |
|
|
98
|
+
|------|-------------|
|
|
99
|
+
| `get_tasks` | Fetch cleaning and maintenance tasks |
|
|
100
|
+
| `create_task` | Create cleaning or maintenance tasks |
|
|
101
|
+
| `get_reviews` | Fetch guest reviews from all channels |
|
|
102
|
+
| `respond_to_review` | Post responses to guest reviews |
|
|
103
|
+
| `get_channels` | List connected booking channels per property |
|
|
104
|
+
| `get_supported_languages` | Get supported languages for a listing |
|
|
105
|
+
|
|
106
|
+
### Automation & Integrations
|
|
107
|
+
| Tool | Description |
|
|
108
|
+
|------|-------------|
|
|
109
|
+
| `get_automation_rules` | List automation and workflow rules |
|
|
110
|
+
| `get_webhooks` | List registered webhooks |
|
|
111
|
+
| `create_webhook` | Register new webhook for event notifications |
|
|
112
|
+
| `delete_webhook` | Remove a registered webhook |
|
|
113
|
+
| `get_custom_fields` | Fetch custom fields for listings or reservations |
|
|
114
|
+
| `get_account_info` | Get account info and subscription details |
|
|
115
|
+
|
|
116
|
+
### Enterprise Tier
|
|
117
|
+
| Tool | Description |
|
|
118
|
+
|------|-------------|
|
|
119
|
+
| `get_property_health` | Aggregate health signal per property: reservation status, open maintenance alerts, review-score, last-clean timestamp, IoT hub status |
|
|
120
|
+
| `submit_checkout_photos` | Accept post-checkout photo uploads and log them to the property's maintenance/cleaning record |
|
|
121
|
+
| `get_maintenance_alerts` | List or filter open maintenance alerts for a property or portfolio |
|
|
122
|
+
|
|
123
|
+
Requires `GUESTY_MCP_LICENSE_KEY` with an Enterprise key (`gmcp_ent_*`). See [pricing](https://guestycopilot.com/pricing).
|
|
124
|
+
|
|
125
|
+
## Use Cases
|
|
126
|
+
|
|
127
|
+
- **Guest Communication**: guest-messaging tools draft and send replies grounded in real reservation data
|
|
128
|
+
- **Revenue Management**: Pull financial reports, analyze occupancy, optimize pricing
|
|
129
|
+
- **Operations**: Track check-ins/outs, coordinate cleaning schedules, manage availability
|
|
130
|
+
- **Marketing**: Identify low-occupancy periods, create targeted promotions
|
|
131
|
+
- **Connected Tools**: give every MCP-compatible client in your stack access to the same property data
|
|
132
|
+
|
|
133
|
+
## Requirements
|
|
134
|
+
|
|
135
|
+
- Node.js 18+
|
|
136
|
+
- Guesty account with API access (Professional plan or higher)
|
|
137
|
+
- MCP-compatible AI client (Claude Code, Cursor, Windsurf, etc.)
|
|
138
|
+
|
|
139
|
+
## Environment Variables
|
|
140
|
+
|
|
141
|
+
| Variable | Default | Purpose |
|
|
142
|
+
|----------|---------|---------|
|
|
143
|
+
| `GUESTY_CLIENT_ID` | — | OAuth2 client id (required) |
|
|
144
|
+
| `GUESTY_CLIENT_SECRET` | — | OAuth2 client secret (required) |
|
|
145
|
+
| `IOT_WEBHOOK_PORT` | `3100` | Port for the Enterprise-tier IoT webhook receiver stub (`src/webhook/iot-receiver-server.js`). Local/reverse-proxy only — do not expose publicly. Production requires a reverse proxy that terminates TLS and enforces real HMAC against `IOT_WEBHOOK_SECRET`. |
|
|
146
|
+
|
|
147
|
+
## API Reference
|
|
148
|
+
|
|
149
|
+
This server wraps the [Guesty Open API](https://open-api.guesty.com/api-docs). Authentication uses OAuth2 client credentials flow with automatic token caching, retry logic, and rate limit handling.
|
|
150
|
+
|
|
151
|
+
## Built By
|
|
152
|
+
|
|
153
|
+
[DLJ Properties](https://tinyhomeboutiques.com) -- Battle-tested on our own 10-property STR portfolio. Built for our own use, shared with the STR community.
|
|
154
|
+
|
|
155
|
+
## License
|
|
156
|
+
|
|
157
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "guesty-mcp-server",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.5",
|
|
4
4
|
"description": "MCP server for Guesty property management — 43 production tools + 7 addressable resource templates covering reservations, guests, messaging, pricing, revenue, tasks, webhooks, and IoT/property-health Enterprise tier.",
|
|
5
5
|
"main": "src/server.js",
|
|
6
6
|
"bin": {
|
package/server.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"name": "io.github.DLJRealty/guesty",
|
|
4
4
|
"title": "Guesty MCP Server",
|
|
5
5
|
"description": "MCP server for Guesty property management. 43 tools for STR operations.",
|
|
6
|
-
"version": "0.
|
|
6
|
+
"version": "0.9.4",
|
|
7
7
|
"repository": {
|
|
8
8
|
"url": "https://github.com/DLJRealty/guesty-mcp-server",
|
|
9
9
|
"source": "github"
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
{
|
|
13
13
|
"registryType": "npm",
|
|
14
14
|
"identifier": "guesty-mcp-server",
|
|
15
|
-
"version": "0.
|
|
15
|
+
"version": "0.9.4",
|
|
16
16
|
"transport": {
|
|
17
17
|
"type": "stdio"
|
|
18
18
|
},
|