This MCP server enables natural language based interactions with an Odoo ERP instance. It exposes capabilities to search, create, update, delete, and inspect Odoo records through AI-assisted prompts. The server authenticates to Odoo via an API key or username/password and returns data in a structured, hierarchically formatted response suitable for chat assistants. Use YOLO mode for quick testing against any Odoo installation, and wire the server into Claude, VS Code, Cursor, or other MCP clients as described in the installation guide. Typical workflows include asking for customer details, generating invoices, updating product data, or counting records that match specific criteria, all while the underlying model handles field selection and pagination for large datasets.

Prerequisites

• Python 3.10+ installed on your local machine
• Access to an Odoo instance (with MCP module installed for standard mode, or with XML-RPC enabled for YOLO testing)
• Optional: UV (Universal Viewer) installed on your local machine if you plan to run the server locally with uvx

Install UV (if not already installed)

• macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
• Windows: powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Install via MCP Settings (recommended)

1. Open your MCP settings and add the following server configuration:

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here"
      }
    }
  }
}

2. Save and restart MCP to apply the configuration.

Alternative installation methods

• Docker (no Python required): {"mcpServers": {"odoo": {"command": "docker", "args": ["run", "-i", "--rm", "-e", "ODOO_URL=http://host.docker.internal:8069", "-e", "ODOO_API_KEY=your-api-key-here", "ivnvxd/mcp-server-odoo"]}}}
• Using pip (global install):

  Install globally

  pip install mcp-server-odoo

  Then reference the command in MCP as: {"command": "mcp-server-odoo", "args": []}

• From source: git clone https://github.com/ivnvxd/mcp-server-odoo.git cd mcp-server-odoo pip install -e .

  Use the full path to the package in MCP configuration

Prerequisites recap

• Ensure ODOO_URL and ODOO_API_KEY are set in the environment where the MCP client will launch the server
• If not using API key, you can provide ODOO_USER and ODOO_PASSWORD for basic auth
• Optionally set ODOO_DB and ODOO_LOCALE to tailor responses

Tips and common issues:

• If you run into connection issues from Docker, use host.docker.internal (or equivalent) to reach your Odoo instance from inside the container.
• Ensure XML-RPC is enabled for YOLO mode testing if you’re not using the Odoo MCP module.
• When using Claude Desktop or Claude Code, ensure you supply ODOO_URL, ODOO_API_KEY (or ODOO_USER/ODOO_PASSWORD) and ODOO_DB in the respective UI fields or config files.
• For production setups, prefer the MCP module integration in Odoo and enforce API key authentication.
• Locale settings (ODOO_LOCALE) can influence the language of responses; set it to your preferred locale code (e.g., es_ES, fr_FR).
• If upgrading the server, re-check the env variables in your MCP configuration since changes may require a restart of the MCP client.