In these docs

Context Layer for Odoo

Introduction.

The Context Layer for Odoo (OCL) is the verified meaning layer between any AI and Odoo. A connector moves data; the context layer tells the AI what the data means, which records count, which fields mislead, and whether an action is safe. This is what it is, what it is not, and where the alpha stands.

Technical alpha · Odoo 19 Updated 2 August 2026

AI gets Odoo wrong for one reason that compounds: Odoo’s technical schema does not explain business meaning. The field names, models, and relations are all there, but nothing in the schema says that account.move is four different business documents, that amount_total is not a universal revenue metric, or that a stock quantity means nothing without a warehouse. Hand an AI the raw schema and it will answer confidently and, often, wrongly.

The Context Layer for Odoo (working label OCL) is the fix. It is a verified meaning layer that sits between any AI and Odoo.

Connector = transport      moves data in and out of Odoo
OCL       = meaning         says what the data means and which records count
AI        = reasoning       answers or acts, with fewer unsupported assumptions

A question flows through all three:

question
  -> the connector exposes Odoo
  -> OCL supplies the smallest verified context for that question
  -> the AI answers or acts, with fewer unsupported assumptions

What OCL tells an AI

  • what Odoo records mean;
  • which records count;
  • which tempting fields or interpretations are wrong;
  • which filters and joins matter;
  • which company, currency, and security boundaries apply;
  • when ambiguity must be clarified;
  • when a write is unsafe.

Each of those is a different kind of knowledge, and each fact is proven, not asserted by a language model. See Verification and trust.

What OCL is not

  • not a chatbot;
  • not another connector;
  • not generic RAG over Odoo documentation;
  • not a replacement for Odoo permissions;
  • not a claim that AI-generated writes are automatically safe;
  • not a complete ontology for every Odoo module.

Connector-independent, model-independent

OCL does not move data and does not reason. It supplies meaning to whatever connector moves the data and whatever model does the reasoning. It works alongside your stack, not instead of it.

Where the alpha stands

This is an early technical alpha targeting Odoo 19 only (Community and Enterprise). A released semantic kernel exists, with executable verification, immutable content-hashed releases, provenance, deterministic retrieval over released content, and risk-preserving context assembly. The consumption surfaces (MCP, REST, Python, TypeScript, static context packs, signed offline caches) are implemented.

The open standard is public today at github.com/Nantiai/ocl-standard (Apache-2.0): clone it and, in minutes, run the CLI and wire an example MCP server over ten candidate entries. See the Quickstart. The verified 44-entry runtime over your real Odoo 19 data comes with runtime access.

It is honest about its edges: the tenant system is an implemented foundation, not a finished hosted product; the benchmark is designed and running but its independent scoring is not yet published; and “context layer” is a working category label, not a final name. For the current state in detail, see Coverage and release status and Current limitations.

Where to go next