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.