@prosperkartik/hostaway-mcp

Hostaway PMS를 위한 모델 컨텍스트 프로토콜(MCP) 서버 — Claude를 귀하의 휴가용 임대 운영에 연결하세요.

@prosperkartik/hostaway-mcp는 Claude(Claude Code, Claude Desktop 또는 모든 MCP 호환 클라이언트)를 귀하의 Hostaway 계정에 연결하여 숙소, 예약, 달력 가용성, 게스트 메시징 및 재무 정보를 관리할 수 있게 합니다. 2022년부터 단기 임대 운영자를 위해 Hostaway, Ciirus 및 주요 OTA API(Airbnb, VRBO, Booking.com, Expedia, Marriott)를 프로덕션 환경에 통합해 온 엔지니어가 작성했습니다.

Hostaway는 Hostaway Inc.의 상표입니다. 이 프로젝트는 커뮤니티에서 구축되었으며 Hostaway와 제휴하거나 보증하지 않습니다.

이 서버를 사용하는 이유

세 가지 이유:

1. 도구 범위. 숙소, 예약, 달력, 대화, 재무 및 상태 확인을 아우르는 10가지 읽기 전용 도구 — 이 분야의 다른 커뮤니티 MCP 서버보다 더 넓은 범위를 다룹니다.

2. 더 깔끔한 인증 UX. Hostaway API 설정 페이지에서 제공하는 두 가지 자격 증명(계정 ID + API 키)을 사용하여 내부적으로 OAuth 토큰 교환을 처리합니다. "다른 곳에서 베어러 토큰을 먼저 생성하세요"와 같은 단계가 필요 없습니다.

3. API를 직접 다루는 사람이 제작. 작성자는 3년 이상 Hostaway / Ciirus 통합 작업을 수행하며 설계 결정을 내렸습니다. 도구는 단순한 REST 엔드포인트가 아니라 실제 운영자의 워크플로우에 맞춰져 있습니다.

Related MCP server: Lodgify MCP Server

도구 (v0.1)

모든 v0.1 도구는 읽기 전용입니다. 쓰기 작업은 향후 버전에서 명시적인 확인 절차를 거쳐 추가될 예정입니다.

빠른 시작

1. Hostaway API 자격 증명 받기

Hostaway 운영자 계정 → Settings → Hostaway API로 이동합니다. API 자격 증명을 생성하세요. Account ID와 API Key를 받게 됩니다.

2. Claude Code에 추가

claude mcp add hostaway \
  --scope user \
  -e HOSTAWAY_ACCOUNT_ID=your-account-id \
  -e HOSTAWAY_API_KEY=your-api-key \
  -- npx -y @prosperkartik/hostaway-mcp

(또는 --scope local을 사용하여 현재 프로젝트에만 설치하세요.)

3. 또는 Claude Desktop에 추가

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 파일을 편집하고 다음을 추가하세요:

{
  "mcpServers": {
    "hostaway": {
      "command": "npx",
      "args": ["-y", "@prosperkartik/hostaway-mcp"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "your-account-id",
        "HOSTAWAY_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop을 다시 시작하세요. 도구 선택기에 Hostaway 도구가 나타납니다.

4. 사용해 보기

Claude에게 다음과 같이 질문해 보세요:

• "whoami를 실행하여 Hostaway가 연결되었는지 확인해 줘."

• "내 Hostaway 숙소 목록을 보여줘."

• "다음 주에 체크인하는 예약은 무엇인가요?"

• "숙소 12345가 5월 10일에서 17일 사이에 예약 가능한가요?"

• "읽지 않은 게스트 메시지가 있나요?"

• "[게스트 이름]과의 대화를 보여줘."

출력 예시 (자리 표시자 데이터)

> List my Hostaway listings.

Found 3 listings:

| ID    | Name              | Location          | Beds | Baths | Capacity | Status |
|-------|-------------------|-------------------|------|-------|----------|--------|
| 10001 | Sample Apt 2BR    | Sample City, US   | 2    | 2     | 4        | active |
| 10002 | Sample Loft       | Sample City, US   | 1    | 1     | 2        | active |
| 10003 | Sample Beachfront | Sample Beach, US  | 3    | 2     | 6        | active |

> Is listing 10001 available May 10–17?

# Calendar for listing 10001
8 days returned (2026-05-10 → 2026-05-17)  ·  6 available, 2 reserved, 0 blocked

| Date       | Available | Status   | Price | Min stay | Reserved | Blocked | Note |
|------------|-----------|----------|-------|----------|----------|---------|------|
| 2026-05-10 | ✓         | available| 220   | 2        | 0        | 0       |      |
| 2026-05-11 | ✓         | available| 220   | 2        | 0        | 0       |      |
| 2026-05-12 | ✗         | reserved | 220   | 2        | 1        | 0       |      |
| ...                                                                            |

구성

서버는 시작 시 이를 베어러 토큰으로 교환하고 프로세스 수명 동안 메모리에 캐시합니다.

로컬 개발

git clone https://github.com/prosperkartik/hostaway-mcp.git
cd hostaway-mcp
npm install
cp .env.example .env  # fill in credentials
npm run build
npm start

tsx를 통한 핫 리로드:

npm run dev

로드맵

• [x] v0.1 — 숙소, 예약, 달력, 대화, 재무 및 상태 확인을 아우르는 10가지 읽기 전용 도구

• [ ] v0.2 — 작업(list_tasks, get_task); 취소 정책; 사용자 지정 필드 읽기

• [ ] v0.3 — 게스트 결제 읽기; 웹훅 읽기

• [ ] v0.4+ — 명시적인 confirm: true 확인을 거치는 쓰기 작업(게스트 메시지 전송, 달력 블록 업데이트, 작업 생성)

요청 사항이 있으신가요? 이슈를 열거나 토론을 시작하세요.

보안

• 자격 증명은 환경 변수에만 존재하며 이 서버에 의해 디스크에 기록되지 않습니다.

• 베어러 토큰은 프로세스 메모리에만 존재하며 영구 저장되지 않습니다.

• v0.1은 전체적으로 읽기 전용이며, 이 코드베이스의 어떤 것도 Hostaway 데이터를 변경할 수 없습니다.

• 다중 숙소 운영자의 경우: Hostaway API는 제공한 자격 증명의 계정으로 범위가 지정된 데이터를 반환하므로 계정 간 액세스는 불가능합니다.

기여

이슈 및 PR을 환영합니다. 코드베이스는 작고 읽기 쉽습니다. src/index.ts부터 시작하세요.

라이선스

MIT — LICENSE를 참조하세요.

작성자

Kartik Vats (@prosperkartik) 제작 — Kodeit의 AI 엔지니어. PMS / OTA 통합 및 LLM 도구 분야에서 3년간의 프로덕션 작업 경험.

휴가용 임대 운영자나 호스피탈리티 기술 팀으로서 AI를 운영에 도입하는 데 도움이 필요하시면 kodeit.io를 통해 연락하거나 prosperkartik@gmail.com으로 이메일을 보내주세요.