-
securityA
license-
qualityAn 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 -
177
Python
MIT License
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
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/directory - Define your resource using the
@mcp.tool()decorator - 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
- Email: albert.gil@yourtechtribe.com
- LinkedIn: https://www.linkedin.com/in/albertgilopez/
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
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.
Related MCP Servers
- -securityFlicense-qualityAn 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
- -securityFlicense-qualityAn 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
- -securityAlicense-qualityA comprehensive implementation of the Model Context Protocol for Odoo ERP systems that enables AI assistants to interact directly with business data across sales, purchases, inventory, and accounting modules.Last updated -10PythonMIT License