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.
Provides a bridge to Odoo ERP systems, enabling access to partner information, accounting data (invoices and payments), financial record reconciliation, and the ability to query vendor bills and customer invoices.
Serves as the runtime environment for the MCP-Odoo server implementation.
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
Related MCP server: Odoo MCP Server
Features
🔌 Easy integration with Odoo instances
🤖 Standard MCP interface for AI agent compatibility
📊 Rich accounting data access
🔒 Secure authentication with Odoo
Installation
Configuration
Create a .env file in the project root with the following variables:
Usage
Start the MCP server:
Documentation
Comprehensive documentation is available in the docs/ directory:
Documentation Home - Start here for an overview of all documentation
Implementation Guide - Detailed architecture and implementation details
Accounting Functionality - In-depth guide to accounting features
Troubleshooting - Solutions for common issues
Usage Examples - Practical examples to get started
Development
Project Structure
mcp_odoo_public/: Main packageodoo/: Odoo client and related modulesresources/: MCP resources definitions (tools and schemas)server.py: MCP server implementationconfig.py: Configuration managementmcp_instance.py: FastMCP instance definition
Adding New Resources
Resources define the capabilities exposed to AI agents through MCP. To add a new resource:
Create a new file in the
resources/directoryDefine your resource using the
@mcp.tool()decoratorImport 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
Email: albert.gil@yourtechtribe.com
LinkedIn: https://www.linkedin.com/in/albertgilopez/
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.