CohostSTR (MCP server for Guesty)
io.github.cohoststr/cohoststr-mcp·v0.13.3CohostSTR: MCP server for Guesty. 43 read/write tools, free. Grounded replies, policy screen.
0 stars
Reviews
Write oneNobody has reviewed CohostSTR (MCP server for Guesty) yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
CohostSTR (MCP server for Guesty) tools (44, 15 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
create_expensewrite actionCreate a new expense record for a listing in Guesty.
create_reservationwrite actionCreate a new reservation/booking in Guesty. Use for direct bookings from your website.
create_reservation_notewrite actionAdd an internal note to a reservation visible only to the property management team.
create_taskwrite actionCreate a cleaning or maintenance task for a listing.
create_webhookwrite actionRegister a new webhook to receive event notifications from Guesty.
delete_webhookwrite actionDelete a registered webhook by ID.
draft_guest_replyGather everything needed to draft an accurate reply to a guest: their recent messages, the reservation and the listing's real check-in/out times, access notes and house rules, plus drafting rules. Sends nothing.
get_account_infoGet current Guesty account information and subscription details.
get_automation_rulesList automation and workflow rules configured in Guesty.
get_calendarFetch calendar availability and pricing for a listing over a date range.
get_calendar_blocksGet blocked dates and their reasons for a listing over a date range.
get_channelsList connected booking channels (Airbnb, VRBO, Booking.com, etc.) and their status.
get_conversationsFetch guest conversations/messages from Guesty. Get message history for a reservation or listing.
get_custom_fieldsFetch custom fields configured for listings or reservations.
get_expensesFetch operational expenses tracked in Guesty.
get_financialsFetch reservation financials (host payout and payments recorded in Guesty). Counts confirmed reservations only unless another status is requested.
get_guest_by_idGet detailed guest profile by guest ID.
get_guestsFetch guest database/profiles. Search by name or email.
get_license_infoReport this server's licensing state. Every registered tool is currently free; lists the tool ledger and whether a key was detected. Makes no Guesty API call.
get_listingFetch details about a specific property listing or all listings.
get_listing_occupancyCalculate occupancy rate for a listing over a date range.
get_listing_pricingGet pricing details for a listing including base price, weekly/monthly discounts, and extra fees.
get_maintenance_alertsList or filter open maintenance alerts for a specific property or across the whole portfolio. Supports severity filtering and active-only (unresolved) filtering. IoT-sourced today; future Phase will merge Guesty-native task alerts.
get_owner_statementsFetch owner revenue statements/reports for properties.
get_photosFetch photos for a specific listing including URLs, captions, and sort order.
get_property_healthAggregate health signal per property: IoT device status + overall IoT state, current reservation status, 50-review average score, and last-clean timestamp. Single-call snapshot for ops dashboards. Sub-fetches that fail degrade gracefully (null value + error note).
get_readiness_scoreCalculate a 0-100 Physical Readiness Score for a property before guest check-in. Evaluates temperature, leak detection, door lock, humidity, critical alerts, and baseline photos.
get_reservation_financialsGet detailed financial breakdown for a specific reservation including payments, charges, and adjustments.
get_reservationsFetch reservations from Guesty. Filter by date range, listing, status, or guest name.
get_revenue_summaryGet aggregated revenue summary across all or specific listings for a date range.
get_reviewsFetch guest reviews for your properties from all channels.
get_supported_languagesGet supported languages configured for a listing.
get_tasksFetch cleaning and maintenance tasks from Guesty.
get_webhooksList all registered webhooks for your Guesty account.
respond_to_reviewwrite actionPost a response to a guest review.
search_reservationsSearch reservations by guest name, email, or confirmation code.
send_guest_messagewrite actionSend a message to a guest in a Guesty conversation.
submit_checkout_photoswrite actionAccept post-checkout photo uploads and log them to the property's maintenance/cleaning record. Photos are queued for downstream inspection workflows (Phase 2 vision comparison).
update_calendarwrite actionBlock or unblock dates, set minimum nights, or update availability for a listing.
update_listingwrite actionUpdate listing details such as title, description, amenities, min nights, and max guests.
update_listing_pricingwrite actionUpdate pricing for a listing — base price, cleaning fee, extra person fee, and discounts.
update_photoswrite actionReplace or reorder photos for a listing. Provide the full array of photos in desired order.
update_pricingwrite actionUpdate the base price for a listing on specific dates or the default base price.
update_reservationwrite actionUpdate reservation details such as status, dates, guest info, or add notes.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan25 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How CohostSTR (MCP server for Guesty) compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,255 servers
- Tools
- 44
- the typical server has 7
- Tools that change things
- 34%
- typical: 0%. Fewer write tools means less an agent can break
What its tools let an agent do: 29 read · 5 create · 8 change · 1 delete · 1 send or post
Install CohostSTR (MCP server for Guesty) in Claude Code, Cursor or VS Code
Runs npx -y cohoststr-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add cohoststr-mcp -- npx -y cohoststr-mcp
What the publisher says
From the CohostSTR (MCP server for Guesty) repository's README, as published. We do not edit it. Read it on GitHub
CohostSTR — MCP server for Guesty
An open-source, write-capable 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 Guesty 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.
Built and run in production on our own short-term rental portfolio. 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). All 44 tools free.
Full tool surface: 44 tools registered, all free — 43 Guesty tools (23 read-only, 16 write/guest-messaging including getconversations and draftguestreply, and 4 IoT/property-health) plus getlicenseinfo, which reports this server's own licensing state and makes no Guesty API call. There are no paid tiers. GUESTYMCPLICENSEKEY is optional and does not change what you can call.
Everything is free. All 44 tools work with no license key. Paid-prefix keys are still recognized (they show up in getlicenseinfo) but are not required and unlock nothing extra — there is nothing extra to unlock. Set or omit GUESTYMCPLICENSE_KEY; access is the same either way.
Quick Start
Easiest: one command for Claude Desktop (your key is never shown on screen)
npx -y cohoststr-mcp setupIt asks for your Guesty Client ID and Client Secret in a hidden prompt (nothing is echoed, not even asterisks), backs up your existing Claude Desktop config, adds CohostSTR, and keeps any other MCP servers you already have. Then quit and reopen Claude Desktop. When Claude asks to use a tool that changes something, allow it one time only (not "always"), so you approve each change.
Or configure it yourself
npx cohoststr-mcpClaude Code:
claude mcp add cohoststr -s user -e GUESTY_CLIENT_ID=your-client-id -e GUESTY_CLIENT_SECRET=your-client-secret -- npx -y cohoststr-mcpClaude Desktop by hand: Settings > Developer > Edit Config, then add under mcpServers:
{
"mcpServers": {
"cohoststr": {
"command": "npx",
"args": ["-y", "cohoststr-mcp"],
"env": {
"GUESTY_CLIENT_ID": "your-client-id",
"GUESTY_CLIENT_SECRET": "your-client-secret"
}
}
}
}Get Guesty API Credentials
Requires a Guesty plan with Open API access (Pro or Enterprise; not Lite, per guesty.com/pricing).
- Log into Guesty
- Go to Integrations > Developer tools > OAuth applications and create a new API application (Guesty quick-start guide)
- Copy your Client ID and Client Secret (Guesty shows the secret only once)
All 44 Tools
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
CohostSTR (MCP server for Guesty): common questions
- Is CohostSTR (MCP server for Guesty) safe?
- Mostly: it is graded B (82/100). Read the CohostSTR (MCP server for Guesty) safety report
- How do I install CohostSTR (MCP server for Guesty)?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does CohostSTR (MCP server for Guesty) need an API key?
- Yes. The registry entry asks for
GUESTY_CLIENT_ID,GUESTY_CLIENT_SECRET,GUESTY_MCP_LICENSE_KEY. - Is CohostSTR (MCP server for Guesty) maintained?
- The last commit was 40 days ago (2026-09-25). The latest release is v0.13.3.
- How does CohostSTR (MCP server for Guesty) compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,255 servers); tools 44 (the typical server has 7); tools that change things 34% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.