odoo-mcp-improved


Nameodoo-mcp-improved JSON
Version 1.0.5 PyPI version JSON
download
home_pageNone
SummaryMCP Server for Odoo Integration
upload_time2025-08-04 17:46:22
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseMIT
keywords odoo mcp server ai
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            
# Odoo MCP Improved

![demo.gif](demo.gif)

<div align="center">

![Odoo MCP Improved Logo](https://img.shields.io/badge/Odoo%20MCP-Improved-brightgreen?style=for-the-badge&logo=odoo)

[![PyPI version](https://img.shields.io/badge/pypi-v1.0.0-blue.svg)](https://pypi.org/project/odoo-mcp-improved/)
[![Python Versions](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue)](https://pypi.org/project/odoo-mcp-improved/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)

**Enhanced Model Context Protocol (MCP) server for Odoo ERP with advanced tools for sales, purchases, inventory and accounting**

</div>

---

## πŸ“‹ Table of Contents

- [Overview](#-overview)
- [Features](#-features)
- [Installation](#-installation)
- [Configuration](#-configuration)
- [Usage](#-usage)
- [Tools Reference](#-tools-reference)
- [Resources Reference](#-resources-reference)
- [Prompts](#-prompts)
- [Claude Desktop Integration](#-claude-desktop-integration)
- [License](#-license)

---

## πŸ” Overview

Odoo MCP Improved is a comprehensive implementation of the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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

```bash
pip install odoo-mcp-improved
```

### From Source

```bash
git clone https://github.com/hachecito/odoo-mcp-improved.git
cd odoo-mcp-improved
pip install -e .
```

---

## βš™οΈ Configuration

### Environment Variables

```bash
export ODOO_URL=https://your-odoo-instance.com
export ODOO_DB=your_database
export ODOO_USERNAME=your_username
export ODOO_PASSWORD=your_password
```

### Configuration File

Create an `odoo_config.json` file in your working directory:

```json
{
  "url": "https://your-odoo-instance.com",
  "db": "your_database",
  "username": "your_username",
  "password": "your_password"
}
```

---

## πŸš€ Usage

### Running the Server

```bash
# 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.
```

---

## πŸ› οΈ 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 sales performance by period, product, or customer |
| `get_customer_insights` | Get detailed insights about a specific customer |

### Purchase Tools

| Tool | Description |
|------|-------------|
| `search_purchase_orders` | Search for purchase orders with advanced filtering |
| `create_purchase_order` | Create a new purchase order |
| `analyze_supplier_performance` | Analyze supplier performance metrics |

### Inventory Tools

| Tool | Description |
|------|-------------|
| `check_product_availability` | Check stock availability for products |
| `create_inventory_adjustment` | Create inventory adjustment entries |
| `analyze_inventory_turnover` | Calculate and analyze inventory turnover metrics |

### Accounting Tools

| Tool | Description |
|------|-------------|
| `search_journal_entries` | Search for accounting journal entries |
| `create_journal_entry` | Create a new journal entry |
| `analyze_financial_ratios` | Calculate key financial ratios |

---

## πŸ”— Resources Reference

### Sales Resources

| URI | Description |
|-----|-------------|
| `odoo://sales/orders` | List sales orders |
| `odoo://sales/order/{order_id}` | Get details of a specific sales order |
| `odoo://sales/products` | List sellable products |
| `odoo://sales/customers` | List customers |

### Purchase Resources

| URI | Description |
|-----|-------------|
| `odoo://purchase/orders` | List purchase orders |
| `odoo://purchase/order/{order_id}` | Get details of a specific purchase order |
| `odoo://purchase/suppliers` | List suppliers |

### Inventory Resources

| URI | Description |
|-----|-------------|
| `odoo://inventory/products` | List products in inventory |
| `odoo://inventory/stock/{location_id}` | Get stock levels at a specific location |
| `odoo://inventory/movements` | List inventory movements |

### Accounting Resources

| URI | Description |
|-----|-------------|
| `odoo://accounting/accounts` | List accounting accounts |
| `odoo://accounting/journal_entries` | List journal entries |
| `odoo://accounting/reports/{report_type}` | Get financial reports |

---

## πŸ’¬ Prompts

Odoo MCP Improved includes specialized prompts for different business scenarios:

### Sales Analysis Prompts
- Sales trend analysis
- Customer segmentation
- Product performance evaluation
- Sales team performance

### Inventory Management Prompts
- Stock optimization
- Reordering suggestions
- Warehouse efficiency analysis
- Product movement patterns

### Human Resources Prompts
- Staff planning
- Scheduling optimization
- Performance evaluation
- Resource allocation

### Financial Analysis Prompts
- Ratio interpretation
- Cash flow analysis
- Budget variance analysis
- Financial health assessment

---

## πŸ€– Claude Desktop Integration

Add the following to your `claude_desktop_config.json`:

```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"
      }
    }
  }
}
```

---

## πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

This repo is extended from [mcp-odoo](https://github.com/tuanle96/mcp-odoo) - [LΓͺ Anh TuαΊ₯n](https://github.com/tuanle96)

---

<div align="center">

**Odoo MCP Improved** - Empowering AI assistants with comprehensive Odoo ERP capabilities

</div>

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "odoo-mcp-improved",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "odoo, mcp, server, ai",
    "author": null,
    "author_email": "Yhasmani Valdes <yhasmanivm@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/15/06/7a80a92407eef32203465cbd19faef9c300210d881e39ad9b46b755dfe83/odoo_mcp_improved-1.0.5.tar.gz",
    "platform": null,
    "description": "\r\n# Odoo MCP Improved\r\n\r\n![demo.gif](demo.gif)\r\n\r\n<div align=\"center\">\r\n\r\n![Odoo MCP Improved Logo](https://img.shields.io/badge/Odoo%20MCP-Improved-brightgreen?style=for-the-badge&logo=odoo)\r\n\r\n[![PyPI version](https://img.shields.io/badge/pypi-v1.0.0-blue.svg)](https://pypi.org/project/odoo-mcp-improved/)\r\n[![Python Versions](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue)](https://pypi.org/project/odoo-mcp-improved/)\r\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)\r\n\r\n**Enhanced Model Context Protocol (MCP) server for Odoo ERP with advanced tools for sales, purchases, inventory and accounting**\r\n\r\n</div>\r\n\r\n---\r\n\r\n## \ud83d\udccb Table of Contents\r\n\r\n- [Overview](#-overview)\r\n- [Features](#-features)\r\n- [Installation](#-installation)\r\n- [Configuration](#-configuration)\r\n- [Usage](#-usage)\r\n- [Tools Reference](#-tools-reference)\r\n- [Resources Reference](#-resources-reference)\r\n- [Prompts](#-prompts)\r\n- [Claude Desktop Integration](#-claude-desktop-integration)\r\n- [License](#-license)\r\n\r\n---\r\n\r\n## \ud83d\udd0d Overview\r\n\r\nOdoo MCP Improved is a comprehensive implementation of the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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.\r\n\r\nThis 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.\r\n\r\n---\r\n\r\n## \u2728 Features\r\n\r\n### Core Capabilities\r\n- **Seamless Odoo Integration**: Connect directly to your Odoo instance via XML-RPC\r\n- **Comprehensive Data Access**: Query and manipulate data across all Odoo modules\r\n- **Modular Architecture**: Easily extensible with new tools and resources\r\n- **Robust Error Handling**: Clear error messages and validation for reliable operation\r\n\r\n### Business Domain Support\r\n- **Sales Management**: Order tracking, customer insights, and performance analysis\r\n- **Purchase Management**: Supplier management, order processing, and performance metrics\r\n- **Inventory Management**: Stock monitoring, inventory adjustments, and turnover analysis\r\n- **Accounting**: Financial reporting, journal entries, and ratio analysis\r\n\r\n### Advanced Functionality\r\n- **Analytical Tools**: Business intelligence capabilities across all domains\r\n- **Specialized Prompts**: Pre-configured prompts for common business scenarios\r\n- **Resource URIs**: Standardized access to Odoo data through URI patterns\r\n- **Performance Optimization**: Caching and efficient data retrieval\r\n\r\n---\r\n\r\n## \ud83d\udce6 Installation\r\n\r\n### Using pip\r\n\r\n```bash\r\npip install odoo-mcp-improved\r\n```\r\n\r\n### From Source\r\n\r\n```bash\r\ngit clone https://github.com/hachecito/odoo-mcp-improved.git\r\ncd odoo-mcp-improved\r\npip install -e .\r\n```\r\n\r\n---\r\n\r\n## \u2699\ufe0f Configuration\r\n\r\n### Environment Variables\r\n\r\n```bash\r\nexport ODOO_URL=https://your-odoo-instance.com\r\nexport ODOO_DB=your_database\r\nexport ODOO_USERNAME=your_username\r\nexport ODOO_PASSWORD=your_password\r\n```\r\n\r\n### Configuration File\r\n\r\nCreate an `odoo_config.json` file in your working directory:\r\n\r\n```json\r\n{\r\n  \"url\": \"https://your-odoo-instance.com\",\r\n  \"db\": \"your_database\",\r\n  \"username\": \"your_username\",\r\n  \"password\": \"your_password\"\r\n}\r\n```\r\n\r\n---\r\n\r\n## \ud83d\ude80 Usage\r\n\r\n### Running the Server\r\n\r\n```bash\r\n# Using the module\r\npython -m odoo_mcp\r\n```\r\n\r\n### Example Interactions\r\n\r\n```\r\n# Sales Analysis\r\nUsing the Odoo MCP, analyze our sales performance for the last quarter and identify our top-selling products.\r\n\r\n# Inventory Check\r\nCheck the current stock levels for product XYZ across all warehouses.\r\n\r\n# Financial Analysis\r\nCalculate our current liquidity and profitability ratios based on the latest financial data.\r\n\r\n# Customer Insights\r\nProvide insights on customer ABC's purchase history and payment patterns.\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udee0\ufe0f Tools Reference\r\n\r\n### Sales Tools\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `search_sales_orders` | Search for sales orders with advanced filtering |\r\n| `create_sales_order` | Create a new sales order |\r\n| `analyze_sales_performance` | Analyze sales performance by period, product, or customer |\r\n| `get_customer_insights` | Get detailed insights about a specific customer |\r\n\r\n### Purchase Tools\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `search_purchase_orders` | Search for purchase orders with advanced filtering |\r\n| `create_purchase_order` | Create a new purchase order |\r\n| `analyze_supplier_performance` | Analyze supplier performance metrics |\r\n\r\n### Inventory Tools\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `check_product_availability` | Check stock availability for products |\r\n| `create_inventory_adjustment` | Create inventory adjustment entries |\r\n| `analyze_inventory_turnover` | Calculate and analyze inventory turnover metrics |\r\n\r\n### Accounting Tools\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `search_journal_entries` | Search for accounting journal entries |\r\n| `create_journal_entry` | Create a new journal entry |\r\n| `analyze_financial_ratios` | Calculate key financial ratios |\r\n\r\n---\r\n\r\n## \ud83d\udd17 Resources Reference\r\n\r\n### Sales Resources\r\n\r\n| URI | Description |\r\n|-----|-------------|\r\n| `odoo://sales/orders` | List sales orders |\r\n| `odoo://sales/order/{order_id}` | Get details of a specific sales order |\r\n| `odoo://sales/products` | List sellable products |\r\n| `odoo://sales/customers` | List customers |\r\n\r\n### Purchase Resources\r\n\r\n| URI | Description |\r\n|-----|-------------|\r\n| `odoo://purchase/orders` | List purchase orders |\r\n| `odoo://purchase/order/{order_id}` | Get details of a specific purchase order |\r\n| `odoo://purchase/suppliers` | List suppliers |\r\n\r\n### Inventory Resources\r\n\r\n| URI | Description |\r\n|-----|-------------|\r\n| `odoo://inventory/products` | List products in inventory |\r\n| `odoo://inventory/stock/{location_id}` | Get stock levels at a specific location |\r\n| `odoo://inventory/movements` | List inventory movements |\r\n\r\n### Accounting Resources\r\n\r\n| URI | Description |\r\n|-----|-------------|\r\n| `odoo://accounting/accounts` | List accounting accounts |\r\n| `odoo://accounting/journal_entries` | List journal entries |\r\n| `odoo://accounting/reports/{report_type}` | Get financial reports |\r\n\r\n---\r\n\r\n## \ud83d\udcac Prompts\r\n\r\nOdoo MCP Improved includes specialized prompts for different business scenarios:\r\n\r\n### Sales Analysis Prompts\r\n- Sales trend analysis\r\n- Customer segmentation\r\n- Product performance evaluation\r\n- Sales team performance\r\n\r\n### Inventory Management Prompts\r\n- Stock optimization\r\n- Reordering suggestions\r\n- Warehouse efficiency analysis\r\n- Product movement patterns\r\n\r\n### Human Resources Prompts\r\n- Staff planning\r\n- Scheduling optimization\r\n- Performance evaluation\r\n- Resource allocation\r\n\r\n### Financial Analysis Prompts\r\n- Ratio interpretation\r\n- Cash flow analysis\r\n- Budget variance analysis\r\n- Financial health assessment\r\n\r\n---\r\n\r\n## \ud83e\udd16 Claude Desktop Integration\r\n\r\nAdd the following to your `claude_desktop_config.json`:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"odoo\": {\r\n      \"command\": \"python\",\r\n      \"args\": [\"-m\", \"odoo_mcp\"],\r\n      \"env\": {\r\n        \"ODOO_URL\": \"https://your-odoo-instance.com\",\r\n        \"ODOO_DB\": \"your_database\",\r\n        \"ODOO_USERNAME\": \"your_username\",\r\n        \"ODOO_PASSWORD\": \"your_password\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is licensed under the MIT License - see the LICENSE file for details.\r\n\r\nThis repo is extended from [mcp-odoo](https://github.com/tuanle96/mcp-odoo) - [L\u00ea Anh Tu\u1ea5n](https://github.com/tuanle96)\r\n\r\n---\r\n\r\n<div align=\"center\">\r\n\r\n**Odoo MCP Improved** - Empowering AI assistants with comprehensive Odoo ERP capabilities\r\n\r\n</div>\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "MCP Server for Odoo Integration",
    "version": "1.0.5",
    "project_urls": {
        "Homepage": "https://github.com/hachecito/odoo-mcp-improved",
        "Issues": "https://github.com/hachecito/odoo-mcp-improved/issues"
    },
    "split_keywords": [
        "odoo",
        " mcp",
        " server",
        " ai"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "63031e8da2824c83f11e4384ce9c36bb53266c01ef990be3b57cb17eb5cc8d02",
                "md5": "25e9383b6abf9583e2c207e3b9ff26ab",
                "sha256": "7b2a172e63570e8fd594af223ba7f957e15367b72c333931c582ddf4675b3240"
            },
            "downloads": -1,
            "filename": "odoo_mcp_improved-1.0.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "25e9383b6abf9583e2c207e3b9ff26ab",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 30258,
            "upload_time": "2025-08-04T17:46:21",
            "upload_time_iso_8601": "2025-08-04T17:46:21.128553Z",
            "url": "https://files.pythonhosted.org/packages/63/03/1e8da2824c83f11e4384ce9c36bb53266c01ef990be3b57cb17eb5cc8d02/odoo_mcp_improved-1.0.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "15067a80a92407eef32203465cbd19faef9c300210d881e39ad9b46b755dfe83",
                "md5": "0b742bcc96385cfa28537c0e967aba2c",
                "sha256": "dcb024c791e9c78c4ab50ac0b011faf88f3327484537b87f4c151dc1d111d57b"
            },
            "downloads": -1,
            "filename": "odoo_mcp_improved-1.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "0b742bcc96385cfa28537c0e967aba2c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 27645,
            "upload_time": "2025-08-04T17:46:22",
            "upload_time_iso_8601": "2025-08-04T17:46:22.277774Z",
            "url": "https://files.pythonhosted.org/packages/15/06/7a80a92407eef32203465cbd19faef9c300210d881e39ad9b46b755dfe83/odoo_mcp_improved-1.0.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-04 17:46:22",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "hachecito",
    "github_project": "odoo-mcp-improved",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "odoo-mcp-improved"
}
None
Elapsed time: 0.48597s