OHIP

You can deploy this Python MCP server to securely act as a universal gateway for Oracle Hospitality OHIP, enabling your AI assistants to perform OHIP API requests in a safe, authenticated way.

How to use

You will connect an MCP client to the OHIP MCP Server to access OHIP endpoints such as reservations, inventory, and housekeeping. The server exposes a single flexible tool called call_ohip_api that you can invoke with any OHIP endpoint. The server handles OAuth 2.0 token management automatically, storing tokens in memory and renewing them before they expire. Ensure your client can reach the MCP server and pass the appropriate environment credentials.

How to install

Prerequisites you need before installation include Python 3.10 or newer and a developer account for Oracle Hospitality (OHIP) with valid credentials. You should also have a command line tool for package management, such as uvx or pip.

1. Clone the repository and navigate into it.

git clone https://github.com/tu-usuario/ohip-mcp.git
cd ohip-mcp

2. Create and configure your environment file with your OHIP credentials.

cp .env.example .env

Edit the environment file to include your OHIP details.

OHIP_BASE_URL=https://<environment>.oraclecloud.com
OHIP_CLIENT_ID=your_client_id
OHIP_CLIENT_SECRET=your_client_secret
OHIP_APP_KEY=your_app_key

3. Install the required dependencies. You may use pip or uvx for faster startup.

# Using pip
pip install -r requirements.txt

# Or using uvx (faster)
uv sync

Configuration in MCP clients

The OHIP MCP Server can be configured in MCP clients to start the local server process and pass the required environment variables.

Claude Desktop example configuration (Windows) is shown here to illustrate how to launch the local MCP server using uv with the correct working directory and environment.

{
  "mcpServers": {
    "ohip": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:/Ruta/Absoluta/A/ohip-mcp",
        "python",
        "-m",
        "src.server"
      ],
      "env": {
        "OHIP_BASE_URL": "https://...",
        "OHIP_CLIENT_ID": "...",
        "OHIP_CLIENT_SECRET": "...",
        "OHIP_APP_KEY": "..."
      }
    }
  }
}

Additional configuration and startup options

Cursor / TRAE IDE example shows how to configure the MCP server as a project-level MCP entry starting the local server from a specific path.

{
  "mcpServers": {
    "ohip": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/Ruta/Absoluta/A/ohip-mcp",
      "env": { "DOTENV_PATH": "../.env" }
    }
  }
}

Usage notes and examples

After you connect, you can invoke the call_ohip_api tool to perform specific OHIP operations. For example, to retrieve reservations for a hotel, you would call the tool with the appropriate method and endpoint matching the OHIP API you intend to use. The server handles token retrieval, storage, and automatic renewal, so you do not need to manage tokens manually.

Project structure and data flow

The server is organized to separate authentication, the MCP server logic, and the tool surface. Key files include an OAuth manager that handles token lifecycle and a server module that exposes the call_ohip_api tool to the MCP ecosystem.

Security considerations

Credentials are managed securely using environment variables. Do not expose OHIP_CLIENT_ID, OHIP_CLIENT_SECRET, or OHIP_APP_KEY in public logs or shared configurations.

Available tools

call_ohip_api

Universal tool to call any OHIP API endpoint from the MCP server, supporting methods, endpoints, and query parameters and handling authentication automatically.