Connect Hospitable to Claude

mkdir hospitable-mcp
cd hospitable-mcp
npm init -y
npm install @modelcontextprotocol/sdk zod

{
  "name": "hospitable-mcp",
  "version": "1.0.0",
  "type": "module",
  "main": "index.js",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0",
    "zod": "^3.22.0"
  }
}

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const TOKEN = process.env.HOSPITABLE_TOKEN;
const BASE_URL = "https://public.api.hospitable.com/v2";

if (!TOKEN) {
  console.error("Missing HOSPITABLE_TOKEN environment variable");
  process.exit(1);
}

async function hospitableGet(path, params = {}) {
  const url = new URL(`${BASE_URL}${path}`);
  for (const [key, value] of Object.entries(params)) {
    if (value !== undefined && value !== null && value !== "") {
      url.searchParams.append(key, String(value));
    }
  }

  const response = await fetch(url.toString(), {
    method: "GET",
    headers: {
      Authorization: `Bearer ${TOKEN}`,
      Accept: "application/json",
      "User-Agent": "rapideye-hospitable-mcp/1.0",
    },
  });

  if (!response.ok) {
    const body = await response.text();
    throw new Error(`Hospitable API ${response.status}: ${body}`);
  }

  return response.json();
}

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

// Tool 1: List properties
server.tool(
  "list-properties",
  "List all properties on the Hospitable account. Returns property ID, name, address, bedroom/bathroom count, and status. Use this first to discover property IDs.",
  {
    page: z
      .number()
      .optional()
      .describe("Page number for pagination (default: 1)"),
    per_page: z
      .number()
      .optional()
      .describe("Results per page (default: 25, max: 100)"),
  },
  async ({ page, per_page }) => {
    const data = await hospitableGet("/properties", { page, per_page });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 2: List reservations with date filter and property include
server.tool(
  "list-reservations",
  "List reservations, optionally filtered by date range or property. Use include='property' to also return the associated property details in the response.",
  {
    start_date: z
      .string()
      .optional()
      .describe("Filter reservations with check-in on or after this date (YYYY-MM-DD)"),
    end_date: z
      .string()
      .optional()
      .describe("Filter reservations with check-in on or before this date (YYYY-MM-DD)"),
    property_id: z
      .string()
      .optional()
      .describe("Only return reservations for this property ID"),
    include: z
      .string()
      .optional()
      .describe("Comma-separated list of related resources to include (e.g. 'property,guest')"),
    page: z.number().optional(),
    per_page: z.number().optional(),
  },
  async ({ start_date, end_date, property_id, include, page, per_page }) => {
    const data = await hospitableGet("/reservations", {
      start_date,
      end_date,
      property_id,
      include,
      page,
      per_page,
    });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 3: Fetch one reservation
server.tool(
  "get-reservation",
  "Fetch a single reservation by ID. Returns full details including guest info, dates, nightly rate, and any notes.",
  {
    id: z.string().describe("Reservation ID"),
    include: z
      .string()
      .optional()
      .describe("Optional related resources to include (e.g. 'property,guest')"),
  },
  async ({ id, include }) => {
    const data = await hospitableGet(`/reservations/${id}`, { include });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 4: Property calendar
server.tool(
  "get-property-calendar",
  "Fetch the calendar (availability, pricing, min stay) for a specific property across a date range.",
  {
    property_id: z.string().describe("Hospitable property ID"),
    start_date: z.string().describe("Start date (YYYY-MM-DD)"),
    end_date: z.string().describe("End date (YYYY-MM-DD)"),
  },
  async ({ property_id, start_date, end_date }) => {
    const data = await hospitableGet(`/properties/${property_id}/calendar`, {
      start_date,
      end_date,
    });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hospitable": {
      "command": "node",
      "args": ["/absolute/path/to/hospitable-mcp/index.js"],
      "env": {
        "HOSPITABLE_TOKEN": "your_personal_access_token_here"
      }
    }
  }
}