# hostaway-kit

Read-only Hostaway MCP: listings, calendar, inbox, reports. Fixtures, no key. By STYLABS.

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the package rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 1.0.1
- **Author:** io.github.stylabs
- **License:** Unknown
- **npm:** hostaway-kit
- **Source:** https://github.com/stylabs/hostaway-kit-mcp-skills
- **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport)

## Trust

60/100 (B), scored on the package rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 0 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-30T13:38:39.896Z
- **Version scanned:** 1.0.1
- **CVEs:** none found by OSV at scan time

## Tools

11 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `list_listings` — List Hostaway listings. Defaults to GET /v1/listings?specialStatus[]=active. Optional availabilityDateStart/End + availabilityGuestNumber filter the list the sa
- `get_listing` — Retrieve one listing via GET /v1/listings/{id}?includeResources=1. House rules, check-in hours (0–23), amenityId values, and photos are included. wifiPassword, 
- `get_calendar` — Retrieve listing calendar via GET /v1/listings/{id}/calendar?includeResources=1. Each day has status (available/blocked/reserved/pending), isAvailable, and pric
- `list_reservations` — List reservations via GET /v1/reservations. Read-only. doorCode / doorCodeVendor / doorCodeInstruction are stripped. Create reservation is not implemented.
- `list_conversations` — List inbox threads via GET /v1/conversations?includeResources=1. Nested Reservation objects are denylist-stripped.
- `list_messages` — List messages in a thread via GET /v1/conversations/{id}/messages. Read-only. There is no send tool.
- `inbox_triage` — Unanswered / SLA view Hostaway's inbox does not compute. A thread is unanswered when the latest message is incoming (or hasUnreadMessages with no later host rep
- `draft_reply` — Suggested reply grounded in THAT listing's fields, house rules, amenityId values, and calendar prices. Never invent rates (use calendar or say unknown). Never i
- `report_occupancy` — Occupancy and blocked holes computed from calendar reads. Occupancy = reserved nights / (reserved + available). Blocked holes are consecutive blocked/hardBlock 
- `report_inbox` — Unanswered thread counts by listing, computed from conversation reads. Not a Hostaway owner statement.
- `report_completeness` — Listing completeness from reads: missing photos, missing house rules, missing amenities (empty listingAmenities). Not a financial report.

## Install

**Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for.
**Cautions** (coverage gaps and advisories — never blocking)
- No publisher has proved control of this listing; it is indexed, not vouched for.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"hostaway-kit\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"hostaway-kit\"\n      ],\n      \"env\": {\n        \"HOSTAWAY_CLIENT_SECRET\": \"<YOUR_HOSTAWAY_CLIENT_SECRET>\"\n      }\n    }\n  }\n}"
```
**Credentials it will ask for** (names only — Forge never holds a value):
- `HOSTAWAY_CLIENT_SECRET` — Hostaway Client Secret (optional)
Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each <YOUR_NAME> in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one.
- This entry needs 1 credential (0 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset.

## Blast radius

Moderate blast radius — holds an oauth grant; runs on your machine.
- Floor 28, ceiling 28 (tier: moderate)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/hostaway-kit
- Install plan: https://forgeregistry.com/api/v1/packages/hostaway-kit/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/hostaway-kit
- HTML page: https://forgeregistry.com/registry/hostaway-kit
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.