Registry / crm-productivity / mcp-server-odoo

mcp-server-odoo

library0.6.0pypypi✓ verified 84d ago

A Model Context Protocol (MCP) server for Odoo ERP systems. Provides tools for CRUD operations, searching records, aggregating data, posting messages, and listing models. Version 0.6.0 supports Python >=3.10 and connects to Odoo via XML-RPC. Released under MIT license with recent active development.

crm-productivity database http-networking serialization

pip install mcp-server-odoo

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · MCP-SERVER-ODOO

mcp-server-odoo

crm-productivitypythonv0.6.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

server

✓ import mcp_server_odoo.server

The server is typically run as a CLI tool, not imported. Importing the package directly is not the intended use.

Basic stdio server start. Requires environment variables: ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_API_KEY.

from mcp_server_odoo.server import run_stdio if __name__ == "__main__": # Ensure environment variables are set: ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_API_KEY run_stdio()

Debug

Known issues

breakingIn v0.5.2, the stdio transport was fixed to drop terminal `notifications/progress` from `search_records` and `list_models`. If you are using an older version (pre-0.5.2), strict MCP clients may report a fatal protocol error and tear down the transport.

fix

Upgrade to >=0.5.2.

affects: <0.5.2

breakingIn v0.5.1, search behavior changed: The env var `ODOO_MCP_DEFAULT_LIMIT` now applies when clients omit `limit`. Previously, the parameter was hardcoded, bypassing the env var. If you relied on the old behavior, you may need to set the env var accordingly.

fix

Set `ODOO_MCP_DEFAULT_LIMIT` to your desired default limit for search records.

affects: <0.5.1

gotchaThe `call_model_method` tool requires `ODOO_MCP_ENABLE_METHOD_CALLS=1` environment variable to be set. It does not appear unless you opt-in. This is a YOLO-only (experimental) feature.

fix

Set env var `ODOO_MCP_ENABLE_METHOD_CALLS=1` to enable the tool.

affects: >=0.6.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'mcp_server_odoo'

Library not installed or installed in wrong Python environment.

fix

Run `pip install mcp-server-odoo` in the correct environment.

ValueError: Missing required environment variable: ODOO_URL

One or more required environment variables (ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_API_KEY) are missing.

fix

Set all required environment variables before starting the server.

Upgrade

Version history

0.6.0latest on PyPI · released May 2, 2026

Audit

Dependencies

fastmcprequiredCore MCP server framework

httpxrequiredHTTP client for health endpoint and session cookie auth

Agent activity

32 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/ivnvxd/mcp-server-odoo ↗

packagehttps://pypi.org/project/mcp-server-odoo/ ↗

docshttps://github.com/ivnvxd/mcp-server-odoo#readme ↗

changeloghttps://github.com/ivnvxd/mcp-server-odoo/releases ↗