MCP Odoo Shell

A Model Context Protocol (MCP) server that provides access to an Odoo shell environment.

Overview

This MCP server acts as a bridge between MCP clients and Odoo, allowing execution of Python code within an Odoo database context. It maintains a persistent Odoo shell subprocess and provides tools for code execution, model introspection, and session management.

Related MCP server: Panda Odoo MCP Server

Installation

# Install dependencies
uv sync --dev

# Install the package
uv pip install -e .

Configuration

Set these environment variables:

• ODOO_BIN_PATH: Path to odoo-bin executable (default: /usr/bin/odoo-bin)

• ODOO_ADDONS_PATH: Comma-separated addon directories (default: /odoo/addons)

• ODOO_DATABASE: Database name (default: odoo)

• ODOO_CONFIG_FILE: Optional Odoo configuration file path

Usage

# Run the MCP server
uv run odoo-shell-mcp

# Or run directly
uv run python odoo_shell_mcp.py

MCP Tools

The server exposes these tools:

• execute_odoo_code: Execute Python code in Odoo shell context

• reset_odoo_shell: Restart the shell process to clear state

• list_odoo_models: Query available Odoo models with optional filtering

• odoo_model_info: Get detailed information about specific models

Development

# Run tests
uv run pytest

# Run tests with coverage
uv run pytest --cov=odoo_shell_mcp --cov-report=term-missing

# Lint and format
uv run ruff check .
uv run ruff format .

# Build package
uv build

License

MIT