MCP Server for Odoo

The MCP Server for Odoo is a Model Context Protocol (MCP) server that allows AI assistants (like Claude) to interact with Odoo ERP systems. It enables natural language interaction for tasks such as searching records, creating/updating/deleting data, inspecting model fields, and performing server-side aggregations.

It supports two primary modes of operation:

• Standard mode (Production): Requires Odoo version 16.0+ with the Odoo MCP module installed for enterprise security and access controls.
• YOLO mode (Testing/Demos): Works with any Odoo version that has XML-RPC enabled; no additional module is required.

The server supports two transport modes:

1. stdio (Default): Best for desktop AI applications like Claude Desktop. No extra configuration is needed.
2. streamable-http: Best for REST API-style access and remote connectivity.

⚠️ Security Warning for HTTP: The streamable-http transport has no built-in client authentication. Anyone who can reach the port can use the server's Odoo credentials. It is highly recommended to bind to localhost and use an authenticating reverse proxy (like Nginx with basic auth) for remote access.

# Run with HTTP transport (localhost only)
uvx mcp-server-odoo --transport streamable-http --port 8000

# Run with HTTP transport bound to all interfaces (Exposes to network - USE CAUTION)
uvx mcp-server-odoo --transport streamable-http --host 0.0.0.0 --port 8000

When the fields parameter is omitted or set to null, the server uses a scoring algorithm to select relevant fields, optimizing for LLM context and performance.

Selection Logic:

• Included: Essential fields (id, name, display_name, active) and business-relevant fields (state, amount, email, etc.).
• Excluded: Technical fields (message threads, activity tracking), expensive fields (binary, HTML, large text), and computed non-stored fields.
• Credential Protection: Fields matching patterns like *password, *_pass, *secret, *_token, *apikey, or *_key are excluded from smart defaults and from ["__all__"] reads. You must request these explicitly by name to retrieve them.

Configuration:

• Adjust the default limit (15 fields) using ODOO_MCP_MAX_SMART_FIELDS.

For Claude Code, you can either add the configuration to a .mcp.json file in your project root or use the CLI to add it automatically.

# Using CLI
claude mcp add odoo \
  --env ODOO_URL=https://your-odoo-instance.com \
  --env ODOO_API_KEY=your-api-key-here \
  --env ODOO_DB=your-database-name \
  -- uvx mcp-server-odoo

# Or via .mcp.json
{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

To use the server with full security and model-level permissions, follow these steps in your Odoo instance:

1. Install the MCP module: Download the mcp_server module from the Odoo App Store and install it. Navigate to Settings > MCP Server to verify.
2. Enable models: Go to Settings > MCP Server > Enabled Models. Add the models you want to expose (e.g., res.partner, product.product) and configure permissions (read, write, create, delete).
3. Generate an API key: Go to Settings > Users & Companies > Users, select your user, go to the API Keys tab, and create a new key. Copy this key for your MCP configuration.

Add the following configuration to .vscode/mcp.json in your workspace.

Note: VS Code requires the root key to be "servers" instead of "mcpServers".

{
  "servers": {
    "odoo": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_API_KEY": "your-api-key-here",
        "ODOO_DB": "your-database-name"
      }
    }
  }
}

The MCP server runs on your local computer (where your AI client is installed). It is highly recommended to use uv to manage the server execution.

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

After installation, restart your terminal to ensure uv is in your PATH.

Add the following configuration to ~/.codeium/windsurf/mcp_config.json to enable Odoo integration in Windsurf.

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

To use the Odoo MCP server with Claude Desktop, add the following configuration to your ~/Library/Application Support/Claude/claude_desktop_config.json file. This uses uvx to run the server without manual installation.

Required environment variables:

• ODOO_URL: Your Odoo instance URL.
• ODOO_API_KEY: Your Odoo API key.
• ODOO_DB: Your Odoo database name.

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