Provides direct access to an Odoo database environment, enabling execution of Python code within an Odoo context, model introspection, and session management with tools for listing available models and retrieving detailed model information.
MCP Odoo Shell
A Model Context Protocol (MCP) server that provides access to an Odoo shell environment.
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.
Related MCP server: Odoo MCP Server
Installation
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
MCP Tools
The server exposes these tools:
execute_odoo_code: Execute Python code in Odoo shell contextreset_odoo_shell: Restart the shell process to clear statelist_odoo_models: Query available Odoo models with optional filteringodoo_model_info: Get detailed information about specific models
Development
License
MIT