README.md
A Model Context Protocol (MCP) server for the Lodgify vacation rental API.
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_KEYenvironment variable is set. - Getting
spawn uvx ENOENT? Installuvfrom 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.
Tools (7)
get_propertiesRetrieves a list of all properties managed in the Lodgify account.get_property_by_idRetrieves detailed information for a specific property by its ID.get_bookingsRetrieves a list of bookings.get_booking_by_idRetrieves details for a specific booking by its ID.create_bookingCreates a new booking in the system.update_booking_statusUpdates the status of an existing booking.get_calendarRetrieves calendar availability and data.Environment Variables
LODGIFY_API_KEYrequiredThe API key required to authenticate with the Lodgify service.Configuration
claude_desktop_config.json
{"mcpServers": {"lodgify": {"command": "uvx", "args": ["lodgify-mcp-server"], "env": {"LODGIFY_API_KEY": "your_api_key"}}}}Try it
→List all my current vacation rental properties and their IDs.
→Show me all upcoming bookings for the next 30 days.
→Check the availability calendar for my property with ID 12345.
→Update the status of booking 98765 to confirmed.