Skip to content

Odoo Tools — Introduction

MCP-Odoo-Tools is a Claude Code / Cowork plugin that unifies access to Odoo in a single installation: an MCP server (main surface) and a fallback CLI. It works with Odoo Community, Enterprise and online (SaaS), from version 10 through 19, thanks to a compatibility layer that automatically resolves the model and field names that change between versions.

It is built and maintained by Transgenia, registered partner of Anthropic (Registered tier). It is an independent open-source project with an MIT license — it is not a certified nor first-party product of Anthropic, and it is not yet approved in the official plugin directory.

What it solves

Odoo model and field names change between versions:

  • account.invoice became account.move in v13.
  • The analytic fields changed in v16 (analytic_account_id → analytic_distribution).
  • The package models changed around v19.
  • The behavior of API keys over /jsonrpc changed in v17.

In addition, Enterprise includes models that Community does not have. For an AI agent, each of these differences is a silent point of failure: it calls the old name, the ERP responds with an error, and the agent cannot tell whether it is a permissions, network or version problem.

This plugin absorbs those differences behind a single stable tool surface, so you do not have to branch your code by version.

The two surfaces

Surface When to use it Requirements
MCP server (recommended) Normal use from Claude Code/Cowork: 18 tools + full compatibility layer uv/uvx (brings its own Python) or Python 3.11+
Fallback CLI When you cannot run the MCP server, or for batch access from scripts Node.js 18+

Scope (public vs. private)

This is the public generic core: it talks to Odoo and nothing else. Any localization, governance or client-specific engine (per-country electronic invoicing, approval flows, backups, document AI) is deliberately left out of this repository and offered as part of Transgenia's supervised implementations.

Next step

Continue with the Installation or jump straight to the guided Quickstart.

Implementation support

Need help connecting it to your Odoo or a custom AI/ERP integration? Transgenia offers AI and Odoo implementation services. Write to us at dev@transgenia.org.