Connect Cloudbeds to Claude

mkdir cloudbeds-mcp && cd cloudbeds-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.cloudbeds.com/api/v1.3";
const API_KEY = process.env.CLOUDBEDS_API_KEY;

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

// Cloudbeds API keys are long-lived (no expiry while used monthly),
// so auth is a single header on every request. No token dance.
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-api-key": API_KEY, Accept: "application/json" },
  });
  if (!res.ok) throw new Error(`Cloudbeds ${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: "cloudbeds", version: "1.0.0" });

server.registerTool(
  "get_reservations",
  {
    description: "List reservations. Filter by status and/or check-in date range. Statuses: not_confirmed, confirmed, canceled, checked_in, checked_out, no_show.",
    inputSchema: {
      propertyID: z.string().optional().describe("Property ID(s), comma-separated, for multi-property accounts"),
      status: z.string().optional().describe("Reservation status filter"),
      checkInFrom: z.string().optional().describe("Earliest check-in, YYYY-MM-DD"),
      checkInTo: z.string().optional().describe("Latest check-in, YYYY-MM-DD"),
      resultsFrom: z.string().optional().describe("Earliest booking date, YYYY-MM-DD (for pickup/pace questions)"),
      pageNumber: z.number().optional().describe("Page, default 1"),
    },
  },
  async (args) => json(await get("/getReservations", args))
);

server.registerTool(
  "get_housekeeping_status",
  {
    description: "Get every room's live housekeeping state: condition (clean/dirty), occupancy, front desk status (check-in, check-out, stayover, turnover, unused), assigned housekeeper, and comments.",
    inputSchema: {
      propertyID: z.string().optional().describe("Property ID"),
      roomCondition: z.enum(["clean", "dirty"]).optional().describe("Filter by condition"),
      roomOccupied: z.boolean().optional().describe("Filter by occupancy"),
    },
  },
  async (args) => json(await get("/getHousekeepingStatus", args))
);

server.registerTool(
  "get_guest_list",
  {
    description: "Search guest records by name, email, or stay dates. Good for repeat-guest and arrival-prep questions.",
    inputSchema: {
      propertyIDs: z.string().optional().describe("Property ID(s), comma-separated"),
      guestLastName: z.string().optional().describe("Filter by last name"),
      guestEmail: z.string().optional().describe("Filter by email"),
      checkInFrom: z.string().optional().describe("Earliest check-in, YYYY-MM-DD"),
      checkInTo: z.string().optional().describe("Latest check-in, YYYY-MM-DD"),
      includeGuestInfo: z.boolean().optional().describe("Include extended guest details"),
      pageSize: z.number().optional().describe("Rows per page, max 100"),
    },
  },
  async (args) => json(await get("/getGuestList", args))
);

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

{
  "mcpServers": {
    "cloudbeds": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/cloudbeds-mcp/index.js"],
      "env": { "CLOUDBEDS_API_KEY": "cbat_your-key-here" }
    }
  }
}

claude mcp add \
  --env CLOUDBEDS_API_KEY=cbat_your-key-here \
  --transport stdio cloudbeds \
  -- node /ABSOLUTE/PATH/TO/cloudbeds-mcp/index.js

Who checks in tomorrow, and are any of their rooms still dirty? Cross-reference.

Show the current room board: condition, occupancy, and front desk status per room.

How many confirmed bookings did we take in the last 7 days vs the 7 before?