erpipe-org/mcp-odoo

What it solves

Odoo MCP provides a free AI layer for Odoo 16+ (both Community and Enterprise editions), allowing LLMs to interact with Odoo databases without requiring expensive Enterprise-only AI features or complex Odoo-side module installations. It bridges the gap between AI agents (like Claude, GPT, and Gemini) and Odoo data, enabling them to perform queries, audits, and managed writes safely.

How it works

The project acts as a Model Context Protocol (MCP) server that connects to Odoo via XML-RPC (for versions 16-18) or External JSON-2 (for version 19+). It exposes 41 tools to AI agents, allowing them to read records, inspect schemas, and perform diagnostics. To ensure security, direct write access is blocked by default; writes require a gated workflow involving approval tokens, live metadata validation, and optional human-in-the-loop confirmation forms.

Who it’s for

• Odoo Users: Those wanting to add AI capabilities to their Odoo instance for free.
• AI Agent Users: People using IDEs like Cursor or tools like Claude Code that need real-time Odoo context.
• Odoo Developers/Partners: Professionals needing tools for migration audits, data quality checks, and cross-instance queries across multiple client databases.

Highlights

• Zero Odoo-side Setup: Works with existing credentials; no App Store modules or admin access required.
• Safe Write Workflow: Implements a gated system with approval tokens and human-in-the-loop (HITL) elicitation to prevent accidental data corruption.
• Comprehensive Toolset: Includes 41 tools for reading records, server-side aggregation, chatter integration, and local-first BM25 knowledge search.
• Multi-instance Support: A single server can manage and query across multiple named Odoo instances simultaneously.
• Advanced Diagnostics: Provides specialized tools for upgrade risk reports, fit-gap analysis, and Odoo 19 JSON-2 migration helpers.
• Field-level ACL: Allows opt-in per-instance or per-model field allow/deny lists to restrict data access.