search_sales_ordersLABSCO SUMMARY
The sales corner of Odoo, wired for questions as well as writes.
create_sales_order writes into a live ERP, so the Odoo user you connect as is the real boundary — give it the rights you would give a person doing the same job. analyze_sales_performance is the reason to reach for this rather than a generic database server: it answers on Odoo's own terms instead of making you join tables.
What it is
A Python server that connects to an Odoo ERP over XML-RPC and exposes its data, with tools, resource URIs and prompts across sales, purchasing, inventory and accounting.
What you get
- search_sales_orders to find orders, create_sales_order to raise one
- analyze_sales_performance for the analytical view over sales rather than a raw list
- Data access across Odoo modules through the same XML-RPC connection
- Standardised resource URIs for Odoo data
- Pre-configured prompts for common business scenarios
- Errors returned with a message and validation rather than a bare XML-RPC fault
Requirements
A Python version the project supports, and an Odoo instance reachable over XML-RPC with credentials for it. Installable from PyPI as odoo-mcp-improved.
Setup effort
One command plus credentials — pip install odoo-mcp-improved, then supply credentials
USE CASES
01
Finding an order a customer is asking about
Search the sales orders from the conversation rather than opening Odoo and filtering by hand.
02
Raising an order from a conversation that just happened
Create it directly — the connection acts as the Odoo user whose credentials you configured.
03
Answering how sales are trending
Run the analysis rather than exporting orders and building a pivot table.
04
Checking a customer's history before a call
Search their past orders and read the performance view for the period they were active.
13 tools
Listed in project docs. Your client may show a different list.
create_sales_orderanalyze_sales_performanceget_customer_insightssearch_purchase_orderscreate_purchase_orderanalyze_supplier_performancecheck_product_availabilitycreate_inventory_adjustmentanalyze_inventory_turnoversearch_journal_entriescreate_journal_entryanalyze_financial_ratiosBEFORE YOU INSTALL
What to know first
Tools you get
13 tools named in the project's documentation.
Requires
- python on PATH
- ODOO_PASSWORD in your environment
- ODOO_USERNAME in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install odoo-mcp-improvedMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"odoo": {
"command": "python",
"args": [
"-m",
"odoo_mcp"
],
"env": {
"ODOO_URL": "<YOUR_ODOO_URL>",
"ODOO_DB": "<YOUR_ODOO_DB>",
"ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
"ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>"
}
}
}
}
