Log inSubmit server
MCP Odoo logo

MCP Odoo

by tuanle96

Connects MCP-compatible agents to Odoo 16–19 for read operations, diagnostics, migration analysis, and approval-gated writes.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Odoo

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tuanle96-mcp-odoo": {
      "command": "uvx",
      "args": [
        "odoo-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 41 tools correctly (1mo ago).

Overview

The tuanle96/mcp-odoo MCP server connects MCP-compatible agents to Odoo 16–19 databases through existing Odoo credentials. It uses XML-RPC for Odoo 16–18 and External JSON-2 for Odoo 19+, with support for local stdio or HTTP/SSE operation. Its tools cover record queries, schema discovery, diagnostics, migration checks, addon source scans, aggregation, and controlled write workflows. Reach for it when an agent needs structured Odoo access without installing an Odoo module or writing custom API scripts.

Use cases

  • Query customers, invoices, and stock levels in Odoo
  • Diagnose failed Odoo calls and inspect upgrade risks
  • Scan local addons before an Odoo migration
  • Review accounting aging and data quality
  • Approve controlled record and chatter writes

Key features

  • Odoo 16–19 connectivity
  • XML-RPC and External JSON-2 support
  • 41 MCP tools and 11 workflow prompts
  • Approval-gated write operations
  • Multi-instance read-only fan-out
  • Local knowledge indexing and search

Tools41

What MCP Odoo lets your agent do. Expand a tool for its parameters.

Verified live~6.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · odoo-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars425Stargazers on the source repository.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed41Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Odoo works

What tuanle96/mcp-odoo MCP server does

The tuanle96/mcp-odoo MCP server exposes Odoo data and operational functions to MCP-compatible agents. It is designed for Odoo Community and Enterprise databases running versions 16 through 19, and does not require an App Store module or other Odoo-side installation. Agents can use it to inspect records and attachments, discover model schemas, construct domains, aggregate data, inspect access rules, and review data quality.

The server also supports operational work such as diagnosing failed Odoo calls, reviewing upgrade risks and logs, resolving model renames, scanning local addon source, and checking migration fit or gaps. Accounting-oriented functions include receivable/payable aging and an accounting health summary. Knowledge indexing and search provide local BM25 search over a bounded record slice without sending indexed data to an embeddings service.

How it works

For Odoo 16–18, requests use XML-RPC. Odoo 19+ can use the External JSON-2 API. The server runs locally through stdio or can provide a local HTTP/SSE endpoint for clients that do not use stdio. A single process can be configured for multiple named Odoo instances, with an optional instance selector on tools and separate schema caches.

Read operations are the default focus. Writes through create, update, and delete paths are blocked unless the deployment enables writes and the request passes the approval workflow. Approved operations require live metadata, explicit confirmation, and a same-session approval token. Chatter posts follow the same gate unless direct chatter mode is enabled. An optional JSONL audit log records write-path events.

Setup and configuration

The documented local installation command is:

text
uvx odoo-mcp --setup

Configuration uses the Odoo connection details and credentials available to the local deployment. Optional controls cover field-level access rules, tool inclusion or exclusion, rate limiting, locale handling, structured logging, write elicitation, chatter behavior, and audit logging.

The project is available as the odoo-mcp Python package and is licensed under MIT. The local server is described as free to run; the separately hosted ERPipe service is a different product and is not required for this repository.

Tools and capabilities

The documented tool surface includes 41 tools and 11 prompts. Capabilities include:

  • Search, read, aggregate, and inspect Odoo records and attachments.
  • Discover schemas, build domains, and apply smart field selection.
  • Diagnose calls, inspect upgrade risk, and generate fit/gap reports.
  • Scan local addon source and review migration-related data quality.
  • Run long read operations as background tasks and poll their status.
  • Query several configured instances with merged, attributed results.
  • Use workflow prompts for invoice approval, purchase-order matching, onboarding, expense review, month-end close, and pre-migration checks.

Limitations and notes

The tuanle96/mcp-odoo MCP server is a self-hosted local Python project, not the managed ERPipe gateway. The README identifies Claude Code and Cursor among its clients; the hosted service has a different remote URL and tool surface. Odoo 19 support depends on the External JSON-2 path, while earlier versions use XML-RPC. Write access is intentionally restricted by default workflow controls, so read-only deployments are the safer starting point for evaluation.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Odoo

Run `uvx odoo-mcp --setup` for the local Python server.

No. The repository is described as requiring no App Store module or other Odoo-side installation.

It supports Odoo 16 through 19. XML-RPC is used for versions 16–18, and External JSON-2 is available for Odoo 19+.

Yes, but create, update, delete, and gated chatter operations require the configured write gate, explicit confirmation, and an approval token.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Odoo AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tuanle96-mcp-odoo?style=directory)](https://allmcps.com/mcp/tuanle96-mcp-odoo)
HTML Embed
<a href="https://allmcps.com/mcp/tuanle96-mcp-odoo"><img src="https://allmcps.com/api/badge/tuanle96-mcp-odoo?style=directory" alt="MCP Odoo on AllMCPs" /></a>