Skip to content
MCP server

Odoo

Read-only Odoo access to late orders, supplier promise dates, work orders and stock

Runs locallyStatus and history
Install
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-mcp

Add 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.comRequired
  • ODOO_DBOdoo database nameRequired
  • ODOO_USERNAMEOdoo login (user email)Required
  • ODOO_API_KEYOdoo API key for that user (or set ODOO_PASSWORD instead)
  • ODOO_PASSWORDOdoo password, if no API key is used
  • ODOO_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.

How AIPoweredBot checks servers