| 1 | # Odoo MCP |
| 2 | |
| 3 | <!-- mcp-name: io.github.erpipe-org/mcp-odoo --> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <strong>The free AI layer for Odoo — any edition, any version.</strong><br> |
| 7 | Odoo's built-in AI is Enterprise-only. Odoo MCP gives Community and Enterprise 16+ the same power for $0 with the LLM you already use (Claude, GPT, Gemini, DeepSeek, Ollama).<br> |
| 8 | Five-minute install. Zero Odoo-side setup. Safe writes, real diagnostics, JSON-2 ready years before the Odoo 22 XML-RPC removal. |
| 9 | </p> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <a href="https://pypi.org/project/odoo-mcp/"><img alt="PyPI" src="https://img.shields.io/pypi/v/odoo-mcp.svg"></a> |
| 13 | <a href="https://pypi.org/project/odoo-mcp/"><img alt="Python" src="https://img.shields.io/pypi/pyversions/odoo-mcp.svg"></a> |
| 14 | <a href="https://pypi.org/project/odoo-mcp/"><img alt="Downloads" src="https://img.shields.io/pypi/dm/odoo-mcp.svg"></a> |
| 15 | <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-black.svg"></a> |
| 16 | <a href="https://github.com/erpipe-org/mcp-odoo/actions/workflows/publish.yml"><img alt="CI" src="https://github.com/erpipe-org/mcp-odoo/actions/workflows/publish.yml/badge.svg"></a> |
| 17 | <a href="https://github.com/erpipe-org/mcp-odoo/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/erpipe-org/mcp-odoo?style=flat"></a> |
| 18 | <a href="https://github.com/erpipe-org/mcp-odoo/network/members"><img alt="Forks" src="https://img.shields.io/github/forks/erpipe-org/mcp-odoo?style=flat"></a> |
| 19 | <a href="https://skills.sh/erpipe-org/mcp-odoo"><img alt="Agent Skills" src="https://skills.sh/b/erpipe-org/mcp-odoo"></a> |
| 20 | </p> |
| 21 | |
| 22 | <p align="center"> |
| 23 | <a href="https://mcp.erpipe.com/"><strong>🚀 ERPipe hosted</strong> — free v1 · live at mcp.erpipe.com</a> |
| 24 | · |
| 25 | <a href="https://github.com/erpipe-org/erpipe"><strong>TypeScript open core</strong></a> |
| 26 | · |
| 27 | <a href="https://erpipe-org.github.io/mcp-odoo/services.html"><strong>🔍 Fixed-price audits</strong></a> |
| 28 | </p> |
| 29 | |
| 30 | > **Want ChatGPT / Claude on a stable remote URL without running a process?** |
| 31 | > **[ERPipe](https://mcp.erpipe.com/)** is the hosted product from the same author — free v1 public beta, live in production. |
| 32 | > Sign up → add HTTPS Odoo instance(s) → connect once to `https://mcp.erpipe.com/mcp` (workspace OAuth, multi-instance, gated writes, audit dashboard). |
| 33 | > This repo stays the **local / self-host Python server** (full 41-tool surface, stdio, Docker). TypeScript building blocks: [`erpipe`](https://github.com/erpipe-org/erpipe). |
| 34 | |
| 35 | | | **This repo (`odoo-mcp`)** | **[ERPipe hosted](https://mcp.erpipe.com/)** | |
| 36 | |--|--|--| |
| 37 | | Run where | Your laptop / Docker / CI | Cloudflare (managed) | |
| 38 | | Install | `uvx odoo-mcp --setup` | Sign up at [mcp.erpipe.com](https://mcp.erpipe.com/) | |
| 39 | | MCP URL | stdio or local HTTP | `https://mcp.erpipe.com/mcp` | |
| 40 | | Clients | Claude Code, Cursor, local agents | **ChatGPT** (primary), Claude, Cursor, any remote MCP client | |
| 41 | | Tool surface | **41 tools** + 11 prompts (full local pack) | **37 tools** + 7 prompts (workspace multi-instance + governance) | |
| 42 | | Multi-instance | Config file / env on your machine | Dashboard + explicit `instance` key per tool | |
| 43 | | Writes | Env gate + approval tokens (+ optional MCP elicitation) | Default OFF · HITL inbox · journal · field policy | |
| 44 | | Audit | Optional JSONL file | Dashboard + D1 audit trail | |
| 45 | | Cost | Free forever (MIT) | Free v1 beta (fair-use caps) | |
| 46 | |
| 47 | Odoo MCP turns any Odoo 16+ database into a Model Context Protocol server — using only your existing credentials. **No App Store module, no permission setup, no admin access required.** Built for local agents, IDEs, and automation tools that need real Odoo context without hand-rolled scripts or unsafe direct write access. |
| 48 | |
| 49 | It speaks XML-RPC for Odoo 16-18 and External JSON-2 for Odoo 19+. It exposes a compact MCP surface with read tools, diagnostics, schema discovery, migration helpers, local addon scanning, and a gated write workflow. One server can serve [multiple named Odoo instances](# |