Odoo MCP
A self-hosted MCP server for Odoo: read and gated writes of ERP data through an agent, any edition and version
- 433 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Connects to an Odoo database with credentials
- Can write changes to ERP data
- Works with production systems
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/odoo-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Connects to an Odoo database with credentials
- Can write changes to ERP data
- Works with production systems
This is third-party code. Review the repository files before installing.
What it does
The server connects Odoo to an agent over MCP and exposes tools for ERP models: reading records, search, diagnostics and gated writes. Writes go through a safeguard so the agent does not change data unchecked. It supports multiple Odoo instances and the Community and Enterprise editions from version 16 on. It runs locally over stdio, installs from PyPI or via Docker and connects to your Odoo server over XML-RPC or JSON-RPC. The same author offers a separate hosted gateway product, but this repository stays the self-hosted local server.
Who it is for. For teams on Odoo who want an agent to read and carefully change ERP data.
Good fit when
- You want to ask an agent for Odoo data: orders, products, contacts
- You want gated writes to Odoo through an agent
- You want to connect several Odoo instances to one agent
Not a fit when
- You do not use Odoo but another ERP
- You cannot give an agent access to a production database even with limits
Example request
Show unpaid invoices from Odoo for last month for this customerMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
ODOO_URLrequired- URL of your Odoo instance
ODOO_DBrequired- Odoo database name
ODOO_USERNAMErequired- Odoo user
ODOO_PASSWORDrequired, secret- User password or API key
ODOO_TRANSPORT- Connection transport: xmlrpc or jsonrpc
Limitations
The server connects to your Odoo instance and needs a URL, database, user and a password or API key, so access must be granted deliberately. Even with write gating the agent works with ERP data, which is high risk for a production database. The hosted ERPipe gateway is a separate paid product outside this repository. Operation depends on Odoo version compatibility and the XML-RPC or JSON-RPC transport.
How to disable. Remove the odoo server from your client's MCP config and uninstall the package: pip uninstall odoo-mcp or stop the Docker container.
FAQ
How does this repo differ from ERPipe?
This is a self-hosted local server over stdio with the full tool surface. ERPipe is a separate hosted gateway from the same author with a remote URL.
Which Odoo versions are supported?
Community and Enterprise from version 16 on, over XML-RPC or JSON-RPC.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server for Odoo: the agent reads, creates and updates ERP records, searches data and calls business operations within Odoo permissions
An Odoo connector for the agent: search, create and edit records of any ERP model in plain language, Odoo versions 14 to 20
A minimal MCP server for amoCRM API v4: read and create leads, contacts and notes, with OAuth2 and long-term tokens
MCP server for ERPNext and Frappe: documents, stock and sales from chat, plus nine viewer windows in the client
Kommo CRM MCP server
Kommo MCP Server
A Python MCP server with OAuth for Kommo CRM: leads, contacts, pipelines, tags, tasks, and generic GET, POST, PATCH calls to the API
MCP server for the amoCRM (Kommo) API v4: leads, contacts, companies, tasks, pipelines, unsorted inbox and analytics
README in short
The README presents a free AI layer for Odoo: the server gives Community and Enterprise the capabilities that Odoo itself keeps to Enterprise. Setup takes a few minutes with pip install odoo-mcp, a uvx run, Docker and an mcpServers config snippet with connection variables. Writes are gated, and diagnostics and multiple instances are supported. The repository is the local Python server, while the hosted ERPipe gateway is a separate product. MIT licensed, published on PyPI.