mcp-server-odoo

An extensible Model Context Protocol server that provides integration between Odoo and LLMs.

Beware: the project is in very early development. Expect rough edges. We welcome any feedback!

MCP server in action

Here's a demonstration of what kind of capabilities the MCP enables in Claude for Desktop:

Related MCP server: Odoo MCP Server

Prerequisites

• uv

Configuration

The server looks for the following variables in the execution environment:

Installation

Install the tool with uv tool:

uv tool install --from git+https://github.com/alberto-re/mcp-server-odoo mcp-server-odoo

Run the server

Execute it directly with uvx:

uvx mcp-server-odoo

Run within Docker

A Dockerfile is included if you wish to run the MCP server inside a Docker container.

To build the container execute this command from the root directory of the repository:

docker build -t mcp-server-odoo .

Now you can execute the container from the built image with:

docker run --rm --env-file /path/to/env/file -p 8000:8000 mcp-server-odoo

When running inside a container remember to use an HTTP based transport protocol (i.e. set TRANSPORT_PROTOCOL to sse or streamable-http) and to make the server listen to all interfaces (i.e. set HOST to 0.0.0.0).

Integrations

Connecting to Claude Desktop

1. Edit the Claude for Desktop configuration file.

• In MacOS the configuration is located at ~/Library/Application Support/Claude/claude_desktop_config.json.

• In Windows the configuration is located at %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration under the mcpServers section.

{
  "mcpServers": {
    "mcp-server-odoo": {
      "command": "uvx",
      "args": [
        "mcp-server-odoo"
      ],
      "env": {
        "ODOO_BASE_URL": "http://localhost:8069",
        "ODOO_DATABASE": "mydatabase",
        "ODOO_USERNAME": "admin",
        "ODOO_PASSWORD": "admin",
        "ODOO_VERSION": "18",
        "TRANSPORT_PROTOCOL": "stdio",
        "TOOLS_TO_REGISTER": "search_partners,search_quotations,search_sales_orders,search_customer_invoices"
      }
    }
  }
}

3. Restart Claude for Desktop.

Connecting to mcphost

1. Edit the mcphost configuration file. See the documentation for where it looks for configuration files.

2. Add the server configuration under the mcpServers section.

{
  "mcpServers": {
    "mcp-server-odoo": {
      "command": "uvx",
      "args": [
        "mcp-server-odoo"
      ],
      "env": {
        "ODOO_BASE_URL": "http://localhost:8069",
        "ODOO_DATABASE": "mydatabase",
        "ODOO_USERNAME": "admin",
        "ODOO_PASSWORD": "admin",
        "ODOO_VERSION": "18",
        "TRANSPORT_PROTOCOL": "stdio",
        "TOOLS_TO_REGISTER": "search_partners,search_quotations,search_sales_orders,search_customer_invoices"
      }
    }
  }
}

3. Execute the mcphost command.