Odoo Accounting

🚀 MCP-Odoo Model Context Protocol Server

The MCP-Odoo Model Context Protocol Server is designed for Odoo integration, enabling AI agents to access and manipulate Odoo data through a standardized interface.

🚀 Quick Start

MCP-Odoo serves as a bridge between the Odoo ERP system and AI agents, utilizing the Model Context Protocol (MCP). This allows AI systems to:

• Access partner information
• View and analyze accounting data, including invoices and payment records
• Reconcile financial records
• Query supplier bills and customer invoices

✨ Features

• 🔌 Easy integration with Odoo instances
• 🤖 Compatibility with MCP interfaces for interconnection with AI agents
• 📊 Extensive access to accounting data
• 🔒 Secure authentication for Odoo integration

📦 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

📚 Documentation

Configuration

Create a .env file in the project root directory and include 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 Examples

Basic Usage

Start the MCP server:

# Use SSE transmission (default)
python -m mcp_odoo_public

# Use stdio for local agent integration
python -m mcp_odoo_public --transport stdio

The full documentation is located in the docs/ directory:

• Documentation Home - Get an overview of all documentation from here
• Implementation Guide - Detailed architecture and implementation details
• Accounting Function Guide - In-depth guide to accounting functions
• Troubleshooting - Solutions to common problems
• Usage Examples - Practical examples to get started quickly

Development

Project Structure

• mcp_odoo_public/: Main package
  • odoo/: Odoo client and related modules
  • resources/: MCP resource 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 provided 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 into resources/__init__.py.

For detailed instructions, refer to the Implementation Guide.

📄 License

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

Author

Albert Gil López

• Email: albert.gil@yourtechtribe.com
• LinkedIn: https://www.linkedin.com/in/albertgilopez/

Contribution Guide

If you're interested in contributing to this project, you can refer to the author information and contribution guide and participate in the development by submitting a Pull Request.