MCP.Market

Odoo MCP server

by nicolasramos·io.github.nicolasramos/odoo-mcp·v1.0.1·5 stars
No reviews yet

MCP server for Odoo 18 with 38 business tools

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
Growing

5 stars12 downloads/wk

Reviews

Write one

Nobody has reviewed Odoo yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Odoo tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 43 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Odoo compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 57% of 48,255 servers
GitHub stars
5
more than 83% of 28,688 servers
Downloads a week
12
more than 3% of 12,191 servers with a package

Install Odoo in Claude Code, Cursor or VS Code

claude mcp add odoo-mcp -- uvx odoo-18-mcp-server
Add to Cursor

What the publisher says

From the Odoo repository's README, as published. We do not edit it. Read it on GitHub

OdooClaw MCP

Standalone MCP (Model Context Protocol) server for Odoo 18 over stdio.

MCP name: io.github.nicolasramos/odooclaw-mcp PyPI package: odooclaw-mcp Official CLI: odooclaw-mcp

Backward-compatible aliases are also installed:

  • odoo-mcp
  • odoo-mcp-server
  • odoo-18-mcp-server

Quick Start

1) Install

pip install odooclaw-mcp

From source:

git clone https://github.com/nicolasramos/odooclaw-mcp.git
cd odooclaw-mcp
pip install -e .

2) Configure environment

cp .env.example .env

Required:

ODOO_URL=https://yourcompany.odoo.com
ODOO_DB=your_database
ODOO_USERNAME=your_username
ODOO_PASSWORD=your_password

Optional:

ODOO_MCP_DEFAULT_LIMIT=50
ODOO_MCP_MAX_LIMIT=80
LOG_LEVEL=INFO

3) Validate and run

odooclaw-mcp --check-config
odooclaw-mcp

Alternative:

python -m odoo_mcp

MCP Client Configuration (stdio)

{
  "mcpServers": {
    "odoo": {
      "command": "odooclaw-mcp",
      "env": {
        "ODOO_URL": "https://yourcompany.odoo.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_password",
        "ODOO_MCP_DEFAULT_LIMIT": "50",
        "ODOO_MCP_MAX_LIMIT": "80"
      }
    }
  }
}

Tool call payload contract

When calling tools through the MCP protocol, arguments must be wrapped in a top-level payload object.

Valid shape:

{
  "name": "odoo_search",
  "arguments": {
    "payload": {
      "model": "res.partner",
      "domain": [["customer_rank", ">", 0]],
      "limit": 3
    }
  }
}

If payload is omitted, validation fails with an error equivalent to Field required: payload.

Scope

  • 85 MCP tools for Odoo operations (CRUD + business actions + migration workflows)
  • Pydantic validation for all tool payloads
  • Odoo 18 compatibility helpers (customerrank / supplierrank / payment_state)
  • Security guards (model allowlist, denylisted fields, action guard, unlink blocked)
  • Structured logging and audit actions

Available Tools

The server currently exposes 85 MCP tools.

Note: the grouped tables below focus on common/high-value tools. Use MCP

list_tools to inspect the full live tool catalog for your installed version.

Core record operations

Partners, sales, and CRM

Accounting, purchasing, and payments

Projects, activities, and chatter

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Odoo: common questions

Is Odoo MCP server safe?
Mostly: it is graded B (78/100). Read the Odoo safety report
How do I install Odoo?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Odoo need an API key?
Yes. The registry entry asks for ODOO_PASSWORD.
Is Odoo maintained?
The last commit was 81 days ago (2026-08-15). The latest release is v1.0.1.
How does Odoo compare with other MCP servers?
safety score 78/100 (higher than 57% of 48,255 servers); github stars 5 (more than 83% of 28,688 servers); downloads a week 12 (more than 3% of 12,191 servers with a package). Full comparison.