PeopleLikeUs MCP

MCP server for the PeopleLikeUs home-exchange platform — search homes, message members, manage your calendar and exchanges from your AI assistant.

Installation · Tools · Examples · Limitations · 🇫🇷 Français

Overview

This MCP server exposes PeopleLikeUs as 26 tools your assistant can call. Login is automatic from your email/password — no manual token extraction (no CAPTCHA, no Auth0). Ask in natural language:

You: Search homes in Portugal, then add availability on my property 40646 from July 4 to August 29.

Assistant: (calls plu_search_homes, then plu_add_availability) 12 homes in Portugal (Lisbon, Porto, Algarve…). Availability added on property 40646 for Jul 4 → Aug 29. ✅

Related MCP server: Hostaway MCP Server

Requirements

• Node.js ≥ 18

• A PeopleLikeUs account (Premium recommended)

• Any MCP client — Claude Code, Claude Desktop, Cursor…

Installation

git clone https://github.com/manganate006/peoplelikeus-mcp
cd peoplelikeus-mcp
npm install && npm run build

Claude Code

claude mcp add peoplelikeus \
  --env PLU_EMAIL=your@email.com \
  --env PLU_PASSWORD=yourpassword \
  -- node /absolute/path/to/peoplelikeus-mcp/dist/index.js

Claude Desktop / Cursor

Add to claude_desktop_config.json (or your client's MCP config):

{
  "mcpServers": {
    "peoplelikeus": {
      "command": "node",
      "args": ["/absolute/path/to/peoplelikeus-mcp/dist/index.js"],
      "env": {
        "PLU_EMAIL": "your@email.com",
        "PLU_PASSWORD": "yourpassword"
      }
    }
  }
}

Authentication

Set PLU_EMAIL + PLU_PASSWORD — the server handles login, CSRF and session automatically (cached at ~/.peoplelikeus-mcp-session.json, 1 h TTL). Alternatives (browser cookies via PLU_COOKIES, runtime plu_login), rate-limit tuning and the full auth priority: docs/TOOLS.md.

Tools

26 tools, plu_ prefix. Summary by domain — full parameters in docs/TOOLS.md.

Examples

• "Search for homes in Portugal"

• "Show my conversations"

• "Message user 12345 about property 67890: "Hello, we love your place…""

• "Add availability for my property 40646 from July 4 to August 29"

• "Show my exchanges, then cancel exchange 22076"

Limitations

• HTML parsing — some pages are Laravel Blade server-rendered; extraction depends on the HTML structure and can break if the site changes

• No image upload for property photos (multipart not implemented)

• Read-only listings — no property creation/editing

• Search uses country_long; location search needs coordinates (no server-side Google Places)

• Rate limiting — 1500 ms between requests by default (PLU_REQUEST_DELAY); auto retry/backoff on HTTP 429/503

Development

npm run dev     # tsc watch
npm run build   # compile TypeScript

Full tool reference, configuration and architecture: docs/TOOLS.md.

License

MIT