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
MCP server

Broad access

Why this level

  • Connects to an Odoo database with credentials
  • Can write changes to ERP data
  • Works with production systems
All reasons and checks

erpipe-org/mcp-odoo

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/odoo-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad 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 customer

MCP

Transport
stdio
Authentication
API key

Environment variables

ODOO_URL required
URL of your Odoo instance
ODOO_DB required
Odoo database name
ODOO_USERNAME required
Odoo user
ODOO_PASSWORD required, 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.

MCP server for Odoo: the agent reads, creates and updates ERP records, searches data and calls business operations within Odoo permissions

MCP serverBroad access415Repository stars
Official

An Odoo connector for the agent: search, create and edit records of any ERP model in plain language, Odoo versions 14 to 20

MCP serverBroad access92Repository stars
Russian stack

A minimal MCP server for amoCRM API v4: read and create leads, contacts and notes, with OAuth2 and long-term tokens

MCP serverBroad access12Repository stars

MCP server for ERPNext and Frappe: documents, stock and sales from chat, plus nine viewer windows in the client

MCP serverBroad access123Repository stars

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 serverBroad access
Russian stack

MCP server for the amoCRM (Kommo) API v4: leads, contacts, companies, tasks, pipelines, unsorted inbox and analytics

MCP serverBroad access2Repository stars

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.

README badge

Report a problem