Skip to main content
Glama
odoo-mcp

odoo-mcp

by affifariza04

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ODOO_DBNoThe Odoo database name.
ODOO_URLNoThe URL of the Odoo instance (e.g. https://your-company.odoo.com). If omitted, the server runs against a built-in demo company.
ODOO_USERNoThe Odoo user email address used to authenticate.
ODOO_API_KEYNoAn Odoo API key (Odoo -> Preferences -> Account Security -> New API Key) used to authenticate.
ODOO_MCP_MODENoServer 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
month_end_reviewMonth-end review: sales vs previous month, overdue invoices to chase, products to reorder.

Resources

Contextual data attached and managed by the client

NameDescription
modelsThe Odoo models this server exposes, and whether writes are enabled.

TDQS

A3.6/5.0

Scored across 6 tools

Disambiguation4/5

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.

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness3/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues