Odoo Mcp Gateway

Name: Odoo Mcp Gateway
Author: parth-unjiya

@parth-unjiya

About 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

Basic information

Config

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

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

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