MCP Odoo Shell

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

[!CAUTION] PRE-ALPHA SOFTWARE - DO NOT USE IN PRODUCTION

This software is in early development and should NEVER be used with production Odoo databases. It provides direct shell access to your Odoo database with full read/write capabilities and could cause data loss, corruption, or security vulnerabilities.

Use only with:

• Test databases
• Development environments
• Disposable data

You have been warned! 🚨

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.

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