home / mcp / mcp-odoo mcp server

MCP-Odoo MCP Server

Provides an MCP interface to access and manipulate Odoo ERP data for AI agents, enabling CRM, accounting, and program management tasks.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "iaisep-mcpserver": {
      "command": "python",
      "args": [
        "-m",
        "mcp_odoo_public"
      ],
      "env": {
        "HOST": "0.0.0.0",
        "PORT": "8080",
        "ODOO_DB": "your_database",
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_PASSWORD": "your_password",
        "ODOO_USERNAME": "your_username"
      }
    }
  }
}

MCP-Odoo provides a Model Context Protocol server that lets AI agents securely read and manipulate Odoo ERP data through a standardized interface. By bridging Odoo with MCP, you can manage CRM, partners, accounting data, and university-specific programs from AI-driven workflows.

How to use

You run the MCP-Odoo server locally and connect your MCP client to it. Use the standard MCP interface to send requests for CRM management, partner data access, accounting insights, and academic program tracking. For local development or testing, you can start the server in stdio mode to integrate directly with a local agent.

How to install

Prerequisites: you need Python and a working Odoo instance. Ensure you have access to the required Odoo URL, database, and credentials.

# Clone the MCP-Odoo project
git clone https://github.com/yourtechtribe/model-context-protocol-mcp-odoo.git
cd model-context-protocol-mcp-odoo

# Install Python dependencies
pip install -r requirements.txt

Configuration

Create a configuration file to point MCP-Odoo at your Odoo instance. You will specify how MCP connects to Odoo and where the MCP server should listen for client connections.

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 details

Start the MCP-Odoo server to expose the MCP interface. You have two common options depending on how you want to connect your client.

# Using the standard MCP transport (default)
python -m mcp_odoo_public

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

Security considerations

Ensure you secure access to the MCP interface and to the Odoo instance. Use strong credentials for Odoo and consider network filtering or authentication mechanisms on the MCP server when exposing it beyond a private network.

Troubleshooting

If you cannot connect to Odoo, verify that ODOO_URL, ODOO_DB, ODOO_USERNAME, and ODOO_PASSWORD are correct and that the Odoo instance is reachable from the MCP server host.

Available tools

list_leads

List and filter leads/opportunities with Universidad ISEP custom fields

get_lead_details

Get comprehensive lead information

create_lead

Create new leads with academic program tracking

update_lead

Update lead information and progress

convert_lead_to_opportunity

Convert leads to opportunities

get_crm_dashboard_stats

Get performance metrics and analytics

list_partners

List and filter contacts/companies

get_partner_details

Get detailed partner information

create_partner

Create new partners/contacts

update_partner

Update partner information

get_academic_programs

List available academic programs (ISEP)

list_crm_stages

Get CRM workflow stages

list_crm_teams

Get sales teams

get_lead_activities

Get lead-related activities

list_vendor_bills

List supplier invoices

list_customer_invoices

List customer invoices

list_payments

List payments with filtering

reconcile_invoices_and_payments

Generate reconciliation reports