# Odoo

> Odoo is an open-source MCP server for manufacturing. Read-only Odoo access to late orders, supplier promise dates, work orders and stock. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/helios-one-oy/odoo-mcp-server
- **MCP Registry name:** io.github.Helios-One-Oy/odoo-mcp
- **Categories:** [manufacturing](https://ai-powered.com/categories/manufacturing), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [Plausible](https://ai-powered.com/mcp/plausible): Plausible is a freemium MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/odoo-2
