Fallback CLI¶
The CLI is a lightweight XML-RPC client (Node.js only, no Python). Use it when the MCP server cannot run in your environment, or for batch access from scripts. The MCP server remains the primary and most complete surface.
When to use it¶
- You do not have
uvor Python 3.11+ available. - You need scriptable/batch access from a terminal or pipeline.
- A restricted environment where only Node is available.
Installation¶
Requires Node.js 18+:
If missing: nodejs.org (LTS), brew install node or
apt install nodejs npm. The command installs the CLI in ~/.claude/tools/odoo-cli
and writes a local .env with your credentials.
Usage¶
Example:
Available commands¶
The CLI includes 13 commands geared toward the most common Odoo flows:
| Command | What it does |
|---|---|
contacts |
Query contacts (res.partner) |
invoices |
Query invoices |
products |
Query products |
stock |
Query inventory |
subscriptions |
Query subscriptions |
payments |
Query payments |
account-lines |
Accounting lines |
bank-journals |
Bank journals |
bank-statements |
Bank statements |
chart-of-accounts |
Chart of accounts |
search |
Generic search by model/domain |
fields |
Field introspection of a model |
write |
Generic write (create/update) |
Write
The write command modifies data. Just as in the MCP server, use a
least-privilege Odoo user and review the operation.
Parity with the MCP server¶
The CLI covers the frequent flows via XML-RPC, but does not include the full cross-version compatibility layer nor the automatic model/field resolution of the MCP server. For cross-version work or Enterprise instances, prefer the MCP server.
Skill reference: /odoo-tools:odoo-setup-cli.