odoo-sh-mcp 0.3.0

MCP server for Odoo SH — exposes ORM metadata, views, modules and logs to Claude Code via XML-RPC

odoo-sh-mcp

MCP server for Odoo SH that gives Claude Code full access to your Odoo instance via XML-RPC: inspect the ORM, read and write business records, manage modules, and tail server logs.

What it does

Claude Code (your machine)
       ↓ MCP protocol (stdio)
odoo-sh-mcp (Python, local)
       ↓ XML-RPC
Odoo SH (remote instance)

No SSH. No direct DB access. Only the XML-RPC API Odoo already exposes.

Tools

Tier 1 — ORM introspection

Tool	Description
get_model_fields	All fields for a model: type, label, required, relation, compute
get_model_info	Model metadata: description, modules, inherited models
search_models	Find models by partial name or description
search_records	Search and read records from any model
create_record	Create a new record in any model
update_record	Update fields of an existing record by ID
delete_record	Delete a record by ID

Tier 2 — View inspection

Tool	Description
get_views	Full XML arch of all views (or a specific type) for a model
get_view_by_xmlid	Resolve an xmlid and return its full arch
find_field_in_view	Find which views contain a field and at which line

Tier 3 — Local scaffold (no Odoo connection)

Tool	Description
scaffold_module	Create a minimal module skeleton on disk
create_model_file	Generate a Python model file inside an existing module
create_view_inheritance	Generate an XML view inheritance file

Tier 4 — Module management

Tool	Description
list_modules	List modules with state and version
install_module	Install a module via XML-RPC
upgrade_module	Upgrade an installed module via XML-RPC

Tier 5 — Logs

Tool	Description
get_server_logs	Fetch recent server logs from ir.logging

Installation

# With uv (recommended)
uvx odoo-sh-mcp

# Or with pip
pip install odoo-sh-mcp

Configuration

Single instance

claude mcp add odoo-mycompany uvx odoo-sh-mcp \
  -e ODOO_URL=https://mycompany.odoo.com \
  -e ODOO_DB=mycompany \
  -e ODOO_API_KEY=your_key_here \
  -e ODOO_USERNAME=[e-mail]

Multi-instance

Ejecuta el comando una vez por cada instancia:

claude mcp add odoo-company-a uvx odoo-sh-mcp \
  -e ODOO_URL=https://company-a.odoo.com \
  -e ODOO_DB=company-a \
  -e ODOO_API_KEY=xxx \
  -e ODOO_USERNAME=[e-mail]

claude mcp add odoo-company-b uvx odoo-sh-mcp \
  -e ODOO_URL=https://company-b.odoo.com \
  -e ODOO_DB=company-b \
  -e ODOO_API_KEY=yyy \
  -e ODOO_USERNAME=[e-mail]

O edita directamente .claude/mcp.json:

{
  "mcpServers": {
    "odoo-company-a": {
      "command": "uvx",
      "args": ["odoo-sh-mcp"],
      "env": {
        "ODOO_URL": "https://company-a.odoo.com",
        "ODOO_DB": "company-a",
        "ODOO_API_KEY": "xxx",
        "ODOO_USERNAME": "[e-mail]"
      }
    },
    "odoo-company-b": {
      "command": "uvx",
      "args": ["odoo-sh-mcp"],
      "env": {
        "ODOO_URL": "https://company-b.odoo.com",
        "ODOO_DB": "company-b",
        "ODOO_API_KEY": "yyy",
        "ODOO_USERNAME": "[e-mail]"
      }
    }
  }
}

Environment variables

Variable	Required	Description
ODOO_URL	Yes	Instance URL, e.g. https://mycompany.odoo.com
ODOO_DB	Yes	Database name
ODOO_API_KEY	Yes*	API key (Settings > Technical > API Keys)
ODOO_USERNAME	Yes*	email address for API key auth
ODOO_PASSWORD	No	Password if not using API key

*API keys available in Odoo 14+. For older versions use ODOO_USERNAME + ODOO_PASSWORD.

Development

git clone https://github.com/nicoruiz/odoo-sh-mcp
cd odoo-sh-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e "." pytest pytest-asyncio
pytest tests/ -v

License

MPL-2.0