Odoo MCP Server

Name: Odoo MCP Server
Author: tuanle96

@tuanle96

代码仓库主页

关于 Odoo MCP Server

MCP Server for Odoo

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

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

tuanle96

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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>"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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+).