Odoo MCP Server

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

Local serverstdioPython

What is the Odoo MCP Server?

Odoo MCP lets Claude, Cursor and other MCP clients work with Odoo MCP directly. A modern bridge system for interacting with Odoo ERP systems through MCP (Model Context Protocol).

What Odoo MCP does

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

Key capabilities

  • 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

Practical notes

  • Maintained by ridrisa, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
execute_methodExecute a custom method on an Odoo model
Inputs:start_date (string): Start date in YYYY-MM-DD format
argsoptional array): Positional arguments
kwargsoptional object): Keyword arguments
ReturnsObject containing success indicator, list of holidays found, and any error message
search_employeeSearch for employees by name
limitoptional number): The maximum number of results to return (default 20)
search_holidaysSearches for holidays within a specified date range
employee_idoptional number): Optional employee ID to filter holidays

How to install the Odoo MCP Server

{
  "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_ODOO_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
ODOO_URLDeclared in the maintainer’s client configuration.Check documentation
ODOO_DBDeclared in the maintainer’s client configuration.Check documentation
ODOO_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
ODOO_PASSWORDDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Odoo MCP to execute method.”
  • “Use Odoo MCP to Inputs.”
  • “Use Odoo MCP to Returns.”

Frequently asked questions

A modern bridge system for interacting with Odoo ERP systems through MCP (Model Context Protocol). Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.