Connect Track to Claude

mkdir track-mcp && cd track-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 DOMAIN = process.env.TRACK_DOMAIN;      // e.g. yourcompany.trackhs.com
const KEY = process.env.TRACK_API_KEY;
const SECRET = process.env.TRACK_API_SECRET;

if (!DOMAIN || !KEY || !SECRET) {
  console.error("Set TRACK_DOMAIN, TRACK_API_KEY and TRACK_API_SECRET first.");
  process.exit(1);
}

// Track uses HTTP Basic auth: API key as username, secret as password.
const AUTH = "Basic " + Buffer.from(`${KEY}:${SECRET}`).toString("base64");

async function get(path, params = {}) {
  const url = new URL(`https://${DOMAIN}/api/${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: { Authorization: AUTH, Accept: "application/json" },
  });
  if (!res.ok) throw new Error(`Track ${res.status}: ${await res.text()}`);
  return res.json();
}

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

const paging = {
  page: z.number().optional().describe("Page number, starts at 1"),
  size: z.number().optional().describe("Rows per page, e.g. 100"),
};

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

server.registerTool(
  "search_units",
  {
    description: "Search units in Track. Rows come back under _embedded.units.",
    inputSchema: {
      ...paging,
      search: z.string().optional().describe("Substring match on unit name or description"),
      isActive: z.number().optional().describe("1 for active units, 0 for inactive"),
      arrival: z.string().optional().describe("Availability window start, YYYY-MM-DD"),
      departure: z.string().optional().describe("Availability window end, YYYY-MM-DD"),
    },
  },
  async (args) => json(await get("pms/units", args))
);

server.registerTool(
  "search_reservations",
  {
    description:
      "Search reservations. Statuses: Hold, Confirmed, Checked In, Checked Out, Cancelled. Rows under _embedded.reservations.",
    inputSchema: {
      ...paging,
      status: z.string().optional().describe("Reservation status filter"),
      unitId: z.number().optional().describe("Filter to one unit"),
      arrivalStart: z.string().optional().describe("Earliest arrival, YYYY-MM-DD"),
      arrivalEnd: z.string().optional().describe("Latest arrival, YYYY-MM-DD"),
      departureStart: z.string().optional().describe("Earliest departure, YYYY-MM-DD"),
      departureEnd: z.string().optional().describe("Latest departure, YYYY-MM-DD"),
      updatedSince: z.string().optional().describe("Only rows updated since this ISO date"),
    },
  },
  async (args) => json(await get("pms/reservations", args))
);

server.registerTool(
  "housekeeping_work_orders",
  {
    description: "List housekeeping work orders (the turnover clean pipeline). Rows under _embedded.workOrders.",
    inputSchema: { ...paging },
  },
  async (args) => json(await get("pms/housekeeping/work-orders", args))
);

server.registerTool(
  "maintenance_work_orders",
  {
    description: "List maintenance work orders. Rows under _embedded.workOrders.",
    inputSchema: {
      ...paging,
      updatedSince: z.string().optional().describe("Only rows updated since this ISO date"),
    },
  },
  async (args) => json(await get("pms/maintenance/work-orders", args))
);

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

{
  "mcpServers": {
    "track": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/track-mcp/index.js"],
      "env": {
        "TRACK_DOMAIN": "yourcompany.trackhs.com",
        "TRACK_API_KEY": "your-server-api-key",
        "TRACK_API_SECRET": "your-server-api-secret"
      }
    }
  }
}

claude mcp add \
  --env TRACK_DOMAIN=yourcompany.trackhs.com \
  --env TRACK_API_KEY=your-server-api-key \
  --env TRACK_API_SECRET=your-server-api-secret \
  --transport stdio track \
  -- node /ABSOLUTE/PATH/TO/track-mcp/index.js

Which reservations arrive in the next 7 days? Group them by unit.

Pull maintenance work orders updated in the last 30 days and rank units
by how many they generated.

Compare Saturday's departures against housekeeping work orders and flag
any unit without one.