Read-only Hostaway MCP: listings, calendar, inbox, reports. Fixtures, no key. By STYLABS.
MCPpedia last refreshed this data
io.github.stylabs/hostaway-kit is an MCP server that read-only Hostaway MCP: listings, calendar, inbox, reports. Fixtures, no key. By STYLABS. Its tool list has not been published yet over stdio and http, requires no API key, and scores 85/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"hostaway": {
"env": {
"HOSTAWAY_ACCOUNT_ID": "your-account-id",
"HOSTAWAY_CLIENT_SECRET": "your-client-secret"
},
"args": [
"-y",
"hostaway-kit"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Read-only Hostaway MCP: listings, calendar, inbox, reports. Fixtures, no key. By STYLABS.
This server supports HTTP transport. Be the first to test it - help the community know if it works.
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked hostaway-kit against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in communication
Official TypeScript library for the Telnyx API
Open-source SMS gateway. Turn your Android phone into an SMS API: send and receive SMS from your apps over REST and webhooks. Self-hostable, with a free hosted plan.
Send email and newsletters with Mailtea over MCP, plus skills for email and website design.
CVSS scoring, IOC extraction, email header triage, hash/JWT/timestamp decoding, CISA KEV lookup.
MCP Security Weekly
Get CVE alerts and security updates for io.github.stylabs/hostaway-kit and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Read-only MCP server plus Cursor / Claude Code / Codex skills for operators who already run Hostaway as their PMS.
Ask an assistant about listings, calendar, inbox, and simple reports. Hostaway stays the system of record. This kit never writes — no messages, no calendar blocks, no reservations.
Shipped by STYLABS, an AI-native venture studio that builds custom Hostaway booking sites and operator dashboards. STYLABS is not an official Hostaway partner.
list_listings, get_listing, get_calendar, list_reservations, list_conversations, list_messages, plus inbox triage, draft reply, and reports.wifiPassword, wifiUsername, doorSecurityCode, doorCode, doorCodeVendor, doorCodeInstruction, and all invoicing* contact fields.Mapped to the Hostaway Public API:
| Kit behaviour | Hostaway |
|---|---|
| Active listings | GET /v1/listings?specialStatus[]=active |
| One listing | GET /v1/listings/{id}?includeResources=1 |
| Calendar | GET /v1/listings/{id}/calendar?includeResources=1 |
| Stay search on the list | availabilityDateStart, availabilityDateEnd, availabilityGuestNumber |
| Check-in / check-out | integers 0–23 (checkInTimeStart, checkInTimeEnd, checkOutTime) |
| Amenities | amenityId integers, not free-text names (GET /v1/amenities resolves names) |
| Inbox | GET /v1/conversations, GET /v1/conversations/{id}/messages |
| Create reservation / send message | out |
If HOSTAWAY_ACCOUNT_ID or HOSTAWAY_CLIENT_SECRET is unset, the server serves bundled fixtures so npx still demos.
npx -y hostaway-kit
Or from this repo:
npm install
npm run build
node dist/index.js
stdio only. Logs go to stderr. Credentials are optional.
| Variable | Required | Purpose |
|---|---|---|
HOSTAWAY_ACCOUNT_ID | for live reads | Hostaway account id (client_id on POST /v1/accessTokens) |
HOSTAWAY_CLIENT_SECRET | for live reads | Client secret from the Hostaway dashboard |
HOSTAWAY_KIT_NOW | no | ISO timestamp that pins "now" for SLA math (used by tests) |
Get an API client secret from the Hostaway dashboard. This kit does not ship or use a Hostaway account.
Add to ~/.cursor/mcp.json (or project .cursor/mcp.json):
{
"mcpServers": {
"hostaway": {
"command": "npx",
"args": ["-y", "hostaway-kit"],
"env": {
"HOSTAWAY_ACCOUNT_ID": "your-account-id",
"HOSTAWAY_CLIENT_SECRET": "your-client-secret"
}
}
}
}
Leave both env values empty, or omit env, to run the fixture demo.
Copy the skills from this repo into Cursor:
cp -R skills/* ~/.cursor/skills/
Add to ~/.claude.json (or project .mcp.json):
{
"mcpServers": {
"hostaway": {
"command": "npx",
"args": ["-y", "hostaway-kit"],
"env": {
"HOSTAWAY_ACCOUNT_ID": "your-account-id",
"HOSTAWAY_CLIENT_SECRET": "your-client-secret"
}
}
}
}
Skills:
mkdir -p .claude/skills
cp -R skills/* .claude/skills/
~/.codex/config.toml:
[mcp_servers.hostaway]
c
... [View full README on GitHub](https://github.com/stylabs/hostaway-kit-mcp-skills#readme)