Connect Mews to Claude

mkdir mews-mcp && cd mews-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";

// Demo: https://api.mews-demo.com | Production: https://api.mews.com
const PLATFORM = process.env.MEWS_PLATFORM_ADDRESS ?? "https://api.mews-demo.com";
const CLIENT_TOKEN = process.env.MEWS_CLIENT_TOKEN;
const ACCESS_TOKEN = process.env.MEWS_ACCESS_TOKEN;

if (!CLIENT_TOKEN || !ACCESS_TOKEN) {
  console.error("Set MEWS_CLIENT_TOKEN and MEWS_ACCESS_TOKEN first.");
  process.exit(1);
}

// Every Connector API call is a POST with the tokens in the body.
async function mews(operation, payload = {}) {
  const res = await fetch(`${PLATFORM}/api/connector/v1/${operation}`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      ClientToken: CLIENT_TOKEN,
      AccessToken: ACCESS_TOKEN,
      Client: "RapidEye Mews MCP 1.0.0",
      ...payload,
    }),
  });
  if (!res.ok) throw new Error(`Mews ${res.status}: ${await res.text()}`);
  return res.json();
}

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

// ISO interval helper: { StartUtc, EndUtc } from now to now + days.
function window(days) {
  const now = new Date();
  const end = new Date(now.getTime() + days * 86400000);
  return { StartUtc: now.toISOString(), EndUtc: end.toISOString() };
}

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

server.registerTool(
  "get_room_status",
  {
    description:
      "List all spaces (rooms) with their housekeeping state: Dirty, Clean, Inspected, OutOfService, or OutOfOrder. The backbone of any housekeeping question.",
    inputSchema: {},
  },
  async () =>
    json(await mews("resources/getAll", {
      Extent: { Resources: true },
      Limitation: { Count: 1000 },
    }))
);

server.registerTool(
  "list_reservations",
  {
    description:
      "List reservations active during a date window (default: the next 7 days). Returns status, scheduled start/end, assigned resource, and guest counts.",
    inputSchema: {
      days: z.number().optional().describe("Window length in days from now, default 7, max ~90"),
    },
  },
  async ({ days }) =>
    json(await mews("reservations/getAll/2023-06-06", {
      CollidingUtc: window(days ?? 7),
      Limitation: { Count: 1000 },
    }))
);

server.registerTool(
  "list_tasks",
  {
    description:
      "List operational tasks (housekeeping, maintenance, front office) created in a recent window (default: last 30 days, max 3 months per the API).",
    inputSchema: {
      days_back: z.number().optional().describe("How many days back to look, default 30, max 90"),
    },
  },
  async ({ days_back }) => {
    const d = Math.min(days_back ?? 30, 90);
    const now = new Date();
    return json(await mews("tasks/getAll", {
      CreatedUtc: {
        StartUtc: new Date(now.getTime() - d * 86400000).toISOString(),
        EndUtc: now.toISOString(),
      },
      Limitation: { Count: 1000 },
    }));
  }
);

server.registerTool(
  "list_departments",
  {
    description:
      "List the property's departments (housekeeping, maintenance, front office) so task DepartmentIds can be resolved to names.",
    inputSchema: {},
  },
  async () =>
    json(await mews("departments/getAll", { Limitation: { Count: 100 } }))
);

const transport = new StdioServerTransport();
await server.connect(transport);
console.error(`Mews MCP server running on stdio (${PLATFORM})`);

{
  "mcpServers": {
    "mews": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mews-mcp/index.js"],
      "env": {
        "MEWS_PLATFORM_ADDRESS": "https://api.mews-demo.com",
        "MEWS_CLIENT_TOKEN": "your-client-token",
        "MEWS_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

claude mcp add \
  --env MEWS_PLATFORM_ADDRESS=https://api.mews-demo.com \
  --env MEWS_CLIENT_TOKEN=your-client-token \
  --env MEWS_ACCESS_TOKEN=your-access-token \
  --transport stdio mews \
  -- node /ABSOLUTE/PATH/TO/mews-mcp/index.js

Pull room status and give me a housekeeping board: counts by state,
then list every Dirty room.

What reservations are active in the next 7 days? Estimate the
housekeeping load per day from the checkouts.

List tasks from the last 30 days, resolve their departments, and
tell me which department is busiest.