Used for configuration management to securely store Odoo connection credentials and server settings in a .env file.
Supports version control for the MCP-Odoo codebase, with instructions for cloning the repository from GitHub.
Hosts the MCP-Odoo repository where users can access and contribute to the codebase.
Enables AI agents to access and manipulate Odoo ERP data, including partner information, accounting data, invoices, payments, and financial reconciliation through a standardized interface.
Provides the runtime environment for the MCP-Odoo server with specific commands for launching the server in different transport modes.
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 Model Context Protocol server that bridges Odoo ERP systems with AI agents, enabling them to access and manipulate partner information, accounting data, invoices, and perform financial reconciliation through a standardized interface.
Related MCP Servers
- -securityAlicense-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 -186PythonMIT License
- -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 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.Last updated -7PythonMIT License
- -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 -13PythonMIT License