Odoo MCP Server (Hybrid)

A hybrid Model Context Protocol (MCP) server that enables AI assistants to interact with Odoo ERP systems. Supports both HTTP streaming (for web AI agents) and stdio (for local AI assistants) modes.

📺 Demo

stdio Mode Demo (Claude Desktop)

HTTP Mode Demo (AI Agents & Remote Access)

Example Output

🚀 Quick Start

HTTP Mode (AI Agents & Remote Access)

# Clone the repository
git clone https://github.com/vzeman/odoo-mcp-server.git
cd odoo-mcp-server

# Copy example and configure
cp docker-compose.example.yml docker-compose.yml
# Edit docker-compose.yml with your Odoo credentials

# Start with Docker Compose
docker-compose up -d

# Access the server
curl http://localhost:8000/health

stdio Mode (Claude Desktop)

Option 1: Install from PyPI (recommended)

# Install
pip install odoo-mcp-server

Option 2: Install from source

# Clone the repository
git clone https://github.com/vzeman/odoo-mcp-server.git
cd odoo-mcp-server

# Install in development mode
pip install -e .

Configure Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://your-instance.odoo.com",
        "ODOO_DB": "your-database",
        "ODOO_USERNAME": "your-email@example.com",
        "ODOO_API_KEY": "your-api-key"
      }
    }
  }
}

Local Development

# Clone the repository
git clone https://github.com/vzeman/odoo-mcp-server.git
cd odoo-mcp-server

# Install dependencies
pip install -e .

# Set environment variables
export ODOO_URL="https://your-instance.odoo.com"
export ODOO_DB="your-database"
export ODOO_USERNAME="your-email@example.com"
export ODOO_API_KEY="your-api-key"

# Run the HTTP server
python -m mcp_server_odoo.http_server

# Run the stdio server
python -m mcp_server_odoo

🌐 Remote Access with ngrok (AI Agent Integration)

This implementation allows you to expose your local MCP server to AI agents like Flowhunt, enabling remote automation of your Odoo business processes.

Why Use ngrok?

• Remote AI Access: AI agents can connect to your MCP server from anywhere
• Business Automation: Enable Flowhunt and other AI platforms to automate your Odoo workflows
• Secure Tunneling: ngrok provides secure HTTPS tunnels with authentication
• No Infrastructure: No need to deploy to cloud servers

Setup Instructions

1. Install ngrok

Download and Install:

# macOS (using Homebrew)
brew install ngrok

# Or download directly from https://ngrok.com/download

Sign up and get your authtoken:

1. Go to ngrok.com and create a free account
2. Get your authtoken from the dashboard
3. Configure ngrok:

ngrok config add-authtoken YOUR_AUTHTOKEN_HERE

2. Start Your MCP Server

# Start the MCP server with Docker
docker-compose up -d

# Verify it's running locally
curl http://localhost:8000/health

3. Create ngrok Tunnel

# Create a public tunnel to your local MCP server
ngrok http http://localhost:8080

# You'll see output like:
# Session Status                online
# Account                       your-email@example.com
# Version                       3.x.x
# Region                        United States (us)
# Latency                       -
# Web Interface                 http://127.0.0.1:4040
# Forwarding                    https://abc123.ngrok-free.app -> http://localhost:8000

Copy the HTTPS URL (e.g., https://abc123.ngrok-free.app) - this is your public MCP server endpoint.

4. Configure F

... View full README on GitHub