Lodgify MCP Server

by shanephall

255 downloads

Not rated

GitHub

Other

Description

# Lodgify MCP Server A Model Context Protocol (MCP) server for the Lodgify vacation rental API. Provides tools for managing properties, bookings, and calendar data. ## Quick Start ### Using with Claude Desktop (Recommended) 1. **Copy the example configuration:** ```bash # Copy…

About

Details

Author: shanephall
Downloads: 255
Categories: Other

- Tools for properties: get_properties, get_property_by_id
- Tools for bookings: get_bookings, get_booking_by_id, create_booking, update_booking_status
- Calendar tool: get_calendar
- Supports Docker and local Python runtimes
- Requires only a Lodgify API key for authentication
- Works as an MCP server for LLM interactions (e.g., Claude Desktop)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Lodgify MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

From the repository

Deploy via Docker (ghcr.io/shanephall/lodgify-mcp-server:latest) or local Python installation (Python 3.10+, uv sync). Set the LODGIFY_API_KEY environment variable. Run in server mode (--mode server) or test mode (--mode test). Integrate with Claude Desktop by adding a Docker or local command entry to claude_desktop_config.json.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "lodgify mcp server": {
            "lodgify-mcp-server": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/shanephall/lodgify-mcp-server:latest"
                ]
            }
        }
    }
}

McpServers

{
    "lodgify-mcp-server": {
        "command": "docker",
        "args": [
            "pull",
            "ghcr.io/shanephall/lodgify-mcp-server:latest"
        ]
    }
}

Lodgify MCP Server

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

Quick Start

Using with Claude Desktop (Recommended)

1. Copy the example configuration:

   # Copy the example file from this repository

   cp claude_desktop_config_example.json claude_desktop_config.json

2. Edit with your API key:
Replace your_lodgify_api_key_here with your actual Lodgify API key in the config file.

3. Add to Claude Desktop:
Merge the configuration into your Claude Desktop config file (see Claude Desktop Integration section below).

Manual Docker Usage

1. Get the Docker image:

   docker pull ghcr.io/shanephall/lodgify-mcp-server:latest

2. Test your API key:

   # Single line (works on all platforms)
   docker run --rm -e LODGIFY_API_KEY=your_api_key_here ghcr.io/shanephall/lodgify-mcp-server:latest --mode test
   
   # Multi-line for Linux/macOS/WSL
   docker run --rm -e LODGIFY_API_KEY=your_api_key_here \
     ghcr.io/shanephall/lodgify-mcp-server:latest --mode test
   
   # Multi-line for Windows PowerShell
   docker run --rm -e LODGIFY_API_KEY=your_api_key_here 
     ghcr.io/shanephall/lodgify-mcp-server:latest --mode test


3. Run the MCP server:
   # Single line (works on all platforms)
   docker run -d --name lodgify-mcp-server -e LODGIFY_API_KEY=your_api_key_here ghcr.io/shanephall/lodgify-mcp-server:latest --mode server
   
   # Multi-line for Linux/macOS/WSL
   docker run -d --name lodgify-mcp-server \
     -e LODGIFY_API_KEY=your_api_key_here \
     ghcr.io/shanephall/lodgify-mcp-server:latest --mode server
   
   # Multi-line for Windows PowerShell  
   docker run -d --name lodgify-mcp-server 
     -e LODGIFY_API_KEY=your_api_key_here 
     ghcr.io/shanephall/lodgify-mcp-server:latest --mode server
   
Using Docker Compose
1. Clone and setup:
   git clone https://github.com/shanephall/lodgify-mcp-server.git
   cd lodgify-mcp-server
   cp .env.example .env
   # Edit .env with your LODGIFY_API_KEY
   
2. Start the server:
   docker-compose up -d server
   
MCP Tools
The server provides these tools for LLM interactions:

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


Claude Desktop Integration

To use this MCP server with Claude Desktop, add it to your claude_desktop_config.json file:


Option 1: Docker (Recommended)
{
  "mcpServers": {
    "lodgify-api": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", 
        "-e", "LODGIFY_API_KEY=your_api_key_here",
        "ghcr.io/shanephall/lodgify-mcp-server:latest",
        "--mode", "server"
      ]
    }
  }
}

Option 2: Local Python Installation
First, clone and set up the repository:
git clone https://github.com/shanephall/lodgify-mcp-server.git
cd lodgify-mcp-server
uv sync

Then add to your Claude Desktop config:
{
  "mcpServers": {
    "lodgify-api": {
      "command": "python",
      "args": ["/path/to/lodgify-mcp-server/entrypoint.py", "--mode", "server"],
      "env": {
        "LODGIFY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Configuration File Locations

- Windows: %APPDATA%\Claude\claude_desktop_config.json- macOS:~/Library/Application Support/Claude/claude_desktop_config.json- Linux:~/.config/Claude/claude_desktop_config.json


Configuration
Set your Lodgify API key as an environment variable:
export LODGIFY_API_KEY=your_api_key_here

Local Development
Requirements: Python 3.10+, uv
git clone https://github.com/shanephall/lodgify-mcp-server.git
cd lodgify-mcp-server
uv sync
export LODGIFY_API_KEY=your_api_key_here
python lodgify_server.py

Troubleshooting
Common Issues
"API key is required for this mode" Error
This error typically occurs when the API key isn't being passed correctly to the Docker container.
Solution for Claude Desktop Docker config:

- ❌ Incorrect (doesn't work):

  
  {

    "command": "docker",

    "args": ["run", "-i", "--rm", "image-name", "--mode", "server"],

    "env": {

      "LODGIFY_API_KEY": "your_key"

    }

  }

  

- ✅ Correct (works):

  
  {

    "command": "docker", 

    "args": [

      "run", "-i", "--rm",

      "-e", "LODGIFY_API_KEY=your_key",

      "image-name", "--mode", "server"

    ]

  }

  

Testing Your Setup
Test your API key before using with Claude Desktop:

``bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Lodgify MCP Server

Quick Start

Using with Claude Desktop (Recommended)

Manual Docker Usage

Using Docker Compose

MCP Tools

Claude Desktop Integration

Option 1: Docker (Recommended)

Option 2: Local Python Installation

Configuration File Locations

Configuration

Local Development

Troubleshooting

Common Issues

"API key is required for this mode" Error

Testing Your Setup

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