Odoo
Read-only Odoo access to late orders, supplier promise dates, work orders and stock
- Pricing
- Open source
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About Odoo
Odoo is an open-source MCP server for manufacturing. It runs locally on your machine and is started by your AI client.
The questions this server answers are operational ones: which purchase order lines are late and by how many days, what a supplier has promised, which manufacturing orders lack components. It reads Odoo sales, purchasing, manufacturing and inventory through Odoo's external JSON-RPC API as the user you configure, so Odoo's own access rights apply.
There are 12 read tools and one write tool, update_po_line_promise_date, which changes the expected arrival date of a single purchase order line. The write runs only if the server has ODOO_MCP_ENABLE_WRITES=true and the call carries an exact confirmation text. List tools take limit and offset, and results add computed fields such as days_late.
The maintainers tested it with Odoo Community 17.0, 18.0 and 19.0 and list untested areas, including Odoo Online, Enterprise and multi-company setups. It needs Node.js 20 or newer, runs locally over stdio and sends no telemetry.
Install
Run in a terminal
claude mcp add odoo-mcp --env ODOO_URL='<ODOO_URL>' --env ODOO_DB='<ODOO_DB>' --env ODOO_USERNAME='<ODOO_USERNAME>' --env ODOO_API_KEY='<ODOO_API_KEY>' --env ODOO_PASSWORD='<ODOO_PASSWORD>' -- npx -y @heliosone/odoo-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"odoo-mcp": {
"command": "npx",
"args": [
"-y",
"@heliosone/odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_API_KEY": "<ODOO_API_KEY>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"odoo-mcp": {
"command": "npx",
"args": [
"-y",
"@heliosone/odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_API_KEY": "<ODOO_API_KEY>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"odoo-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@heliosone/odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_API_KEY": "<ODOO_API_KEY>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"odoo-mcp": {
"command": "npx",
"args": [
"-y",
"@heliosone/odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_API_KEY": "<ODOO_API_KEY>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"odoo-mcp": {
"command": "npx",
"args": [
"-y",
"@heliosone/odoo-mcp"
],
"env": {
"ODOO_URL": "<ODOO_URL>",
"ODOO_DB": "<ODOO_DB>",
"ODOO_USERNAME": "<ODOO_USERNAME>",
"ODOO_API_KEY": "<ODOO_API_KEY>",
"ODOO_PASSWORD": "<ODOO_PASSWORD>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ODOO_URLOdoo base URL, e.g. https://odoo.example.comRequiredODOO_DBOdoo database nameRequiredODOO_USERNAMEOdoo login (user email)RequiredODOO_API_KEYOdoo API key for that user (or set ODOO_PASSWORD instead)ODOO_PASSWORDOdoo password, if no API key is usedODOO_MCP_ENABLE_WRITESSet to true to allow the one write tool (still needs a confirmation text per call)
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- list_open_sales_orders
- Confirmed sales orders not fully delivered
- list_open_purchase_orders
- Confirmed purchase orders not fully received
- get_order_status
- One sales or purchase order with lines and transfers
- list_supplier_promise_dates
- Open PO lines with the vendor's expected arrival date
- list_late_purchase_lines
- PO lines past their expected arrival, with days_late
- list_late_sales_lines
- Sales lines past their promised date, with days_late
- list_manufacturing_orders
- Manufacturing orders with state, quantity, dates and component availability
- list_work_orders
- Work orders with operation, work center, state and durations
- list_shipments
- Receipts, deliveries or internal transfers, optionally only late ones
- 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 and outgoing
- update_po_line_promise_date
- Write: sets one PO line's expected arrival date
What it does
- Late line reports
- Lists purchase and sales lines past their dates with days_late.
- Supplier promise dates
- Shows vendors' expected arrival dates, soonest first.
- Manufacturing view
- Manufacturing orders and work orders with state and durations.
- Inventory lookup
- On hand, forecast, incoming and outgoing quantities.
- Guarded write
- One write tool that needs a server flag and a confirmation text.
- Documented testing
- Tested against Odoo Community 17, 18 and 19, with untested areas listed.
Good for
- Find which purchase lines are late and by how much
- Check the status of a sales order by number
- Look up a supplier or customer by VAT or reference
- Review manufacturing component availability
- Record a new vendor-confirmed arrival date
Pricing
Open source
MIT licence
Odoo FAQ
Is it read-only?
By default yes. The single write tool needs ODOO_MCP_ENABLE_WRITES=true and a confirmation text on each call.
Which Odoo versions were tested?
Community 17.0, 18.0 and 19.0.
Does it work with Odoo Online?
That is listed as not tested, and Odoo Online offers the external API only on some plans.
How does it log in?
With an Odoo user and an API key, or a password.
Is Odoo free?
Yes. Odoo is open source, so you can use and self-host it for free.
How do I add Odoo to Claude Code?
Run this command in your terminal: claude mcp add odoo-mcp --env ODOO_URL='<ODOO_URL>' --env ODOO_DB='<ODOO_DB>' --env ODOO_USERNAME='<ODOO_USERNAME>' --env ODOO_API_KEY='<ODOO_API_KEY>' --env ODOO_PASSWORD='<ODOO_PASSWORD>' -- npx -y @heliosone/odoo-mcp
What are the best alternatives to Odoo?
The closest alternatives to Odoo are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Tapetide - Indian Stock Market MCP and World Monitor.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

