Odoo MCP Server

An MCP (Model Context Protocol) server that connects AI agents to Odoo ERP instances. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Remote serverstreamable-http

What is the Odoo MCP Server?

odoo-mcp-server is an MCP project maintained in the oconsole/odoo-mcp-server repository. The maintainer describes its purpose as “An MCP (Model Context Protocol) server that connects AI agents to Odoo ERP instances. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares ODOO_URL, ODOO_DB, ODOO_USER, ODOO_PASSWORD. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

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.

Tool	What it does
odoo_search_read	Query records with domain filters, field selection, pagination
odoo_search_count	Count matching records without fetching data
odoo_export	Bulk export up to 2000 records per call for spreadsheets
odoo_create	Create new records
odoo_update	Update existing records by ID
odoo_delete	Delete records by ID
odoo_execute	Run any model method (action_confirm, action_post, etc.)
odoo_list_models	Discover available models with keyword filter
odoo_get_fields	Inspect field definitions for any model
odoo_doctor	Health diagnostics (version, modules, users, crons, errors)
odoo_connection_info	Show current connection details
odoo_model_info	Get comprehensive model metadata in one call — fields, views, actions, defaults, sort order
odoo_set_default	Set, update, or clear a field's default value (handles ir.default + JSON encoding)
odoo_get_view	Get the fully rendered (merged) form/tree/search view XML
odoo_modify_action	Change a window action's domain, context, sort order, limit, or view modes

How to install the Odoo MCP Server

{
  "mcpServers": {
    "odoo": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--python",
        "3.11",
        "--script",
        "/path/to/odoo_mcp_server.py"
      ],
      "env": {
        "ODOO_URL": "https://your-instance.odoo.com",
        "ODOO_DB": "your-database",
        "ODOO_USER": "admin",
        "ODOO_PASSWORD": "YOUR_ODOO_PASSWORD"
      }
    }
  }
}

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

Configuration

Variable	Description	Required
ODOO_URL	Declared in the maintainer’s client configuration.	Check documentation
ODOO_DB	Declared in the maintainer’s client configuration.	Check documentation
ODOO_USER	Declared in the maintainer’s client configuration.	Check documentation
ODOO_PASSWORD	Declared in the maintainer’s client configuration.	Check documentation