lodgify

This MCP server provides access to Lodgify vacation rental data through a set of tools organized by domain. The Properties tools let you retrieve property listings and details, the Bookings tools give you access to your reservations and the ability to create or update bookings, and the Calendar tool allows you to fetch availability and calendar data. You can use the available methods to integrate Lodgify information into your workflows, automations, or other systems that rely on model-context protocols.

To use the server, ensure you have a valid Lodgify API key and run the server with the configured command. Once running, the server exposes the tools listed under each domain (Properties, Bookings, Calendar). You can query properties with get_properties or get_property_by_id, manage bookings with get_bookings, get_booking_by_id, create_booking, or update_booking_status, and fetch calendar data with get_calendar. The tooling is designed to be consumed by MCP clients (such as Claude Desktop) that can issue structured requests to these endpoints and interpret the responses in a consistent model-context format.

Prerequisites:

• Python 3.8+ and pip
• Access to Lodgify API via an API key (LODGIFY_API_KEY)
• uv/uvx tooling (as described below)

Install and run (from source):

1. Clone the repository: git clone https://github.com/fast-transients/lodgify-mcp-server.git cd lodgify-mcp-server
2. Install Python dependencies (adjust if a requirements file exists): python -m pip install --upgrade pip pip install -r requirements.txt # if a requirements file is present
3. Set your Lodgify API key in your environment: export LODGIFY_API_KEY=your_api_key
4. Install and run uv/uvx (per the Quick Start):
   • Install uv from https://astral.sh/uv/ and follow their setup
   • Start the server: uvx lodgify-mcp-server

Running from source in development:

1. Clone the repo and navigate to the project directory
2. Set the API key as shown above
3. Run the server with the provided entrypoint, for example: uv sync export LODGIFY_API_KEY=your_api_key uv run python entrypoint.py

Tips and caveats:

• Always set the LODGIFY_API_KEY environment variable before starting the server.
• If you encounter spawn uvx ENOENT, install uv from astral.sh/uv and restart your shell.
• The Claude Desktop integration example shows a ready-to-use configuration payload; you can adapt the mcpServers block to your environment.
• After syncing dependencies, consider running pip-audit to check for vulnerabilities; the project notes that starlette 0.47.0 is pinned for security advisories.
• If you modify dependencies, re-run dependency installation and verify that the environment variables (like API keys) remain correctly configured.