mcpField
M
MCP-Odoo

MCP-Odoo

Local
github.com/yourtechtribeFinance14Updated 78w ago
Repository

About MCP-Odoo

MCP-Odoo connects Odoo ERP systems with AI agents that need to access or work with business and accounting records. It provides partner, invoice, payment, and reconciliation capabilities through an MCP interface.

Key features

  1. 01Access partner information
  2. 02View accounting data
  3. 03Query vendor bills and customer invoices
  4. 04Reconcile financial records
  5. 05Authenticate with Odoo

Use cases

  1. 01Review Odoo partner records
  2. 02Analyze invoices and payments
  3. 03Query vendor bills or customer invoices
  4. 04Reconcile financial records

MCP support

It exposes Odoo data and accounting operations to AI agents through MCP tools. It supports SSE and stdio transports.

#mcp#odoo#ai-integration

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

# 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

Configuration

Create a .env file in the project root with 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

Start the MCP server:

# Using the SSE transport (default)
python -m mcp_odoo_public

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

Documentation

Comprehensive documentation is available in the docs/ directory:

Development

Project Structure
  • mcp_odoo_public/: Main package
    • odoo/: Odoo client and related modules
    • resources/: MCP resources 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 exposed 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 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.