Odoo MCP Server

Connect AI agents to your Odoo instance. Query, create, update, and delete records from Claude, Cursor, or Windsurf.

What is it?

Odoo MCP Server is a lightweight bridge between AI agents and Odoo ERP. It implements the Model Context Protocol so tools like Claude Code, Cursor, and Windsurf can talk directly to your Odoo instance.

One Python file. No framework. No build step.

What can it do?

Query records from any Odoo model with full domain filtering
Create, update, delete records programmatically
Execute model methods (confirm orders, post invoices, trigger workflows)
Discover models and fields on your instance
Diagnose instance health with built-in checks

How it works

AI Agent (Claude, Cursor, Windsurf)
    ↕  MCP Protocol (stdio)
Odoo MCP Server (Python)
    ↕  JSON-RPC (v17-18) or JSON-2 API (v19+)
Odoo Instance

The server auto-detects your Odoo version and uses the right protocol. Odoo 17-18 uses JSON-RPC with username/password. Odoo 19+ prefers the JSON-2 API with API keys.

Quick install

# Clone
git clone https://github.com/oconsole/odoo-mcp-server.git

# Run with uv (auto-installs dependencies)
ODOO_URL=https://my.odoo.com ODOO_DB=mydb ODOO_USER=admin ODOO_PASSWORD=secret \
  uv run odoo_mcp_server.py

See Installation for full setup with Claude Code, Cursor, and Windsurf.