# CohostSTR (MCP server for Guesty)

> CohostSTR (MCP server for Guesty) is an open-source MCP server for home services. Guesty property-management connector: guest replies, pricing, calendars and reservations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://cohoststr.com
- **Repository:** https://github.com/cohoststr/cohoststr-mcp
- **MCP Registry name:** io.github.cohoststr/cohoststr-mcp
- **Categories:** home services, productivity
- **Listing updated:** 2026-11-17

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/cohoststr-mcp-server-for-guesty
