Odoo

Odoo orders, late lines, supplier promise dates, manufacturing and stock. Read-only by default.

What can you do with Odoo?

the server was started with ODOO_MCP_ENABLE_WRITES=true, and
the call includes "confirmation": "CONFIRM update_po_line_promise_date".

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @heliosone/odoo-mcp

Claude Code

claude mcp add odoo -e 'ODOO_URL=<ODOO_URL>' -e 'ODOO_DB=<ODOO_DB>' -e 'ODOO_USERNAME=<ODOO_USERNAME>' -e 'ODOO_API_KEY=<your odoo_api_key>' -e 'ODOO_PASSWORD=<your odoo_password>' -e 'ODOO_MCP_ENABLE_WRITES=false' -- npx -y @heliosone/odoo-mcp@0.1.0

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "odoo": {
            "command": "npx",
            "args": [
                "-y",
                "@heliosone/odoo-mcp@0.1.0"
            ],
            "env": {
                "ODOO_URL": "<ODOO_URL>",
                "ODOO_DB": "<ODOO_DB>",
                "ODOO_USERNAME": "<ODOO_USERNAME>",
                "ODOO_API_KEY": "<your odoo_api_key>",
                "ODOO_PASSWORD": "<your odoo_password>",
                "ODOO_MCP_ENABLE_WRITES": "false"
            }
        }
    }
}

Environment variables

ODOO_URL required Odoo base URL, e.g. https://odoo.example.com
ODOO_DB required Odoo database name
ODOO_USERNAME required Odoo login (user email)
ODOO_API_KEY secret Odoo API key for that user (or set ODOO_PASSWORD instead)
ODOO_PASSWORD secret Odoo password, if no API key is used
ODOO_MCP_ENABLE_WRITES Set to true to allow the one write tool (still needs a confirmation text per call)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

Odoo MCP server
Quickstart (2 minutes)
Settings
Tools
What has been tested
Development
Security
License

Odoo MCP server

An MCP server that lets an AI assistant (Claude Desktop, Claude Code, or any MCP client) read your Odoo sales, purchasing, manufacturing and stock data, and, only if you turn it on, update a purchase order line's promise date.

12 read tools and 1 write tool (listed below).
Read-only by default. The write tool needs ODOO_MCP_ENABLE_WRITES=true on the server and an exact confirmation text on every call.
Talks to Odoo's external JSON-RPC API (/jsonrpc) as the user you configure. Odoo's access rights apply.
Runs locally over stdio. No telemetry; it connects only to your Odoo.

Built by Helios One. MIT license.

Quickstart (2 minutes)

You need Node.js 20 or newer and an Odoo user that can log in to the external API.

1. Get an API key in Odoo (recommended over a password): click your avatar, then My Profile / Preferences, open Account Security, click New API Key. Copy the key.

2. Add the server to your MCP client.

Claude Code:

claude mcp add odoo \
  -e ODOO_URL=https://odoo.example.com \
  -e ODOO_DB=mydb \
  -e ODOO_USERNAME=me@example.com \
  -e ODOO_API_KEY=your-api-key \
  -- npx -y @heliosone/odoo-mcp

Claude Desktop: open Settings > Developer > Edit Config and add this to claude_desktop_config.json, then restart Claude Desktop:

{
  "mcpServers": {
    "odoo": {
      "command": "npx",
      "args": ["-y", "@heliosone/odoo-mcp"],
      "env": {
        "ODOO_URL": "https://odoo.example.com",
        "ODOO_DB": "mydb",
        "ODOO_USERNAME": "me@example.com",
        "ODOO_API_KEY": "your-api-key"
      }
    }
  }
}

3. Ask, for example: "Which purchase order lines are late, and by how many days?" or "What is the status of S00042?"

Settings

Variable	Required	Meaning
`ODOO_URL`	yes	Base URL of your Odoo, e.g. `https://odoo.example.com`
`ODOO_DB`	yes	Database name
`ODOO_USERNAME`	yes	The user's login
`ODOO_API_KEY`	one of these two	API key of that user (used in place of the password)
`ODOO_PASSWORD`		The user's password
`ODOO_MCP_ENABLE_WRITES`	no	`true` allows the write tool. Anything else keeps the server read-only.
`ODOO_TIMEOUT_MS`	no	Request timeout, default 30000

The server starts even when settings are missing, so your client can list the tools. Each call then returns CONFIGURATION_ERROR with the names of the missing settings.

Tools

Tool	What it returns
`list_open_sales_orders`	Confirmed sales orders not fully delivered (`includeQuotations` adds quotations)
`list_open_purchase_orders`	Confirmed purchase orders not fully received (`includeRfqs` adds RFQs)
`get_order_status`	One sales or purchase order with lines (ordered / delivered or received / invoiced) and its transfers. By id, number or customer/vendor reference.
`list_supplier_promise_dates`	Open lines on confirmed POs with the vendor's expected arrival date, soonest first
`list_late_purchase_lines`	PO lines past their expected arrival and not fully received, with `days_late`
`list_late_sales_lines`	Sales lines past their promised date and not fully delivered, with `days_late`. Promised date = the order's commitment date, else order date + the line's lead time.
`list_manufacturing_orders`	Manufacturing orders with state, quantity, planned dates, component availability
`list_work_orders`	Work orders: operation, work center, state, expected and actual duration
`list_shipments`	Receipts, deliveries or internal transfers; `lateOnly` for those past their scheduled date
`lookup_customer`	Contacts by name, email, reference or VAT, customers first
`lookup_supplier`	Contacts by name, email, reference or VAT, suppliers first
`get_inventory_on_hand`	Product quantities: on hand, forecast, incoming, outgoing
`update_po_line_promise_date`	Write. Sets one PO line's expected arrival date. See below.

