Odoo MCP Improved

📋 Table of Contents

• Overview
• Features
• Installation
• Configuration
• Usage
• Tools Reference
• Resources Reference
• Prompts
• Claude Desktop Integration
• License

🔍 Overview

Odoo MCP Improved is a comprehensive implementation of the Model Context Protocol (MCP) for Odoo ERP systems. It provides a bridge between large language models like Claude and your Odoo instance, enabling AI assistants to interact directly with your business data and processes.

This extended version enhances the original MCP-Odoo implementation with advanced tools and resources for sales, purchases, inventory management, and accounting, making it a powerful solution for AI-assisted business operations.

✨ Features

Core Capabilities

• Seamless Odoo Integration: Connect directly to your Odoo instance via XML-RPC
• Comprehensive Data Access: Query and manipulate data across all Odoo modules
• Modular Architecture: Easily extensible with new tools and resources
• Robust Error Handling: Clear error messages and validation for reliable operation

Business Domain Support

• Sales Management: Order tracking, customer insights, and performance analysis
• Purchase Management: Supplier management, order processing, and performance metrics
• Inventory Management: Stock monitoring, inventory adjustments, and turnover analysis
• Accounting: Financial reporting, journal entries, and ratio analysis

Advanced Functionality

• Analytical Tools: Business intelligence capabilities across all domains
• Specialized Prompts: Pre-configured prompts for common business scenarios
• Resource URIs: Standardized access to Odoo data through URI patterns
• Performance Optimization: Caching and efficient data retrieval

📦 Installation

Using pip

pip install odoo-mcp-improved

🚀 Usage

Running the Server

# Using the module
python -m odoo_mcp

Example Interactions

# Sales Analysis
Using the Odoo MCP, analyze our sales performance for the last quarter and identify our top-selling products.

# Inventory Check
Check the current stock levels for product XYZ across all warehouses.

# Financial Analysis
Calculate our current liquidity and profitability ratios based on the latest financial data.

# Customer Insights
Provide insights on customer ABC's purchase history and payment patterns.

🤖 Claude Desktop Integration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "odoo_mcp"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

🛠️ Tools Reference

Sales Tools

| Tool | Description | |------|-------------| | search_sales_orders | Search for sales orders with advanced filtering | | create_sales_order | Create a new sales order | | analyze_sales_performance | Analyze sal

... View full README on GitHub