{
  "markdown": "# hostaway-mcp\n\nRead-only, hospitality-shaped MCP server for Hostaway.\n\nThis repo owns the operator product only: local/npm `stdio`, six read-only\ntools, no Cloudflare Worker, and no Seascape booking surface.\n\n## V1 Goal\n\nMake Codex and Claude useful in real Hostaway workflows without hand-wiring raw API\ncalls every time.\n\nV1 is intentionally narrow:\n- read-only only\n- hospitality-native tools, not raw endpoint parity\n- optimized for conversation context, reservation lookup, and listing lookup\n\n## Exact V1 Surface\n\n- `list_unread_guest_threads`\n- `get_conversation_context`\n- `get_reservation_brief`\n- `get_listing_brief`\n- `search_reservations`\n- `search_conversations`\n\n## Local Development\n\n```bash\nnpm install\nnpm test\nnpm run check\nnpm run build\n```\n\nRun the stdio server locally:\n\n```bash\nHOSTAWAY_API_TOKEN=your-token-here node dist/cli.js\n```\n\nCreate a local npm package tarball:\n\n```bash\nnpm pack\n```\n\nAfter publish, run without cloning:\n\n```bash\nnpx hostaway-mcp\n```\n\n## MCP Client Wiring\n\nFor local MCP clients, provide `HOSTAWAY_API_TOKEN` through the environment and\nspawn the published npm package over stdio.\n\nThe snippets below are pinned to the current published version:\n\n```text\nhostaway-mcp@0.2.0\n```\n\nUpdate that version intentionally when you upgrade.\n\n### Claude Desktop (macOS)\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`.\n\nIf you already have top-level keys like `preferences`, keep them and add\n`mcpServers` alongside them:\n\n```json\n{\n  \"mcpServers\": {\n    \"hostaway\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"hostaway-mcp@0.2.0\"],\n      \"env\": {\n        \"HOSTAWAY_API_TOKEN\": \"your-token-here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving the file.\n\n### Codex\n\nEdit `~/.codex/config.toml` and add:\n\n```toml\n[mcp_servers.hostaway]\ncommand = \"npx\"\nargs = [\"-y\", \"hostaway-mcp@0.2.0\"]\n\n[mcp_servers.hostaway.env]\nHOSTAWAY_API_TOKEN = \"your-token-here\"\n```\n\nVerify the server is registered:\n\n```bash\ncodex mcp list\n```\n\n### Local Built CLI\n\nIf you want to run the repo checkout instead of npm, point the client at the built\nCLI directly:\n\n```json\n{\n  \"command\": \"node\",\n  \"args\": [\"/absolute/path/to/hostaway-mcp/dist/cli.js\"],\n  \"env\": {\n    \"HOSTAWAY_API_TOKEN\": \"your-token-here\"\n  }\n}\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `HOSTAWAY_API_TOKEN` | Yes | — | Hostaway API token used to authenticate all requests. |\n| `HOSTAWAY_BASE_URL` | No | Hostaway production URL | Override the API base URL (useful for testing). |\n\n## V1 Non-Goals\n\n- sending guest messages\n- mutating reservations or listings\n- Cloudflare Worker transport\n- Seascape booking/distribution flows\n- webhook ingestion\n- background sync pipelines\n- dashboards or owner reporting\n- generic REST-to-MCP proxy coverage\n\n## Source Design\n\nSee [`docs/designs/v1-readonly-hostaway-mcp.md`](./docs/designs/v1-readonly-hostaway-mcp.md).\n",
  "bytes": 2939,
  "sha": "8f86a9a423a6db45ce7f4d99b993ce457d02d05108b7db7bfa7e8e3899f7e363",
  "repo_slug": "uncfreak1255-code/hostaway-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_uncfreak1255_code_hostaway_cee4c0bb/readme"
}