Odoo MCP

What it does

Odoo MCP connects AI agents to Odoo 16-19 databases, allowing them to read records, aggregate data, and perform diagnostics without requiring complex server-side setup or admin access.

Tools

• list_models: List Odoo model technical names and labels.
• get_model_fields: Read field metadata for a specific model.
• search_records: Perform bounded read-only searches with smart-field selection.
• read_record: Retrieve a single record by model and ID.
• aggregate_records: Server-side groupby and aggregation.
• execute_approved_write: Execute validated, confirmed writes (requires ODOO_MCP_ENABLE_WRITES=1).
• chatter_post: Post messages to an Odoo mail thread.
• diagnose_access: Check ACL and record-rule visibility for current credentials.
• upgrade_risk_report: Analyze migration risks across Odoo versions.
• scan_addons_source: Scan local addon source code.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["odoo-mcp"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your-database",
        "ODOO_USERNAME": "your-user",
        "ODOO_PASSWORD": "your-password-or-api-key",
        "ODOO_TRANSPORT": "xmlrpc"
      }
    }
  }
}

Supported hosts

• Claude Desktop