Skip to main content
Glama
odoo-mcp

odoo-mcp

by AAMoralesC

odoo-mcp

tests License: MIT Python 3.11+

Servidor MCP que expone el ORM de Odoo a agentes de IA. Pregúntale a tu agente "¿cuántas facturas vencidas tiene el cliente X?" y que lo resuelva solo, sin abrir Odoo.

Combina dos cosas que casi nadie tiene juntas: Odoo en producción (17/18/19) y agentes de IA (AI Agent Manager, AIAM™). El servidor se conecta a una instancia de Odoo por XML-RPC y expone herramientas de lectura (y, más adelante, escritura con confirmación) a cualquier agente compatible con MCP (Claude, OpenCode, Cursor, etc.).


🧠 Cómo funciona

Agente (Claude/OpenCode)  --MCP-->  odoo-mcp  --XML-RPC-->  Odoo

El agente ve tres herramientas:

Herramienta

Qué hace

list_allowed_models

Modelos que el servidor permite consultar

list_writable_models

Modelos en los que se permite escribir (con confirmacion)

search_records

Busca registros con filtros estilo Odoo (domain)

read_record

Lee un registro por ID

propose_create

Propone crear un registro (no escribe). Devuelve action_id

propose_update

Propone actualizar un registro (no escribe). Devuelve action_id

confirm_action

Ejecuta una accion propuesta (solo tras confirmacion del usuario)

cancel_action

Cancela una accion pendiente

list_pending_actions

Lista las acciones pendientes de confirmacion

Por defecto solo lectura. La escritura llegará con confirmación explícita.


Related MCP server: Odoo MCP Server

🔒 Seguridad (importante)

  • Solo se exponen los modelos listados en ALLOWED_MODELS. Por defecto: partners, usuarios, empresa, ventas, facturas, productos, proyectos y tareas.

  • Usa un usuario de Odoo con permisos mínimos (no admin) y una instancia de prueba, nunca producción.

  • Las credenciales viven en .env, que está en .gitignore.


📦 Instalación

git clone https://github.com/AAMoralesC/odoo-mcp.git
cd odoo-mcp
python -m venv .venv && . .venv/bin/activate
pip install -e .
cp .env.example .env   # edita con tus datos de Odoo

🐳 Levantar Odoo de prueba

docker compose up -d

Abre http://localhost:8069, crea la base odoo con usuario admin / clave admin.

▶️ Ejecutar el servidor

odoo-mcp
# o: python -m odoo_mcp

🔌 Conectarlo a tu agente

El repo incluye un opencode.json listo para OpenCode: abre el proyecto en OpenCode y el servidor MCP de Odoo aparece automáticamente (requiere el venv creado con pip install -e .).

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DB": "odoo",
        "ODOO_USER": "admin",
        "ODOO_PASSWORD": "admin",
        "ALLOWED_MODELS": "res.partner,sale.order,account.move"
      }
    }
  }
}

Después le puedes preguntar: "¿Cuántas facturas vencidas hay y de qué clientes?"


🛠️ Desarrollo

pip install -e .
python -m unittest discover -s tests -v

Escritura con confirmacion

La escritura es siempre en dos pasos para que el agente no modifique datos sin tu visto bueno:

  1. propose_create / propose_update devuelven una vista previa y un action_id. No tocan Odoo.

  2. El agente te muestra la vista previa. Solo si confirmas, llama a confirm_action(action_id).

  3. Cada accion tiene un TTL de 5 minutos; si no la confirmas, expira.

Todas las escrituras quedan en un log de auditoria ([AUDIT] ...) en stderr.

Los modelos escribibles se configuran con WRITABLE_MODELS (subconjunto de ALLOWED_MODELS). Vacio = escritura deshabilitada. Por defecto: res.partner,project.task.

🗺️ Roadmap

  • Lectura: list/search/read con allowlist

  • Escritura con confirmacion (propose_* + confirm_action)

  • Auditoria de acciones del agente

  • Recursos MCP (schema de modelos)

  • Publicacion en PyPI

📄 Licencia

MIT — ver LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Odoo ERP systems through XML-RPC communication. Provides access to Odoo models, records, methods, and data structures for comprehensive ERP integration.
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Odoo ERP systems through XML-RPC, providing full access to models, records, and custom methods. It supports searching for employees and holidays, as well as general record management using the Model Context Protocol.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Odoo databases via XML-RPC and JSON-RPC for performing CRUD operations and managing modules. It supports advanced features like domain-based searching, field metadata inspection, and administrative task execution.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Odoo ERP systems through XML-RPC to manage records, search for employees, and track holidays. It provides comprehensive access to Odoo models and methods, allowing users to query data and execute custom functions via the Model Context Protocol.
      MIT