mcp-server-odoo

What it does

The mcp-server-odoo bridges Claude to Odoo ERP systems, exposing search, create, update, delete, and aggregation operations through natural language. It supports two deployment modes: YOLO mode for rapid prototyping against any Odoo instance with XML-RPC enabled (no module install), and production mode with the optional Odoo MCP module for enterprise security and access controls. Claude can query records (customers, invoices, products), mutate data, group and sum results server-side, and invoke Odoo workflow methods directly.

Who it's for

ERP operations teams, Odoo consultants, and business process automation engineers who want Claude to read from and write to their Odoo instance. Also developers prototyping Odoo integrations or automating routine data tasks within an existing Odoo deployment.

Common use cases

• Query customers, invoices, or sales orders by natural language criteria and summarize results
• Create new records (customers, purchase orders, invoices) from Claude prompts
• Update product pricing or customer details based on incoming requests
• Aggregate sales data by region or customer category without pulling raw rows
• Invoke Odoo workflows: post an invoice, confirm a sales order, mark records as done

Setup pitfalls

• Runs on your local machine (where Claude Desktop is installed), not the Odoo server. UV must be installed first via the provided shell/PowerShell script.
• Two modes require different setup: YOLO mode works with any Odoo version but is testing-only; production mode requires Odoo 16.0+ and the mcp_server module from the Odoo app store.
• Critical env vars: ODOO_URL, ODOO_API_KEY (or username/password), and ODOO_DB must be set. Defaults are typically missing.
• Credentials are embedded as secrets in the MCP configuration; the scanner detected 5 secrets. Avoid committing them to version control—use environment variables or a secure secrets store.