Odoo MCP Server

What is Odoo MCP Server?

Odoo MCP Server turns any Odoo 16+ database into a Model Context Protocol server using only your existing credentials — no Odoo-side module, permission setup, or admin access required. It exposes read tools, diagnostics, schema discovery, migration helpers, local addon scanning, and a gated write workflow for LLM agents, IDEs, and automation tools.

How to use Odoo MCP Server?

Install via pip install odoo-mcp or uvx odoo-mcp (interactive wizard with --setup). Configure with environment variables (ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD) and register the server in your MCP client (Claude Code, Cursor, Claude Desktop, etc.). The server connects to your Odoo instance and exposes 41 MCP tools; optional prompts and plugins extend functionality.

Key features of Odoo MCP Server

• 41 MCP tools for Odoo data and diagnostics.
• Field-level access control lists (ACL) on every read path.
• Cross-instance read-only fan-out across multiple Odoo databases.
• Safe write workflow with approval tokens and validation.
• Local-first knowledge search without external embeddings.
• Migration helpers for JSON-2 transition (Odoo 19+).

Use cases of Odoo MCP Server

• Query customers from Spain with unpaid invoices.
• Find products with stock below 10 units in the main warehouse.
• Audit a custom addon for upgrade risks before migrating to Odoo 19.
• Automate month-end close and expense review with workflow prompts.
• Diagnose Odoo call failures and access rule conflicts in real time.

FAQ from Odoo MCP Server

What Odoo versions are supported?

Odoo 16 through 19. XML-RPC is used by default for versions 16–18; External JSON-2 is available opt-in for Odoo 19 and above.

Do I need to install any module in Odoo?

No. The server works with any Odoo 16+ instance using credentials you already have — zero setup on the Odoo side.

How safe are writes?

Direct create, write, and unlink are blocked by default. Approved writes require a same-session approval token, live fields_get validation, explicit confirmation, and an environment gate. An optional human-in-the-loop mode shows a diff summary before execution.

Can I connect multiple Odoo instances at once?

Yes. The server supports multiple named instances in one configuration file, with per-tool instance routing, isolated tokens, caches, and approval tokens.

What transport protocols are supported?

Stdio (default) and Streamable HTTP/SSE for clients that do not use stdio. Under the hood, the server uses XML-RPC (Odoo 16–18) or External JSON-2 (Odoo 19+).