概览
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+).
