Odoo MCP Improved is a comprehensive implementation of the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) for Odoo ERP systems. It
Odoo MCP Improved MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Odoo MCP Improved is a comprehensive implementation of the Model Context Protocol (MCP) for Odoo ERP systems. It provides a bridge between large language models like Claude and your Odoo instance.
Once Odoo MCP Improved is connected, these are the calls the assistant has available:
search_sales_orders — Search for sales orders with advanced filteringcreate_sales_order — Create a new sales orderanalyze_sales_performance — Analyze sales performance by period, product, or customerget_customer_insights — Get detailed insights about a specific customersearch_purchase_orders — Search for purchase orders with advanced filteringcreate_purchase_order — Create a new purchase orderanalyze_supplier_performance — Analyze supplier performance metricscheck_product_availability — Check stock availability for productscreate_inventory_adjustment — Create inventory adjustment entriesanalyze_inventory_turnover — Calculate and analyze inventory turnover metricssearch_journal_entries — Search for accounting journal entriescreate_journal_entry — Create a new journal entryYou will need 4 environment variables: ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
odoo-mcp-improved on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Odoo MCP Improved's toolset — search_sales_orders, create_sales_order, analyze_sales_performance and 10 more — is a fair guide to whether it matches your workflow. It is maintained by hachecito; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| search_sales_orders | Search for sales orders with advanced filtering |
| create_sales_order | Create a new sales order |
| analyze_sales_performance | Analyze sales performance by period, product, or customer |
| get_customer_insights | Get detailed insights about a specific customer |
| search_purchase_orders | Search for purchase orders with advanced filtering |
| create_purchase_order | Create a new purchase order |
| analyze_supplier_performance | Analyze supplier performance metrics |
| check_product_availability | Check stock availability for products |
| create_inventory_adjustment | Create inventory adjustment entries |
| analyze_inventory_turnover | Calculate and analyze inventory turnover metrics |
| search_journal_entries | Search for accounting journal entries |
| create_journal_entry | Create a new journal entry |
| analyze_financial_ratios | Calculate key financial ratios |
{
"mcpServers": {
"odoo": {
"command": "python",
"args": ["-m", "odoo_mcp"],
"env": {
"ODOO_URL": "https://your-odoo-instance.com",
"ODOO_DB": "your_database",
"ODOO_USERNAME": "your_username",
"ODOO_PASSWORD": "your_password"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| ODOO_URL | Endpoint or connection string the server talks to. | Yes |
| ODOO_DB | Configuration value read at startup. | Optional |
| ODOO_USERNAME | Configuration value read at startup. | Optional |
| ODOO_PASSWORD | Configuration value read at startup. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.