home / mcp / odoo mcp server

Odoo MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to securely interact with Odoo ERP systems through standardized resources and tools for data retrieval and manipulation.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can use this MCP (Model Connect Protocol) server to let AI assistants interact with your Odoo ERP system. It enables searching, creating, updating, and managing Odoo data through natural language, while enforcing access controls and data formatting suitable for AI clients.

How to use

To use the MCP server with an AI assistant, connect your client to the MCP server using the configured transport (stdio for local desktop clients or streamable-http for remote HTTP access). You can perform common data operations such as searching for records, counting results, creating new entries, updating existing data, and deleting records. The server automatically handles authentication, model permissions, and smart field selection to present results in a structured, readable format for your AI companion.

How to install

Prerequisites you need before running the MCP server include Python 3.10 or higher and an accessible Odoo instance. You also install UV (a launcher utility) on your local machine to run the MCP server.

Step-by-step commands to get started locally:

# Install UV on macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install UV on Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Restart your terminal to ensure UV is in your PATH

Additional setup steps

Next, configure the MCP server in your local environment to point to your Odoo instance and provide authentication details.

Recommended MCP configuration snippet (for your MCP client settings):

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

YOLO mode (development/testing only)

YOLO mode lets you connect directly to an Odoo instance without the MCP module. It is for development and testing only and must not be used in production. There are two levels: Read-Only and Full Access. Always operate YOLO in isolated environments and never in production.

Examples of YOLO mode configurations are provided in the setup sections for different testing scenarios.

Available tools

search_records

Search for records in any Odoo model with domain filters and selective fields.

get_record

Retrieve a single record by its ID with specified fields.

list_models

List models enabled for MCP access.

list_resource_templates

List available URI templates and their usage patterns.

create_record

Create a new record in a specified Odoo model with given field values.

update_record

Update fields on an existing record by ID.

delete_record

Delete a record from a specified model by ID.

Smart Field Selection

Automatically select the most relevant fields for each model when fields are not explicitly provided.