MCP Server for Odoo

What is MCP Server for Odoo?

MCP Server for Odoo is a server that enables AI assistants like Claude to interact with Odoo ERP systems through natural language. It can search, create, update, and delete records, and works with any Odoo instance — using YOLO mode for quick testing or the Odoo MCP module for production security.

How to use MCP Server for Odoo?

Install via uvx and configure environment variables in your MCP settings file (e.g., ODOO_URL, ODOO_API_KEY, ODOO_DB). The server runs on your local machine, not on the Odoo server. Alternatively, use Docker, pip, or run from source.

Key features of MCP Server for Odoo

• Search and retrieve any Odoo record
• Create, update, and delete records with permission checks
• Count records matching specific criteria
• Inspect model fields to understand data structure
• Server-side aggregation (group, sum, count)
• Workflow actions via an opt-in escape hatch
• Secure API key or username/password authentication
• Smart pagination and smart field selection
• LLM-optimized hierarchical text output
• Multi-language support and YOLO mode for quick testing

Use cases of MCP Server for Odoo

• Automate customer, product, or invoice lookups and creation via chat
• Update existing business records without manual form filling
• Aggregate sales data (e.g., total sales by month) without exporting
• Confirm sales orders or post invoices using workflow methods
• Quickly explore and inspect Odoo model fields during development

FAQ from MCP Server for Odoo

How do I authenticate with my Odoo instance?

You must provide either an API key (ODOO_API_KEY) or both a username (ODOO_USER) and password (ODOO_PASSWORD). API key authentication is recommended for better security.

What is YOLO mode and when should I use it?

YOLO mode bypasses MCP security and works with any Odoo version that has XML-RPC enabled. It is intended for development/testing/demos only and exposes the full Odoo backend — use the Odoo MCP module for production.

Does the server work with any Odoo version?

In standard mode (production), Odoo 16.0+ with the Odoo MCP module is required. In YOLO mode, any Odoo version with XML-RPC enabled works.

What are the system requirements?

Python 3.10 or higher on the local machine, UV installed, and access to an Odoo instance. No installation is needed on the Odoo server itself.

Can I run it over HTTP?

Yes, use the streamable-http transport. However, this transport has no built-in client authentication — any client that can reach the port gets full Odoo access. Keep the default localhost bind or front it with an authenticating reverse proxy.