Connect Hostaway to Claude

mkdir hostaway-mcp && cd hostaway-mcp
npm init -y
npm pkg set type="module"
npm install @modelcontextprotocol/sdk zod

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const API_BASE = "https://api.hostaway.com/v1";
const ACCOUNT_ID = process.env.HOSTAWAY_ACCOUNT_ID;
const API_KEY = process.env.HOSTAWAY_API_KEY;

if (!ACCOUNT_ID || !API_KEY) {
  console.error("Set HOSTAWAY_ACCOUNT_ID and HOSTAWAY_API_KEY first.");
  process.exit(1);
}

// Tokens last ~24 months. Mint one on first use and keep it in memory.
let token = null;

async function getToken() {
  if (token) return token;
  const res = await fetch(`${API_BASE}/accessTokens`, {
    method: "POST",
    headers: { "Content-Type": "application/x-www-form-urlencoded" },
    body: new URLSearchParams({
      grant_type: "client_credentials",
      client_id: ACCOUNT_ID,
      client_secret: API_KEY,
      scope: "general",
    }),
  });
  if (!res.ok) throw new Error(`Token request failed (${res.status})`);
  token = (await res.json()).access_token;
  return token;
}

// Authenticated GET; unwraps Hostaway's { result: ... } envelope.
async function get(path) {
  const res = await fetch(`${API_BASE}${path}`, {
    headers: { Authorization: `Bearer ${await getToken()}` },
  });
  if (!res.ok) throw new Error(`Hostaway ${res.status}: ${await res.text()}`);
  return (await res.json()).result ?? null;
}

function json(data) {
  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
}

const server = new McpServer({ name: "hostaway", version: "1.0.0" });

server.registerTool(
  "list_listings",
  {
    description: "List the properties (listings) in the Hostaway account.",
    inputSchema: { limit: z.number().optional().describe("Max rows, default 100") },
  },
  async ({ limit }) => {
    const q = new URLSearchParams({ limit: String(limit ?? 100) });
    return json(await get(`/listings?${q}`));
  }
);

server.registerTool(
  "list_reservations",
  {
    description: "List reservations, optionally within an arrival date range.",
    inputSchema: {
      arrivalStartDate: z.string().optional().describe("Earliest arrival, YYYY-MM-DD"),
      arrivalEndDate: z.string().optional().describe("Latest arrival, YYYY-MM-DD"),
      limit: z.number().optional().describe("Max rows, default 100"),
    },
  },
  async ({ arrivalStartDate, arrivalEndDate, limit }) => {
    const q = new URLSearchParams({ limit: String(limit ?? 100) });
    if (arrivalStartDate) q.set("arrivalStartDate", arrivalStartDate);
    if (arrivalEndDate) q.set("arrivalEndDate", arrivalEndDate);
    return json(await get(`/reservations?${q}`));
  }
);

server.registerTool(
  "get_calendar",
  {
    description: "Get the availability calendar for one listing over a date range.",
    inputSchema: {
      listingId: z.number().describe("Hostaway listing id"),
      startDate: z.string().describe("YYYY-MM-DD"),
      endDate: z.string().describe("YYYY-MM-DD"),
    },
  },
  async ({ listingId, startDate, endDate }) => {
    const q = new URLSearchParams({ startDate, endDate });
    return json(await get(`/listings/${listingId}/calendar?${q}`));
  }
);

server.registerTool(
  "list_tasks",
  {
    description: "List tasks (cleaning, maintenance, inspections) from Hostaway.",
    inputSchema: { limit: z.number().optional().describe("Max rows, default 100") },
  },
  async ({ limit }) => {
    const q = new URLSearchParams({ limit: String(limit ?? 100) });
    return json(await get(`/tasks?${q}`));
  }
);

server.registerTool(
  "list_conversations",
  {
    description: "List recent guest conversations.",
    inputSchema: { limit: z.number().optional().describe("Max rows, default 100") },
  },
  async ({ limit }) => {
    const q = new URLSearchParams({ limit: String(limit ?? 100) });
    return json(await get(`/conversations?${q}`));
  }
);

server.registerTool(
  "get_messages",
  {
    description: "Read the messages in one guest conversation.",
    inputSchema: { conversationId: z.number().describe("Conversation id") },
  },
  async ({ conversationId }) => json(await get(`/conversations/${conversationId}/messages`))
);

const transport = new StdioServerTransport();
await server.connect(transport);
console.error("Hostaway MCP server running on stdio");

{
  "mcpServers": {
    "hostaway": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/hostaway-mcp/index.js"],
      "env": {
        "HOSTAWAY_ACCOUNT_ID": "your-account-id",
        "HOSTAWAY_API_KEY": "your-api-key"
      }
    }
  }
}

claude mcp add \
  --env HOSTAWAY_ACCOUNT_ID=your-account-id \
  --env HOSTAWAY_API_KEY=your-api-key \
  --transport stdio hostaway \
  -- node /ABSOLUTE/PATH/TO/hostaway-mcp/index.js

What reservations arrive in the next 7 days? Group them by listing.

Which of my listings has the most open nights this month?

Pull the open tasks and tell me which properties have more than one.