Connect Breezeway to Claude

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

#!/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 AUTH_URL = "https://api.breezeway.io/public/auth/v1/";
const API_BASE = "https://api.breezeway.io/public/inventory/v1";
const CLIENT_ID = process.env.BREEZEWAY_CLIENT_ID;
const CLIENT_SECRET = process.env.BREEZEWAY_CLIENT_SECRET;

if (!CLIENT_ID || !CLIENT_SECRET) {
  console.error("Set BREEZEWAY_CLIENT_ID and BREEZEWAY_CLIENT_SECRET first.");
  process.exit(1);
}

// Access tokens last 24h and the auth endpoint is limited to
// 1 req/min, so mint once and cache in memory.
let token = null;
let tokenBornAt = 0;

async function getToken() {
  const ageHours = (Date.now() - tokenBornAt) / 3600000;
  if (token && ageHours < 23) return token;
  const res = await fetch(AUTH_URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      client_id: CLIENT_ID,
      client_secret: CLIENT_SECRET,
    }),
  });
  if (!res.ok) throw new Error(`Breezeway auth failed (${res.status})`);
  token = (await res.json()).access_token;
  tokenBornAt = Date.now();
  return token;
}

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.append(k, String(v));
    }
  }
  const res = await fetch(url, {
    headers: { Authorization: `JWT ${await getToken()}` },
  });
  if (!res.ok) throw new Error(`Breezeway ${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: "breezeway", version: "1.0.0" });

server.registerTool(
  "list_properties",
  {
    description:
      "List properties in the Breezeway account. Returns Breezeway home ids needed by list_tasks. Use this first.",
    inputSchema: {
      limit: z.number().optional().describe("Max rows per page, default 100"),
      page: z.number().optional().describe("Page number, default 1"),
    },
  },
  async ({ limit, page }) => json(await get("/property", { limit, page }))
);

server.registerTool(
  "list_tasks",
  {
    description:
      "List tasks for ONE property (Breezeway requires a property id per call). Filter by department or scheduled date. Loop over properties for portfolio-wide questions.",
    inputSchema: {
      home_id: z.number().describe("Breezeway property id (from list_properties)"),
      type_department: z
        .enum(["maintenance", "housekeeping", "inspection", "safety"])
        .optional()
        .describe("Filter to one department"),
      scheduled_date: z
        .string()
        .optional()
        .describe("Scheduled date filter, YYYY-MM-DD"),
      limit: z.number().optional().describe("Max rows per page, default 100"),
      page: z.number().optional().describe("Page number, default 1"),
    },
  },
  async ({ home_id, type_department, scheduled_date, limit, page }) =>
    json(
      await get("/task/", { home_id, type_department, scheduled_date, limit, page })
    )
);

server.registerTool(
  "get_task",
  {
    description:
      "Retrieve one task in full: assignments, status, times, total_time, costs, supplies, tags, photos, and the task report URL.",
    inputSchema: { task_id: z.number().describe("Breezeway task id") },
  },
  async ({ task_id }) => json(await get(`/task/${task_id}`))
);

server.registerTool(
  "list_reservations",
  {
    description:
      "List reservations, optionally for one property or within a check-in date window.",
    inputSchema: {
      property_id: z.number().optional().describe("Breezeway property id"),
      checkin_date_ge: z.string().optional().describe("Check-in on/after, YYYY-MM-DD"),
      checkin_date_le: z.string().optional().describe("Check-in on/before, YYYY-MM-DD"),
      limit: z.number().optional().describe("Max rows per page, default 100"),
      page: z.number().optional().describe("Page number, default 1"),
    },
  },
  async ({ property_id, checkin_date_ge, checkin_date_le, limit, page }) =>
    json(
      await get("/reservation", {
        property_id,
        checkin_date_ge,
        checkin_date_le,
        limit,
        page,
      })
    )
);

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

{
  "mcpServers": {
    "breezeway": {
      "command": "node",
      "args": ["/absolute/path/to/breezeway-mcp/index.js"],
      "env": {
        "BREEZEWAY_CLIENT_ID": "your_client_id",
        "BREEZEWAY_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

claude mcp add breezeway \
  --env BREEZEWAY_CLIENT_ID=your_client_id \
  --env BREEZEWAY_CLIENT_SECRET=your_client_secret \
  -- node /absolute/path/to/breezeway-mcp/index.js