Odoo Mcp Gateway

Name: Odoo Mcp Gateway
Author: parth-unjiya

@parth-unjiya

关于 Odoo Mcp Gateway

Security-first MCP gateway for Odoo 17/18/19 — 27 tools, YAML-driven security

#odoo #mcp #model-context-protocol #claude #ai #erp #python #mcp-server #odoo17 #odoo18 #odoo19 #security #anthropic #claude-desktop #odoo-connector #odoo-api

基本信息

分类

其他

传输方式

stdio

发布者

parth-unjiya

提交者

Parth Unjiya

配置

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

{
  "mcpServers": {
    "odoo-mcp-gateway": {
      "command": "python",
      "args": [
        "-m",
        "odoo_mcp_gateway"
      ]
    }
  }
}

工具

未检测到工具

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

概览

What is Odoo Mcp Gateway?

A security-first, version-agnostic MCP (Model Context Protocol) gateway for Odoo 17, 18, and 19. It works with stock and custom modules via YAML configuration and requires zero Odoo-side code — just pip install and configure. It provides 27 MCP tools, 5 resources, and 7 prompt templates for interacting with any Odoo instance.

How to use Odoo Mcp Gateway?

Install with pip install odoo-mcp-gateway, copy example YAML config files (restrictions, model_access, rbac), set environment variables ODOO_URL and ODOO_DB, then run with python -m odoo_mcp_gateway (stdio mode for Claude Desktop/Claude Code) or with MCP_TRANSPORT=streamable-http for web clients. Authentication happens via the login MCP tool using api_key, password, or session methods.

Key features of Odoo Mcp Gateway

Two‑layer security: MCP restrictions (YAML) + Odoo's built‑in ACLs
YAML‑driven configuration for model limits, RBAC, field‑level access, rate limiting
Auto‑discovers custom module models via ir.model — no Python code needed
Version‑agnostic across Odoo 17, 18, and 19 with version‑specific adapters
Full MCP primitives: 27 Tools, 5 Resources, 7 Prompt templates
Plugin architecture extendable via pip‑installable entry points

Use cases of Odoo Mcp Gateway

Integrate MCP‑compatible AI assistants (Claude Desktop, Claude Code) with any Odoo database
Enable CRUD operations on stock and custom Odoo models through natural language or automated pipelines
Enforce fine‑grained access policies for different user groups without modifying Odoo itself
Build domain‑specific workflows (HR, Sales, Project, Helpdesk) using built‑in plugin tools

FAQ from Odoo Mcp Gateway

Does this require a custom Odoo addon?

No. The gateway works without any Odoo‑side code — just pip install and YAML configuration.

Which Odoo versions are supported?

Odoo 17, 18, and 19 are supported via version‑specific adapters.

What authentication methods does it support?

Three stock Odoo methods: api_key (XML‑RPC), password (JSON‑RPC), and session (JSON‑RPC for reusing browser sessions).

How is security enforced?

A two‑layer model: first, the MCP gateway applies YAML‑configured restrictions and hardcoded guardrails (blocked models, methods, field validation, rate limiting). Second, Odoo’s built‑in ir.model.access and ir.rule enforce per‑user record access.

What configuration files are needed?

Four YAML files: restrictions.yaml, model_access.yaml, rbac.yaml, and gateway.yaml (with example templates provided). Environment variables ODOO_URL and ODOO_DB are also required.