List tools take limit (default 50, max 500) and offset. Results are Odoo's own field values, plus a few computed fields (qty_open, days_late, promised_date). Fields that do not exist in your Odoo version are left out.

The write tool

update_po_line_promise_date changes date_planned on one purchase order line (for example after a vendor confirms a new date). It runs only when both are true:

the server was started with ODOO_MCP_ENABLE_WRITES=true, and
the call includes "confirmation": "CONFIRM update_po_line_promise_date".

Otherwise it returns WRITES_DISABLED or CONFIRMATION_REQUIRED and does not call Odoo. A date without a time is stored as 12:00 UTC so it shows as the same day in most time zones. The result shows the value before and after.

What has been tested

Tested on 24 October 2026, with the packed npm tarball installed into an empty project and its odoo-mcp command driven over stdio by the official MCP TypeScript SDK client, against fresh self-hosted Odoo Community 17.0, 18.0 and 19.0 (built from the official odoo/odoo branches; Sales, Purchase, Inventory and Manufacturing installed; fictional records). In each version:

all 13 tools were listed and all 12 read tools returned the seeded records (21 tool calls and 25 checks per version, all passed);
the write tool was refused with writes off (WRITES_DISABLED), refused without the confirmation text (CONFIRMATION_REQUIRED), then succeeded, and a direct Odoo read confirmed the new date;
the server logged in with an Odoo API key; one session used the plain password instead, and a wrong password returned AUTH_FAILED;
one call also went through the MCP Inspector CLI.

Logs: proof/. Unit tests (npm test, against an in-memory fake Odoo) pass on Node.js 20 and 25.

Not tested: Odoo Online (odoo.com hosting) and Odoo.sh, Odoo Enterprise, Odoo versions before 17, multi-company setups, and large databases. Odoo Online offers the external API only on some plans. Odoo 19 deprecated /jsonrpc (removal planned for Odoo 22, fall 2028, and Odoo Online 21.1, winter 2027) in favour of its JSON-2 API; this server does not use JSON-2 yet. Odoo 19 logs a deprecation warning for each /jsonrpc call.

Development

npm ci
npm test

proof/run-live.sh 18.0 repeats the live test in a disposable Linux machine (it installs PostgreSQL and Odoo; do not run it on your workstation).

Security

See SECURITY.md. Use a dedicated Odoo user with only the rights the assistant needs.

License

MIT, see LICENSE.

Frequently asked questions

What is Odoo?

Odoo orders, late lines, supplier promise dates, manufacturing and stock. Read-only by default.

How do I install Odoo?

It runs on your machine. In Claude Code: claude mcp add odoo -e 'ODOO_URL=<ODOO_URL>' -e 'ODOO_DB=<ODOO_DB>' -e 'ODOO_USERNAME=<ODOO_USERNAME>' -e 'ODOO_API_KEY=<your odoo_api_key>' -e 'ODOO_PASSWORD=<your odoo_password>' -e 'ODOO_MCP_ENABLE_WRITES=false' -- npx -y @heliosone/odoo-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Odoo need an API key?

Yes. It expects ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_API_KEY, ODOO_PASSWORD, which you set in its configuration.

Is Odoo open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Odoo?

It is published by Helios-One-Oy. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: Helios-One-Oy
Category: Finance and payments
Runs: Local
GitHub stars: ★ 0
License: MIT
Language: JavaScript
Last commit: Oct 27, 2026
Open issues: 0
Version: 0.1.0
Published: Oct 27, 2026

io.github.Helios-One-Oy/odoo-mcp

Similar servers

Neblla The backend and back office for apps your AI writes: accounts, data, payments, content,...
Bullion API Read-only gold and precious-metal prices, central-bank gold and macro data. OAuth sign-in.
Celo MCP Server Query Celo blockchain data: blocks, tokens, NFTs, contracts, governance and staking
US Freelancer Tax Calculator 2026 2026 US freelancer tax: quarterly estimates, SE tax, mileage, home office, SEP/401(k), ...
Alchemy MCP Server Blockchain data across 100+ chains: token prices, NFTs, transfers, simulation, traces, ...
Eclipse Insurepack Fixture cyber-insurance evidence assembly with change receipts; local only, not underwr...
Privi Quantum Quantum runs on IonQ/IBM/Braket with signed advantage receipts, crypto inventory (CBOM)...
Senaro Personal Finance Credit card payoff, mortgages, refinancing, 401(k), rent vs buy. Every rule and default...

Finance and payments