mcp-odoo

Overview

This MCP server connects to any Odoo 16+ database through XML-RPC or External JSON-2 protocols, providing comprehensive access to Odoo functionality while maintaining security through its safe write model. It includes 24 tools for reading records, aggregating data, diagnosing issues, migrating between Odoo versions, and auditing modules. The server features smart field selection, server-side aggregation, and chatter integration, all designed to integrate with local agents, IDEs, and automation tools requiring real Odoo context without direct write access.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• list_models

  List Odoo model technical names and labels.

  Try:List all available models in the Odoo database.
• get_model_fields

  Read field metadata for one model.

  Try:Show me all fields for the sale.order model.
• search_records

  Run bounded read-only search_read with smart field selection.

  Try:Find all unpaid invoices from customers in Spain.
• read_record

  Read one record by model and ID with smart field selection.

  Try:Show me details for product ID 42.
• aggregate_records

  Server-side groupby/aggregation via read_group or formatted_read_group.

  Try:Group sales orders by state and count them.
• search_employee

  Search employees by name.

  Try:Find all employees named John.
• preview_write

  Produce a non-executing approval payload for create, write, or unlink.

  Try:Show me what would happen if I create a new customer.
• validate_write

  Validate a write payload against trusted live metadata.

  Try:Check if this proposed customer update is valid.
• execute_approved_write

  Execute a validated write when writes are enabled.

  Try:Create the new customer after preview.
• diagnose_odoo_call

  Diagnose a model call without executing it.

  Try:Diagnose why this search query isn't working.
• generate_json2_payload

  Convert XML-RPC input into JSON-2 endpoint and body.

  Try:Convert this XML-RPC call to JSON-2 format.
• health_check

  Report non-secret MCP runtime posture.

  Try:Check if the Odoo MCP server is running properly.

Comparable tools

Installation

uvx odoo-mcp --health

pip install odoo-mcp
# or: pipx install odoo-mcp

git clone https://github.com/tuanle96/mcp-odoo.git
cd mcp-odoo
uv sync --extra dev

export ODOO_URL="https://your-odoo-instance.com"
export ODOO_DB="your-database"
export ODOO_USERNAME="your-user"
export ODOO_PASSWORD="your-password-or-api-key"
export ODOO_TRANSPORT="xmlrpc"

odoo-mcp

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "args": []
    }
  }
}

FAQ

What Odoo versions are supported?

Odoo MCP supports Odoo 16-19 with XML-RPC as the default transport and External JSON-2 as an option for Odoo 19+. It's designed to be ready for Odoo 20.

Do I need special setup in Odoo to use this server?

No - this server works with any existing Odoo 16+ instance using your current credentials. No App Store module, permission setup, or admin access is required.

How does the safe write workflow work?

The server requires a multi-step approval process: preview_write creates a non-executing payload, validate_write checks against live metadata, and execute_approved_write only runs when all security gates pass including same-session token validation.

Compare mcp-odoo with