Connect Lodgify to Claude

{
  "mcpServers": {
    "lodgify": {
      "command": "npx",
      "args": ["-y", "@mikerob/lodgify-mcp"],
      "env": {
        "LODGIFY_API_KEY": "your-lodgify-api-key"
      }
    }
  }
}

mkdir lodgify-mcp && cd lodgify-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.lodgify.com";
const API_KEY = process.env.LODGIFY_API_KEY;

if (!API_KEY) {
  console.error("Set LODGIFY_API_KEY first.");
  process.exit(1);
}

// Authenticated GET. The key rides in the X-ApiKey header on every request.
async function get(path, params = {}) {
  const url = new URL(`${API_BASE}${path}`);
  for (const [k, v] of Object.entries(params)) {
    if (v !== undefined && v !== null && v !== "") url.searchParams.set(k, String(v));
  }
  const res = await fetch(url, {
    headers: { "X-ApiKey": API_KEY, Accept: "application/json" },
  });
  if (!res.ok) throw new Error(`Lodgify ${res.status}: ${await res.text()}`);
  return res.json();
}

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

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

server.registerTool(
  "list_properties",
  {
    description: "List properties on the Lodgify account, paged, 50 per page max. Includes each property's rooms (room type ids are needed for rates).",
    inputSchema: {
      page: z.number().optional().describe("Page number, default 1"),
      size: z.number().optional().describe("Items per page, max 50"),
    },
  },
  async ({ page, size }) =>
    json(await get("/v2/properties", { page: page ?? 1, size: size ?? 50, includeCount: true }))
);

server.registerTool(
  "list_bookings",
  {
    description: "List bookings, paged. Filter by stay window: Upcoming, Current, Historic, or All.",
    inputSchema: {
      stayFilter: z.enum(["Upcoming", "Current", "Historic", "All"]).optional()
        .describe("Which bookings to include, default Upcoming"),
      updatedSince: z.string().optional().describe("Only bookings updated since this date-time"),
      page: z.number().optional().describe("Page number, default 1"),
      size: z.number().optional().describe("Items per page, default 50"),
    },
  },
  async ({ stayFilter, updatedSince, page, size }) =>
    json(await get("/v2/reservations/bookings", {
      stayFilter: stayFilter ?? "Upcoming",
      updatedSince,
      page: page ?? 1,
      size: size ?? 50,
      includeCount: true,
    }))
);

server.registerTool(
  "get_availability",
  {
    description: "Availability calendar for one property over a date range, with available-unit counts per period.",
    inputSchema: {
      propertyId: z.number().describe("Property id from list_properties"),
      start: z.string().describe("Start date, YYYY-MM-DD"),
      end: z.string().describe("End date, YYYY-MM-DD"),
    },
  },
  async ({ propertyId, start, end }) =>
    json(await get(`/v2/availability/${propertyId}`, { start, end }))
);

server.registerTool(
  "get_rates",
  {
    description: "Nightly rates calendar for a property and room type over a date range: price per day, min and max stay.",
    inputSchema: {
      houseId: z.number().describe("Property id from list_properties"),
      roomTypeId: z.number().describe("Room type id from the property's rooms array"),
      startDate: z.string().describe("Start date, YYYY-MM-DD"),
      endDate: z.string().describe("End date, YYYY-MM-DD"),
    },
  },
  async ({ houseId, roomTypeId, startDate, endDate }) =>
    json(await get("/v2/rates/calendar", { houseId, roomTypeId, startDate, endDate }))
);

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

{
  "mcpServers": {
    "lodgify": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/lodgify-mcp/index.js"],
      "env": {
        "LODGIFY_API_KEY": "your-lodgify-api-key"
      }
    }
  }
}

claude mcp add \
  --env LODGIFY_API_KEY=your-lodgify-api-key \
  --transport stdio lodgify \
  -- node /ABSOLUTE/PATH/TO/lodgify-mcp/index.js

Who checks in over the next 7 days? Group by property, note party size.

Show December's nightly rates for each property as a table.

Which Saturdays this month have a departure and an arrival at the
same unit? Those are my same-day turnovers.