odoo-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ODOO_DB | No | The Odoo database name. | |
| ODOO_URL | No | The URL of the Odoo instance (e.g. https://your-company.odoo.com). If omitted, the server runs against a built-in demo company. | |
| ODOO_USER | No | The Odoo user email address used to authenticate. | |
| ODOO_API_KEY | No | An Odoo API key (Odoo -> Preferences -> Account Security -> New API Key) used to authenticate. | |
| ODOO_MCP_MODE | No | Server mode. Use "readwrite" to enable write tools such as create_quotation; defaults to "readonly". | readonly |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Tools for an Odoo ERP. Prefer the business tools (find_customers, check_stock, sales_report, overdue_invoices) over search_records. Amounts are in the company currency. create_quotation asks the human to confirm before anything is written.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_recordsB | Generic read: Odoo search_read on an allowed model. Domain uses Odoo syntax, e.g. [["state","=","sale"],["amount_total",">",1000000]]. |
| find_customersB | Find customers by (part of) their name, email or city. |
| check_stockB | On-hand quantity per product, flagged ok / low / out. Use only_low=true for a reorder list. |
| sales_reportA | Confirmed sales between two ISO dates (inclusive), grouped by month, customer or product. |
| overdue_invoicesB | Posted customer invoices past their due date that are not fully paid, most overdue first. |
| create_quotationA | Create a DRAFT sales quotation. The human sees a summary and must confirm; nothing is confirmed or sent. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| month_end_review | Month-end review: sales vs previous month, overdue invoices to chase, products to reorder. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| models | The Odoo models this server exposes, and whether writes are enabled. |
TDQS
Scored across 6 tools
The specialized tools (find_customers, check_stock, sales_report, overdue_invoices) each target a distinct task, and create_quotation is clearly a write action. The main overlap is that search_records can also read customers, stock, and invoices, but the generic-vs-specific distinction is understandable.
Four tools follow a clear verb_noun pattern (search_records, find_customers, check_stock, create_quotation), while sales_report and overdue_invoices use noun-phrase report naming. The mix is readable but not a single consistent convention.
Six tools is a well-scoped set for a focused sales/customer/stock assistant. Each tool covers a meaningful operation without feeling thin or bloated.
The server covers reads well through generic search plus focused customer, stock, sales, and invoice queries, and it offers a safe draft quotation creation. However, there is no way to update customers or quotations, confirm/send orders, or manage invoices, leaving notable lifecycle gaps.