Lodgify MCP Server

A Model Context Protocol (MCP) server for the Lodgify vacation rental API. It exposes tools for managing properties, bookings and calendar data.

Quick start

Install dependencies with uv and run the server with uvx:

export LODGIFY_API_KEY=your_api_key
uvx lodgify-mcp-server

To run from source:

git clone https://github.com/fast-transients/lodgify-mcp-server.git
cd lodgify-mcp-server
uv sync
export LODGIFY_API_KEY=your_api_key
uv run python entrypoint.py

Claude Desktop configuration

Add this block to your Claude Desktop configuration (see examples in the examples/ folder):

{
  "mcpServers": {
    "lodgify": {
      "command": "uvx",
      "args": ["lodgify-mcp-server"],
      "env": {
        "LODGIFY_API_KEY": "your_api_key"
      }
    }
  }
}

Available tools

Properties: get_properties, get_property_by_id
Bookings: get_bookings, get_booking_by_id, create_booking, update_booking_status
Calendar: get_calendar

Troubleshooting

Ensure the LODGIFY_API_KEY environment variable is set.
Getting spawn uvx ENOENT? Install uv from astral.sh/uv and restart your shell.

Security

After syncing dependencies, run pip-audit to check for known vulnerabilities. The uv.lock file pins starlette 0.47.0 to address upstream advisories.

Contributing

See CONTRIBUTING.md for development setup and testing instructions.