Odoo-MCP

A modern bridge system for interacting with Odoo ERP systems through MCP (Model Context Protocol).

- Comprehensive Odoo Integration: Full access to Odoo models, records, and methods
- XML-RPC Communication: Secure connection to Odoo instances via XML-RPC
- Flexible Configuration: Support for config files and environment variables
- Resource Pattern System: URI-based access to Odoo data structures
- Error Handling: Clear error messages for common Odoo API issues
- Stateless Operations: Clean request/response cycle for reliable integration

- Execute a custom method on an Odoo model
- Inputs:

- model(string): The model name (e.g., 'res.partner')
- method(string): Method name to execute
- args(optional array): Positional arguments
- kwargs(optional object): Keyword arguments

- Search for employees by name
- Inputs:

- name(string): The name (or part of the name) to search for
- limit(optional number): The maximum number of results to return (default 20)

- Searches for holidays within a specified date range
- Inputs:

- start_date(string): Start date in YYYY-MM-DD format
- end_date(string): End date in YYYY-MM-DD format
- employee_id(optional number): Optional employee ID to filter holidays

- Lists all available models in the Odoo system
- Returns: JSON array of model information

- Get information about a specific model including fields
- Example:odoo://model/res.partner
- Returns: JSON object with model metadata and field definitions

- Get a specific record by ID
- Example:odoo://record/res.partner/1
- Returns: JSON object with record data

- Search for records that match a domain
- Example:odoo://search/res.partner/[["is_company","=",true]]
- Returns: JSON array of matching records (limited to 10 by default)
- Create a configuration file namedodoo_config.json:

{ "url": "https://your-odoo-instance.com", "db": "your-database-name", "username": "your-username", "password": "your-password-or-api-key" }

- Alternatively, use environment variables:

- ODOO_URL: Your Odoo server URL
- ODOO_DB: Database name
- ODOO_USERNAME: Login username
- ODOO_PASSWORD: Password or API key
- ODOO_TIMEOUT: Connection timeout in seconds (default: 30)
- ODOO_VERIFY_SSL: Whether to verify SSL certificates (default: true)
- HTTP_PROXY: Force the ODOO connection to use an HTTP proxy

Add this to yourclaude_desktop_config.json:

{ "mcpServers": { "odoo": { "command": "python", "args": ["-m", "odoo_mcp"], "env": { "ODOO_URL": "https://your-odoo-instance.com", "ODOO_DB": "your-database-name", "ODOO_USERNAME": "your-username", "ODOO_PASSWORD": "your-password-or-api-key" } } } }

{ "mcpServers": { "odoo": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ODOO_URL", "-e", "ODOO_DB", "-e", "ODOO_USERNAME", "-e", "ODOO_PASSWORD", "mcp/odoo" ], "env": { "ODOO_URL": "https://your-odoo-instance.com", "ODOO_DB": "your-database-name", "ODOO_USERNAME": "your-username", "ODOO_PASSWORD": "your-password-or-api-key" } } } }

# Using the installed package odoo-mcp # Using the MCP development tools mcp dev odoo_mcp/server.py # With additional dependencies mcp dev odoo_mcp/server.py --with pandas --with numpy # Mount local code for development mcp dev odoo_mcp/server.py --with-editable .

docker build -t mcp/odoo:latest -f Dockerfile .

When using the MCP tools for Odoo, pay attention to these parameter formatting guidelines:

- The following domain formats are supported:

- List format:[["field", "operator", value], ...]
- Object format:{"conditions": [{"field": "...", "operator": "...", "value": "..."}]}
- JSON string of either format

- List format:[["is_company", "=", true]]
- Object format:{"conditions": [{"field": "date_order", "operator": ">=", "value": "2025-03-01"}]}
- Multiple conditions:[["date_order", ">=", "2025-03-01"], ["date_order", "<=", "2025-03-31"]]

- Should be an array of field names:["name", "email", "phone"]
- The server will try to parse string inputs as JSON

This MCP server is licensed under the MIT License.

Integrate Odoo with Large Language Models (LLMs) for enhanced business process automation.

A hosted or self-hosted cloud version of Odoo MCP

An MCP server that provides direct access to Odoo ERP system capabilities.

An MCP server for integrating with the Odoo ERP system.

An MCP server for Quickbase, enabling seamless integration with AI assistants like Claude Desktop.

Australian trade business OS with 67 MCP tools across 23 domains — autonomous business formation, lead management, quoting, job scheduling, invoicing, crypto payments, and growth analytics for tradies.

Skyvia MCP Endpoint is a no-code gateway that makes your business data accessible to AI assistants in real time.

A lightweight server to connect AI assistants with Kintone applications and data.

Integrate with kintone data and applications using the Model Context Protocol.

A Model Context Protocol (MCP) server and standalone CLI for querying PowerPlatform / Dataverse environments. Supports multiple environments, entity metadata, records, plugins, flows, solutions, workflows, business rules, security roles, and more.