Skip to main content
Glama
Odoo MCP Server

Odoo MCP Server

by benagricola

Odoo MCP Server

A Model Context Protocol (MCP) server that provides LLMs with read-only access to Odoo databases. This server exposes Odoo models and records through the MCP protocol, allowing AI assistants to query and analyze your Odoo data.

Features

  • Read-only access to Odoo databases via OdooRPC

  • Model discovery - List all available Odoo models

  • Field introspection - Get detailed field information for any model

  • Flexible querying - Search records with Odoo's domain syntax

  • Record reading - Fetch specific records by ID

  • Count operations - Get record counts without fetching data

  • Environment-based configuration - Secure credential management

  • MCP compliance - Works with any MCP-compatible client

Related MCP server: mcp-server-odoo

Installation

Install directly with uvx (recommended):

Odoo MCP Server

A Model Context Protocol (MCP) server that provides LLMs with read-only access to Odoo databases. This server exposes Odoo models and records through the MCP protocol, allowing AI assistants to query and analyze your Odoo data.

Features

  • Read-only access to Odoo databases via OdooRPC

  • Model discovery – list all available Odoo models

  • Field introspection – get detailed field information for any model

  • Flexible querying – search records with Odoo's domain syntax

  • Record reading – fetch specific records by ID

  • Count operations – get record counts without fetching data

  • Environment-based configuration – secure credential management

  • MCP compliance – works with any MCP-compatible client

Installation

Install directly with uvx (recommended):

uvx odoorpc-mcp

VS Code MCP setup

Create a .vscode/mcp.json in your workspace with:

{
	"servers": {
		"odoo": {
			"type": "stdio",
			"command": "uvx",
			"args": [
				"odoorpc-mcp"
			],
			"env": {
				"ODOO_URL": "${input:odoo_url}",
				"ODOO_DB": "${input:odoo_db}",
				"ODOO_USERNAME": "${input:odoo_username}",
				"ODOO_PASSWORD": "${input:odoo_password}"
			}
		}
	},
	"inputs": [
		{
			"id": "odoo_url",
			"type": "promptString",
			"description": "Odoo Server URL (e.g., https://your-odoo.com)"
		},
		{
			"id": "odoo_db",
			"type": "promptString",
			"description": "Odoo Database Name"
		},
		{
			"id": "odoo_username",
			"type": "promptString",
			"description": "Odoo Username"
		},
		{
			"id": "odoo_password",
			"type": "promptString",
			"description": "Odoo Password",
			"password": true
		}
	]
}

Alternatively, put credentials in a .env file in your workspace:

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

Usage

  • Show config example:

odoorpc-mcp --config-example
  • Print version:

odoorpc-mcp --version
  • Start the MCP server (requires environment variables):

odoorpc-mcp

Development

Build locally:

uv build

Run from source:

PYTHONPATH=src python3 -m odoo_mcp.cli --config-example

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with Odoo data using natural language to search, read, create, and update records. It acts as a secure bridge between MCP clients and Odoo instances version 17.0 through 19.0.
      11
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to fully interact with Odoo ERP instances over XML-RPC, supporting read and write operations on any model without requiring Odoo module installation.
      5
      AGPL 3.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server that enables AI assistants to query Odoo instances via XML-RPC, supporting search, read, count, and field inspection without requiring custom modules.
      62 PyPI
      1
      Mozilla Public 2.0