mcp-odoo

MCP.Pizza Chef: erpipe-org

Odoo runs the books for a lot of small businesses, and this opens those records to plain-language questions: overdue payments, stock running low in a warehouse, duplicate or missing details before an upgrade. Writing back is switched off unless you deliberately enable it, and enabled changes still need approval, so it is safe to point at live records. Works with Odoo 16 and up using the login you already have, with no add-on module to install. Last updated July 2026.

Data

Use This MCP server To

Find customers with unpaid invoices in a given country Spot products running low on stock before I reorder Ask what we are owed and how overdue it is Check my records for duplicates and missing details Get a straight answer without building a report Review a customization for risks before an upgrade

README

Odoo MCP

The free AI layer for Odoo — any edition, any version.
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).
Five-minute install. Zero Odoo-side setup. Safe writes, real diagnostics, JSON-2 ready years before the Odoo 22 XML-RPC removal.

PyPI Python Downloads License CI Stars Forks Agent Skills

🚀 ERPipe hosted — free v1 · live at mcp.erpipe.com  ·  TypeScript open core  ·  🔍 Fixed-price audits

Want ChatGPT / Claude on a stable remote URL without running a process?
ERPipe is the hosted product from the same author — free v1 public beta, live in production.
Sign up → add HTTPS Odoo instance(s) → connect once to https://mcp.erpipe.com/mcp (workspace OAuth, multi-instance, gated writes, audit dashboard).
This repo stays the local / self-host Python server (full 41-tool surface, stdio, Docker). TypeScript building blocks: erpipe.

This repo (odoo-mcp) ERPipe hosted
Run where Your laptop / Docker / CI Cloudflare (managed)
Install uvx odoo-mcp --setup Sign up at mcp.erpipe.com
MCP URL stdio or local HTTP https://mcp.erpipe.com/mcp
Clients Claude Code, Cursor, local agents ChatGPT (primary), Claude, Cursor, any remote MCP client
Tool surface 41 tools + 11 prompts (full local pack) 37 tools + 7 prompts (workspace multi-instance + governance)
Multi-instance Config file / env on your machine Dashboard + explicit instance key per tool
Writes Env gate + approval tokens (+ optional MCP elicitation) Default OFF · HITL inbox · journal · field policy
Audit Optional JSONL file Dashboard + D1 audit trail
Cost Free forever (MIT) Free v1 beta (fair-use caps)

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.

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 at once.

mcp-odoo FAQ

Is this project actively maintained?
Yes, very. The last update was July 2026, releases are frequent, and the same author also runs a free hosted version at mcp.erpipe.com.
Do I need to install anything inside Odoo?
No. It uses the login you already have, with no add-on module and no administrator access required.
Can it change my business records?
Only if you switch writing on. It reads by default, and any enabled change still has to pass an approval step.
Is there a version I do not have to run myself?
Yes. The same author hosts one at mcp.erpipe.com, free in its first release, aimed at ChatGPT and Claude.
Which apps does it work in?
Claude Desktop, ChatGPT, Cursor, VS Code, Cline, Windsurf, and Continue are all listed by the project.
Which versions of Odoo does it support?
Odoo 16 and newer, on both Community and Enterprise, which matters because Odoo's own built-in assistant is Enterprise only.
Can I use this to answer a finance question like what we are owed?
Yes. It has dedicated tools for money owed to you and by you, broken down by how overdue each amount is.
How hard is the setup?
Manageable. One setup command walks you through connecting your database, or you skip installation entirely with the hosted version.