Connect iGMS to Claude

https://igms.com/app/auth.html?client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost:8899/callback&scope=messaging,tasks

curl "https://igms.com/auth/token?grant_type=authorization_code&code=AUTH_CODE&redirect_uri=http://localhost:8899/callback&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

mkdir igms-mcp && cd igms-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://www.igms.com/api/v1";
const TOKEN = process.env.IGMS_ACCESS_TOKEN;

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

// Authenticated GET. iGMS takes the token as a query string parameter.
async function get(path, params = {}) {
  const url = new URL(`${API_BASE}${path}`);
  for (const [key, value] of Object.entries(params)) {
    if (value !== undefined && value !== null && value !== "") {
      url.searchParams.set(key, String(value));
    }
  }
  url.searchParams.set("access_token", TOKEN);
  const res = await fetch(url, { headers: { Accept: "application/json" } });
  if (!res.ok) throw new Error(`iGMS ${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: "igms", version: "1.0.0" });

server.registerTool(
  "list_listings",
  {
    description: "List the listings managed in iGMS, with property, platform, status, and host. Responses are paginated; meta.has_next_page tells you whether to fetch the next page.",
    inputSchema: {
      platform_type: z.string().optional().describe("Comma separated platform types, e.g. airbnb"),
      page: z.number().optional().describe("Page number, default 1"),
    },
  },
  async ({ platform_type, page }) => json(await get("/listings", { platform_type, page }))
);

server.registerTool(
  "list_bookings",
  {
    description: "List active bookings with check-in/check-out, guest count, status, and a price breakdown (base, extras, fee, tax, total). Filter by date range to keep responses small.",
    inputSchema: {
      from_date: z.string().optional().describe("Hide bookings ended before this date, YYYY-MM-DD"),
      to_date: z.string().optional().describe("Hide bookings starting after this date, YYYY-MM-DD"),
      booking_status: z.string().optional().describe("Booking status filter, e.g. accepted"),
      platform_type: z.string().optional().describe("Comma separated platform types"),
      page: z.number().optional().describe("Page number, default 1"),
    },
  },
  async ({ from_date, to_date, booking_status, platform_type, page }) =>
    json(await get("/bookings", { from_date, to_date, booking_status, platform_type, page }))
);

server.registerTool(
  "list_guests",
  {
    description: "List guests with name, platform, emails, and phone numbers. Cross-reference guest_uid with bookings to find repeat guests.",
    inputSchema: {
      guest_uids: z.string().optional().describe("Comma separated guest UIDs to look up"),
      page: z.number().optional().describe("Page number, default 1"),
    },
  },
  async ({ guest_uids, page }) => json(await get("/guests", { guest_uids, page }))
);

server.registerTool(
  "list_tasks",
  {
    description: "List active tasks (cleaning, turnover, maintenance) with property, assigned team member, type, status, and local start/end times.",
    inputSchema: {
      property_uids: z.string().optional().describe("Comma separated property UIDs"),
      from_date: z.string().optional().describe("Hide tasks started before this date, YYYY-MM-DD"),
      to_date: z.string().optional().describe("Hide tasks starting after this date, YYYY-MM-DD"),
      page: z.number().optional().describe("Page number, default 1"),
    },
  },
  async ({ property_uids, from_date, to_date, page }) =>
    json(await get("/tasks", { property_uids, from_date, to_date, page }))
);

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

{
  "mcpServers": {
    "igms": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/igms-mcp/index.js"],
      "env": {
        "IGMS_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

claude mcp add \
  --env IGMS_ACCESS_TOKEN=your-access-token \
  --transport stdio igms \
  -- node /ABSOLUTE/PATH/TO/igms-mcp/index.js