MCP-Odoo

MIT License
2

Integrations

  • Used for configuration management to securely store connection credentials for Odoo instances including URL, database, username and password.

  • Used for version control and installation of the MCP-Odoo server.

  • Hosts the repository for the MCP-Odoo server code, allowing for installation via git clone.

MCP-Odoo

Model Context Protocol server for Odoo integration, allowing AI agents to access and manipulate Odoo data through a standardized interface.

Overview

MCP-Odoo provides a bridge between Odoo ERP systems and AI agents using the Model Context Protocol (MCP). This enables AI systems to:

  • Access partner information
  • View and analyze accounting data including invoices and payments
  • Perform reconciliation of financial records
  • Query vendor bills and customer invoices

Features

  • 🔌 Easy integration with Odoo instances
  • 🤖 Standard MCP interface for AI agent compatibility
  • 📊 Rich accounting data access
  • 🔒 Secure authentication with Odoo

Installation

# Clone the repository git clone https://github.com/yourtechtribe/model-context-protocol-mcp-odoo.git cd model-context-protocol-mcp-odoo # Install dependencies pip install -r requirements.txt

Configuration

Create a .env file in the project root with the following variables:

ODOO_URL=https://your-odoo-instance.com ODOO_DB=your_database ODOO_USERNAME=your_username ODOO_PASSWORD=your_password HOST=0.0.0.0 PORT=8080

Usage

Start the MCP server:

# Using the SSE transport (default) python -m mcp_odoo_public # Using stdio for local agent integration python -m mcp_odoo_public --transport stdio

Documentation

Comprehensive documentation is available in the docs/ directory:

Development

Project Structure

  • mcp_odoo_public/: Main package
    • odoo/: Odoo client and related modules
    • resources/: MCP resources definitions (tools and schemas)
    • server.py: MCP server implementation
    • config.py: Configuration management
    • mcp_instance.py: FastMCP instance definition

Adding New Resources

Resources define the capabilities exposed to AI agents through MCP. To add a new resource:

  1. Create a new file in the resources/ directory
  2. Define your resource using the @mcp.tool() decorator
  3. Import your resource in resources/__init__.py

For detailed instructions, see the Implementation Guide.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Albert Gil López

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

A bridge that allows AI agents to access and manipulate Odoo ERP data through a standardized Model Context Protocol interface, supporting partner information, accounting data, financial records reconciliation, and invoice queries.

  1. Overview
    1. Features
      1. Installation
        1. Configuration
          1. Usage
            1. Documentation
              1. Development
                1. Project Structure
                2. Adding New Resources
              2. License
                1. Author
                  1. Contributing

                    Related MCP Servers

                    • -
                      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
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that enables AI agents to interact with Brex financial platform data, allowing retrieval of account information, expenses, budgets, and team data through standardized resource handlers.
                      Last updated -
                      2
                      TypeScript
                      MIT License
                      • Apple
                    • -
                      security
                      -
                      license
                      -
                      quality
                      A Model Context Protocol server that connects AI assistants to Brazilian public data services, providing access to postal codes, company registrations, bank information, area codes, IBGE data, currency exchange rates, and domain registration status.
                      Last updated -
                      3
                      TypeScript
                      MIT License
                    • -
                      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

                    View all related MCP servers

                    ID: 5rucwfvh39