Odoo MCP Server

Name: Odoo MCP Server
Author: tuanle96

@tuanle96

Repository Homepage

About Odoo MCP Server

MCP Server for Odoo

#mcp #odoo #mcp-servers #mcp-server #odoo-mcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": [
        "odoo-mcp"
      ],
      "env": {
        "ODOO_URL": "https://your-odoo.example.com",
        "ODOO_DB": "your-database",
        "ODOO_USERNAME": "your-login",
        "ODOO_PASSWORD": "<YOUR_API_KEY>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Odoo MCP Server?

Odoo MCP Server turns any Odoo 16+ database into a Model Context Protocol server using only your existing credentials — no Odoo-side module, permission setup, or admin access required. It exposes read tools, diagnostics, schema discovery, migration helpers, local addon scanning, and a gated write workflow for LLM agents, IDEs, and automation tools.

How to use Odoo MCP Server?

Install via pip install odoo-mcp or uvx odoo-mcp (interactive wizard with --setup). Configure with environment variables (ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD) and register the server in your MCP client (Claude Code, Cursor, Claude Desktop, etc.). The server connects to your Odoo instance and exposes 41 MCP tools; optional prompts and plugins extend functionality.

Key features of Odoo MCP Server

41 MCP tools for Odoo data and diagnostics.
Field-level access control lists (ACL) on every read path.
Cross-instance read-only fan-out across multiple Odoo databases.
Safe write workflow with approval tokens and validation.
Local-first knowledge search without external embeddings.
Migration helpers for JSON-2 transition (Odoo 19+).

Use cases of Odoo MCP Server

Query customers from Spain with unpaid invoices.
Find products with stock below 10 units in the main warehouse.
Audit a custom addon for upgrade risks before migrating to Odoo 19.
Automate month-end close and expense review with workflow prompts.
Diagnose Odoo call failures and access rule conflicts in real time.

FAQ from Odoo MCP Server

What Odoo versions are supported?

Odoo 16 through 19. XML-RPC is used by default for versions 16–18; External JSON-2 is available opt-in for Odoo 19 and above.

Do I need to install any module in Odoo?

No. The server works with any Odoo 16+ instance using credentials you already have — zero setup on the Odoo side.

How safe are writes?

Direct create, write, and unlink are blocked by default. Approved writes require a same-session approval token, live fields_get validation, explicit confirmation, and an environment gate. An optional human-in-the-loop mode shows a diff summary before execution.

Can I connect multiple Odoo instances at once?

Yes. The server supports multiple named instances in one configuration file, with per-tool instance routing, isolated tokens, caches, and approval tokens.

What transport protocols are supported?

Stdio (default) and Streamable HTTP/SSE for clients that do not use stdio. Under the hood, the server uses XML-RPC (Odoo 16–18) or External JSON-2 (Odoo 19+).