Odoo Mcp Gateway

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.