Odoo MCP Improved

Odoo MCP Server with advanced tools for sales, stock, and more.

python

33

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hachecito-odoo-mcp-improved": {
      "command": "python",
      "args": [
        "-m",
        "odoo_mcp"
      ],
      "env": {
        "ODOO_DB": "your_database",
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_PASSWORD": "your_password",
        "ODOO_USERNAME": "your_username"
      }
    }
  }
}

Odoo MCP Improved is a dedicated MCP server that bridges Claude and your Odoo ERP instance, enabling AI-powered assistants to query and operate data across sales, purchases, inventory, and accounting. It provides structured tool access, standardized data URIs, and robust execution around Odoo modules, helping you automate and analyze business processes with confidence.

How to use

To use this MCP server, run the local MCP process and connect your AI assistant client to the MCP endpoint described in your configuration. The server exposes a set of tools that enable sales, purchasing, inventory, and accounting operations against your Odoo data. Your client can issue natural language queries or prompts that map to the available tools, and the MCP server will execute the corresponding actions against Odoo via XML-RPC and return structured results.

How to install

Prerequisites: you need Python installed on your system. You also need network access to your Odoo instance if you plan to run the MCP server against a remote Odoo deployment.

Step 1: Install the MCP package from Python's package index.

pip install odoo-mcp-improved

How to run the server

Start the MCP server using the module invocation shown in the configuration snippet.

python -m odoo_mcp

Available tools

search_sales_orders

Search sales orders with advanced filtering to locate orders by status, date, customer, or total value.

create_sales_order

Create a new sales order in Odoo with specified customer, products, quantities, and dates.

analyze_sales_performance

Analyze sales performance across periods, products, or customers to identify trends.

get_customer_insights

Retrieve detailed insights about a specific customer, including purchase history and payment patterns.

search_purchase_orders

Search purchase orders with advanced filtering to locate orders by supplier, date, or amount.

create_purchase_order

Create a new purchase order against a supplier with line items and delivery details.

analyze_supplier_performance

Evaluate supplier performance using metrics such as delivery times and order accuracy.

check_product_availability

Check stock availability for given products across warehouses.

create_inventory_adjustment

Record inventory adjustments to correct stock levels.

analyze_inventory_turnover

Compute and analyze inventory turnover metrics to assess efficiency.

search_journal_entries

Query accounting journal entries by date, account, or amount.

create_journal_entry

Create a new journal entry with the appropriate debits and credits.

analyze_financial_ratios

Calculate key financial ratios from the latest period's data.