Skip to content
MCP server

CohostSTR (MCP server for Guesty)

Guesty property-management connector: guest replies, pricing, calendars and reservations

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.13.3
Listing updated
today

About CohostSTR (MCP server for Guesty)

CohostSTR (MCP server for Guesty) is an open-source MCP server for home services. It runs locally on your machine and is started by your AI client.

This is a write-capable bridge to Guesty for short-term rental hosts. Drafts use the real check-in time, access notes and house rules from your own listing and say they will check rather than inventing an answer. Outgoing messages containing a phone number, email, off-platform payment or a book-direct nudge are held before sending, because Airbnb, Vrbo and Booking.com can suspend listings for them.

The README counts 44 tools: 23 read-only, 16 write or messaging, 4 for IoT and property health, plus get_license_info. Hosts can ask who is waiting on a reply, build arrival messages and turnover lists, adjust pricing and the calendar, create or update reservations, log tasks, expenses and notes, pull reviews and draft replies, and read owner statements and reservation financials. Bulk changes such as raising December weekend rates ask for approval first.

It runs on your computer via npx with your Guesty OAuth client ID and secret, which need a Guesty plan with Open API access (Pro or Enterprise). It is MIT licensed and all tools are free; nothing runs on its own and nothing sends without your OK.

Install

Run in a terminal

claude mcp add cohoststr-mcp --env GUESTY_CLIENT_ID='<GUESTY_CLIENT_ID>' --env GUESTY_CLIENT_SECRET='<GUESTY_CLIENT_SECRET>' --env GUESTY_MCP_LICENSE_KEY='<GUESTY_MCP_LICENSE_KEY>' -- npx -y cohoststr-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cohoststr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cohoststr-mcp"
      ],
      "env": {
        "GUESTY_CLIENT_ID": "<GUESTY_CLIENT_ID>",
        "GUESTY_CLIENT_SECRET": "<GUESTY_CLIENT_SECRET>",
        "GUESTY_MCP_LICENSE_KEY": "<GUESTY_MCP_LICENSE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cohoststr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cohoststr-mcp"
      ],
      "env": {
        "GUESTY_CLIENT_ID": "<GUESTY_CLIENT_ID>",
        "GUESTY_CLIENT_SECRET": "<GUESTY_CLIENT_SECRET>",
        "GUESTY_MCP_LICENSE_KEY": "<GUESTY_MCP_LICENSE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "cohoststr-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cohoststr-mcp"
      ],
      "env": {
        "GUESTY_CLIENT_ID": "<GUESTY_CLIENT_ID>",
        "GUESTY_CLIENT_SECRET": "<GUESTY_CLIENT_SECRET>",
        "GUESTY_MCP_LICENSE_KEY": "<GUESTY_MCP_LICENSE_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cohoststr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cohoststr-mcp"
      ],
      "env": {
        "GUESTY_CLIENT_ID": "<GUESTY_CLIENT_ID>",
        "GUESTY_CLIENT_SECRET": "<GUESTY_CLIENT_SECRET>",
        "GUESTY_MCP_LICENSE_KEY": "<GUESTY_MCP_LICENSE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cohoststr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cohoststr-mcp"
      ],
      "env": {
        "GUESTY_CLIENT_ID": "<GUESTY_CLIENT_ID>",
        "GUESTY_CLIENT_SECRET": "<GUESTY_CLIENT_SECRET>",
        "GUESTY_MCP_LICENSE_KEY": "<GUESTY_MCP_LICENSE_KEY>"
      }
    }
  }
}

Configuration

  • GUESTY_CLIENT_IDGuesty OAuth2 Client IDRequired
  • GUESTY_CLIENT_SECRETGuesty OAuth2 Client SecretRequired
  • GUESTY_MCP_LICENSE_KEYOptional. All tools are currently free; a key is recognized but does not change access.

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

get_reservations
Fetch reservations with filters.
create_reservation
Create direct bookings.
update_reservation
Update reservation status, dates, guest info or 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_conversations
Read guest conversations.
draft_guest_reply
Draft a reply to a guest.
get_license_info
Report the server's licensing state.

What it does

Grounded replies
Drafts use your listing's real access details and house rules.
Policy screen
Holds messages with phone numbers, emails or off-platform payment hints.
Pricing and calendar
Update rates and availability from chat.
Reservations
Create and update reservations and add internal notes.
Reviews and owners
Draft review replies and read owner statements.
Operations tools
Tasks, expenses, webhooks and IoT property health.

Good for

  • Ask who is waiting on a reply and draft each answer
  • Send arrival-day messages with door codes and parking
  • Generate tomorrow's turnover list for a cleaner
  • Raise rates across a set of listings with approval

Pricing

Open source

Free, MIT; optional paid setup kit

Prices change. Check cohoststr.com before you buy.

CohostSTR (MCP server for Guesty) FAQ

What does it need?

Guesty OAuth client ID and secret from a plan with Open API access.

Is it free?

Yes, all tools are free and MIT licensed with no license key needed.

Does it send messages automatically?

No, you approve changes before they happen.

Where do my credentials go?

They stay on your computer.

Is CohostSTR (MCP server for Guesty) free?

Yes. CohostSTR (MCP server for Guesty) is open source, so you can use and self-host it for free.

How do I add CohostSTR (MCP server for Guesty) to Claude Code?

Run this command in your terminal: claude mcp add cohoststr-mcp --env GUESTY_CLIENT_ID='<GUESTY_CLIENT_ID>' --env GUESTY_CLIENT_SECRET='<GUESTY_CLIENT_SECRET>' --env GUESTY_MCP_LICENSE_KEY='<GUESTY_MCP_LICENSE_KEY>' -- npx -y cohoststr-mcp

What are the best alternatives to CohostSTR (MCP server for Guesty)?

The closest alternatives to CohostSTR (MCP server for Guesty) are Ha MCP, Concord MCP, note1, MadMax Trade Supply parts and CalderFlow.

Alternatives to CohostSTR (MCP server for Guesty)

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication