Skip to main content
Glama
Sign In

MCP Odoo Shell

by seletz
GitHub
Python
MIT License
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

A bridge server that provides access to an Odoo shell environment, allowing execution of Python code within an Odoo database context for model introspection and database operations.

  1. Overview
    1. Installation
      1. Configuration
        1. Usage
          1. MCP Tools
            1. Development
              1. License

                Related MCP Servers

                • Odoo MCP Server

                  tuanle96
                  -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server implementation that integrates with Odoo ERP systems, enabling AI assistants to interact with Odoo data and functionality through the Model Context Protocol.
                  Last updated -
                  78
                  Python
                  MIT License

                • mcp-odbc

                  OpenLinkSoftware
                  -
                  security
                  A
                  license
                  -
                  quality
                  Provides generic Open Database Connectivity (ODBC) to any Database Management System (DBMS) that's accessible via an ODBC Connector (Driver).
                  Last updated -
                  4
                  TypeScript
                  MIT License
                  • Apple

                • Odoo MCP Server

                  spraygospel
                  -
                  security
                  F
                  license
                  -
                  quality
                  An integration tool that connects Claude AI with Odoo database, allowing users to explore Odoo models, search data, and create reports through natural language commands.
                  Last updated -
                  Python

                • Odoo MCP Server

                  Willval117
                  -
                  security
                  F
                  license
                  -
                  quality
                  An implementation that integrates with Odoo ERP systems, enabling AI assistants to interact with Odoo data and functionality through the Model Context Protocol.
                  Last updated -
                  Python

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/seletz/mcp-odoo-shell'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server