Connect OwnerRez to Claude

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

{
  "name": "ownerrez-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 EMAIL = process.env.OWNERREZ_EMAIL;
const TOKEN = process.env.OWNERREZ_TOKEN;
const BASE_URL = "https://api.ownerrez.com/v2";

if (!EMAIL || !TOKEN) {
  console.error("Missing OWNERREZ_EMAIL or OWNERREZ_TOKEN environment variables");
  process.exit(1);
}

const authHeader =
  "Basic " + Buffer.from(`${EMAIL}:${TOKEN}`).toString("base64");

async function ownerrezGet(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: authHeader,
      Accept: "application/json",
      "User-Agent": "rapideye-ownerrez-mcp/1.0",
    },
  });

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

  return response.json();
}

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

// Tool 1: List bookings
server.tool(
  "list-bookings",
  "List OwnerRez bookings modified since a given date. Defaults to bookings modified in the last 30 days. Use for questions about upcoming arrivals, recent bookings, or activity on specific properties.",
  {
    since_utc: z
      .string()
      .optional()
      .describe(
        "ISO 8601 UTC timestamp (e.g. 2026-04-01T00:00:00Z). Returns bookings modified since this date. Defaults to 30 days ago."
      ),
    property_ids: z
      .string()
      .optional()
      .describe(
        "Comma-separated OwnerRez property IDs to filter by. Omit to query across all properties."
      ),
    include_charges: z
      .boolean()
      .optional()
      .describe("Include charge line items in the response."),
    include_guest: z
      .boolean()
      .optional()
      .describe("Include guest contact details."),
  },
  async ({ since_utc, property_ids, include_charges, include_guest }) => {
    const defaultSince = new Date(
      Date.now() - 30 * 24 * 60 * 60 * 1000
    ).toISOString();
    const data = await ownerrezGet("/bookings", {
      since_utc: since_utc || defaultSince,
      property_ids,
      include_charges,
      include_guest,
    });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 2: List properties
server.tool(
  "list-properties",
  "List all OwnerRez properties (rental listings) on the account. Returns property ID, name, address, bedroom/bathroom count, and active status.",
  {},
  async () => {
    const data = await ownerrezGet("/properties");
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 3: Get a single booking
server.tool(
  "get-booking",
  "Fetch a single OwnerRez booking by ID. Returns full booking details including guest, charges, dates, and notes.",
  {
    id: z.number().describe("Booking ID"),
  },
  async ({ id }) => {
    const data = await ownerrezGet(`/bookings/${id}`);
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 4: Search guests
server.tool(
  "search-guests",
  "Search OwnerRez guests by name or email. Returns matching guest records with contact details.",
  {
    q: z.string().describe("Search query (name or email substring)"),
  },
  async ({ q }) => {
    const data = await ownerrezGet("/guests", { q });
    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": {
    "ownerrez": {
      "command": "node",
      "args": ["/absolute/path/to/ownerrez-mcp/index.js"],
      "env": {
        "OWNERREZ_EMAIL": "your-email@example.com",
        "OWNERREZ_TOKEN": "pt_your_personal_access_token_here"
      }
    }
  }
}