odoo-mcp
Connects to an Odoo instance via XML-RPC and exposes its ORM to AI agents, enabling model discovery, record search and read operations, and two-step confirmed create/update actions with pending-action management and audit logging.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
odoo-mcp
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--> OdooEl agente ve tres herramientas:
Herramienta | Qué hace |
| Modelos que el servidor permite consultar |
| Modelos en los que se permite escribir (con confirmacion) |
| Busca registros con filtros estilo Odoo ( |
| Lee un registro por ID |
| Propone crear un registro (no escribe). Devuelve |
| Propone actualizar un registro (no escribe). Devuelve |
| Ejecuta una accion propuesta (solo tras confirmacion del usuario) |
| Cancela una accion pendiente |
| 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 -dAbre 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 -vEscritura con confirmacion
La escritura es siempre en dos pasos para que el agente no modifique datos sin tu visto bueno:
propose_create/propose_updatedevuelven una vista previa y unaction_id. No tocan Odoo.El agente te muestra la vista previa. Solo si confirmas, llama a
confirm_action(action_id).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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read, write and run Odoo actions from any AI app, as each user, with approval rules per colleague.
Connect AI to Odoo ERP 14-20: search, create, update and manage records in natural language.
Odoo ERP for AI agents: hosted OAuth endpoint, gated writes, one endpoint for every instance.
Runtime permission, approval, and audit layer for AI agent tool execution.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.2MIT
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityDmaintenanceEnables 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