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
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
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
This server cannot be installed
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
- -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 -78PythonMIT License
- -securityAlicense-qualityA 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 -2TypeScriptMIT License
- -security-license-qualityA 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 -3TypeScriptMIT License
- -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