{"id":27946,"library":"mcp-server-odoo","title":"MCP Server Odoo","description":"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.","status":"active","version":"0.6.0","language":"python","source_language":"en","source_url":"https://github.com/ivnvxd/mcp-server-odoo","tags":["mcp","odoo","erp","model-context-protocol","xml-rpc"],"install":[{"cmd":"pip install mcp-server-odoo","lang":"bash","label":"Install from PyPI"},{"cmd":"pip install mcp-server-odoo[yolo]","lang":"bash","label":"Install with YOLO (experimental) extras"}],"dependencies":[{"reason":"Core MCP server framework","package":"fastmcp","optional":false},{"reason":"HTTP client for health endpoint and session cookie auth","package":"httpx","optional":false}],"imports":[{"note":"The server is typically run as a CLI tool, not imported. Importing the package directly is not the intended use.","wrong":"","symbol":"server","correct":"import mcp_server_odoo.server"}],"quickstart":{"code":"from mcp_server_odoo.server import run_stdio\n\nif __name__ == \"__main__\":\n    # Ensure environment variables are set: ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_API_KEY\n    run_stdio()","lang":"python","description":"Basic stdio server start. Requires environment variables: ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_API_KEY."},"warnings":[{"fix":"Upgrade to >=0.5.2.","message":"In 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.","severity":"breaking","affected_versions":"<0.5.2"},{"fix":"Set `ODOO_MCP_DEFAULT_LIMIT` to your desired default limit for search records.","message":"In 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.","severity":"breaking","affected_versions":"<0.5.1"},{"fix":"Set env var `ODOO_MCP_ENABLE_METHOD_CALLS=1` to enable the tool.","message":"The `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.","severity":"gotcha","affected_versions":">=0.6.0"}],"env_vars":null,"search_vec":"'0.6.0':29 '3.10':32 'activ':47 'aggreg':21 'connect':34 'context':6,54 'crud':17 'data':22 'develop':48 'erp':12,51 'licens':44 'list':26 'mcp':1,8,49 'messag':24 'mit':43 'model':5,27,53 'model-context-protocol':52 'odoo':3,11,36,50 'oper':18 'post':23 'protocol':7,55 'provid':14 'python':31 'recent':46 'record':20 'releas':41 'rpc':40,58 'search':19 'server':2,9 'support':30 'system':13 'tool':15 'version':28 'via':37 'xml':39,57 'xml-rpc':38,56","created_at":"2026-05-09T05:52:55.256639+00:00","updated_at":"2026-05-09T05:52:55.256639+00:00","problems":[{"fix":"Run `pip install mcp-server-odoo` in the correct environment.","cause":"Library not installed or installed in wrong Python environment.","error":"ModuleNotFoundError: No module named 'mcp_server_odoo'"},{"fix":"Set all required environment variables before starting the server.","cause":"One or more required environment variables (ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_API_KEY) are missing.","error":"ValueError: Missing required environment variable: ODOO_URL"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/ivnvxd/mcp-server-odoo","docs":"https://github.com/ivnvxd/mcp-server-odoo#readme","changelog":"https://github.com/ivnvxd/mcp-server-odoo/releases","pypi":"https://pypi.org/project/mcp-server-odoo/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["crm-productivity","database","http-networking","serialization"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}