odoo-mcp-multi: Tu Odoo ahora habla con la IA 🤖

¿Te imaginas pedirle a tu asistente de IA: "Confírmame la orden de venta 42" y que lo haga directamente en tu Odoo? ¿O que busque contactos, cree facturas, o exporte datos... todo desde una conversación natural? 🎯

Con odoo-mcp-multi, eso ya no es ciencia ficción. Es tu nuevo flujo de trabajo.

🌟 ¿Qué es odoo-mcp-multi?

odoo-mcp-multi es un servidor MCP (Model Context Protocol) open source que actúa como un puente inteligente entre tus instancias de Odoo y los asistentes de IA más populares del mercado:

• 🧠 Google Antigravity (Gemini)
• 💬 Claude Desktop (Anthropic)
• ✏️ Cursor (el IDE con IA integrada)
• 🔧 VS Code (con extensiones MCP)

En lugar de escribir código, hacer calls de API manualmente o navegar por menús infinitos, simplemente le dices a la IA lo que necesitas y ella se comunica directamente con Odoo. Así de simple. Así de poderoso. 💪

🚀 La magia: Multi-perfil

Aquí viene lo realmente brillante. Si manejas múltiples instancias de Odoo (producción, staging, dev, o diferentes empresas), no necesitas un servidor separado para cada una.

Un solo servidor MCP maneja todas tus instancias simultáneamente. Solo necesitas configurar los perfiles una vez:

# Agregar perfiles interactivamente
$ odoo-mcp add-profile

# ¡Listo! Un solo servidor para todos
$ odoo-mcp run

Y en cada consulta, simplemente indicas a qué perfil conectarte:

# Buscar en producción
search_read(model="res.partner", ..., profile="produccion")

# Lo mismo en staging
search_read(model="res.partner", ..., profile="staging")

Si no especificas perfil, usa el predeterminado. ¡Cero fricción! ✨

🛠 10 herramientas nativas para dominar Odoo

El servidor expone 10 herramientas MCP que cubren prácticamente cualquier operación que necesites:

🔌 Compatibilidad robusta

odoo-mcp-multi habla el idioma de tu Odoo, sin importar la versión:

• 📡 JSON-RPC — Odoo 8.0+ (el estándar moderno)
• ⚡ JSON2 — Odoo 19.0+ (el nuevo protocolo optimizado)
• 🏛️ XML-RPC — Legacy (para los guerreros de la vieja escuela)

La detección del protocolo es automática. No tienes que configurar nada extra. El servidor detecta la versión de tu Odoo y elige el mejor protocolo disponible.

🔒 Seguridad primero

Las credenciales se almacenan de forma segura en ~/.config/odoo-mcp/ con permisos 600 (solo lectura para tu usuario). Nunca se exponen en logs ni en la comunicación MCP.

🔑 ¿Cómo obtengo mi API Key de Odoo?

Para conectar odoo-mcp-multi a tu instancia necesitas una API Key. Obtenerla es muy sencillo:

📖 Más detalles en la documentación oficial de Odoo.

💡 Tip para producción: Crea un usuario bot dedicado con los permisos mínimos necesarios y genera la API Key desde ese usuario. Así limitas el impacto si la clave se compromete.

⚡ Instalación en 3 pasos

# 1. Instalar
$ pip install odoo-mcp-multi

# 2. Agregar tu instancia de Odoo
$ odoo-mcp add-profile

# 3. ¡A volar!
$ odoo-mcp run

Y en tu cliente de IA, solo necesitas esta configuración:

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "args": ["run"]
    }
  }
}

Eso es todo. ¡Empieza a hablar con tu Odoo! 🎉

📋 ¿Quieres que la IA lo haga por ti? Copia este Prompt

¿No quieres configurar nada manualmente? Copia el prompt y pégalo directamente en tu Claude Desktop, Antigravity o Cursor. La IA hará toda la instalación y configuración por ti automáticamente. 🪄

Necesito que me ayudes a instalar y configurar odoo-mcp-multi
para conectar mis instancias de Odoo con este asistente de IA.

1. Instala el paquete: $ pip install odoo-mcp-multi
2. Ejecuta: $ odoo-mcp add-profile (me pedirá URL, DB, user, password)
3. Configura el MCP en mi cliente de IA con este JSON:
   {"mcpServers": {"odoo": {"command": "odoo-mcp", "args": ["run"]}}}
4. Reinicia el cliente y verifica con: list_available_profiles()

Solo necesito UNA entrada "odoo" sin importar cuántas instancias
tenga. Todas se manejan con el parámetro profile en cada llamada.

🆕 v0.3.0: CLI completo — Tu terminal es tu nuevo ERP

15 de marzo de 2026 — Esta versión marca un hito: paridad total entre CLI y MCP. Ya no necesitas un cliente de IA para operar tu Odoo programáticamente. Todo lo que puedes hacer desde la IA, ahora lo puedes hacer directamente desde tu terminal. 🖥️

💻 9 comandos CLI nuevos

Cada herramienta MCP ahora tiene su equivalente CLI. Misma lógica, cero duplicación:

# Buscar contactos desde tu terminal
$ odoo-mcp search-read -m res.partner --fields name,email

# Crear un registro
$ odoo-mcp create -m res.partner -v '{"name": "Alice"}'

# Exportar con External IDs
$ odoo-mcp export-records -m res.partner --fields id,name,email

# Ejecutar cualquier método
$ odoo-mcp execute-kw -m sale.order --method action_confirm --args '[[42]]'

🏗️ Arquitectura DRY

Internamente, creamos un nuevo módulo operations.py que contiene toda la lógica de negocio. Tanto el servidor MCP (server.py) como el CLI (cli.py) llaman las mismas funciones. Resultado: cero duplicación de código y comportamiento garantizado idéntico entre ambas interfaces.

🧪 60 tests automatizados

Se agregaron 54 tests nuevos cubriendo:

• 19 tests unitarios para operations.py
• 14 tests de integración CLI
• Cobertura adicional de argumentos pre-parseados

Total: 60 tests verificando que MCP y CLI se comportan exactamente igual. 💪

🤝 Open Source y hecho con ❤️

odoo-mcp-multi es un proyecto MIT de Vauxoo, disponible en GitLab. Contribuciones, issues y estrellas ⭐ son siempre bienvenidas.

Actualmente en versión 0.3.0, con un roadmap activo y mejoras constantes basadas en uso real en producción.

¿Ya conectaste tu Odoo con la IA? ¡Cuéntanos tu experiencia en los comentarios! 💬