CLI de respaldo¶

La CLI es un cliente XML-RPC ligero (solo Node.js, sin Python). Úsala cuando el servidor MCP no pueda correr en tu entorno, o para acceso por lotes desde scripts. El servidor MCP sigue siendo la superficie principal y más completa.

Cuándo usarla¶

No tienes uv ni Python 3.11+ disponibles.
Necesitas acceso scriptable/por lotes desde una terminal o pipeline.
Un entorno restringido donde solo hay Node.

Instalación¶

/odoo-tools:odoo-setup-cli

Requiere Node.js 18+:

node --version   # 18+

Si falta: nodejs.org (LTS), brew install node o apt install nodejs npm. El comando instala la CLI en ~/.claude/tools/odoo-cli y escribe un .env local con tus credenciales.

Uso¶

node ~/.claude/tools/odoo-cli/dist/cli.js <comando> '<json-de-entrada>'

Ejemplo:

node ~/.claude/tools/odoo-cli/dist/cli.js contacts '{"limit": 1}'

Comandos disponibles¶

La CLI incluye 13 comandos orientados a los flujos más comunes de Odoo:

Comando	Qué hace
`contacts`	Consulta contactos (`res.partner`)
`invoices`	Consulta facturas
`products`	Consulta productos
`stock`	Consulta inventario
`subscriptions`	Consulta suscripciones
`payments`	Consulta pagos
`account-lines`	Líneas contables
`bank-journals`	Diarios bancarios
`bank-statements`	Extractos bancarios
`chart-of-accounts`	Plan de cuentas
`search`	Búsqueda genérica por modelo/dominio
`fields`	Introspección de campos de un modelo
`write`	Escritura genérica (crear/actualizar)

Escritura

El comando write modifica datos. Igual que en el servidor MCP, usa un usuario de Odoo de mínimo privilegio y revisa la operación.

Paridad con el servidor MCP¶

La CLI cubre los flujos frecuentes vía XML-RPC, pero no incluye la capa de compatibilidad completa entre versiones ni la resolución automática de modelos/campos del servidor MCP. Para trabajo entre versiones o instancias Enterprise, prefiere el servidor MCP.

Referencia de skill: /odoo-tools:odoo-setup-cli.