A modular, type-safe, and secure MCP server for interacting with Odoo 18 ORM
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"odooclaw-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# OdooClaw MCP Standalone MCP (Model Context Protocol) server for Odoo 18 over `stdio`. **MCP name:** `io.github.nicolasramos/odoo-mcp` **PyPI package:** `odooclaw-mcp` **Official CLI:** `odooclaw-mcp` Backward-compatible aliases are also installed: - `odoo-mcp` - `odoo-mcp-server` - `odoo-18-mcp-server` ## Quick Start ### 1) Install ```bash pip install odooclaw-mcp ``` From source: ```bash git clone https://github.com/nicolasramos/odooclaw-mcp.git cd odooclaw-mcp pip install -e . ``` ### 2) Configure environment ```bash cp .env.example .env ``` Required: ```env ODOO_URL=https://yourcompany.odoo.com ODOO_DB=your_database ODOO_USERNAME=your_username ODOO_PASSWORD=your_password ``` Optional: ```env ODOO_MCP_DEFAULT_LIMIT=50 ODOO_MCP_MAX_LIMIT=80 LOG_LEVEL=INFO ``` ### 3) Validate and run ```bash odooclaw-mcp --check-config odooclaw-mcp ``` Alternative: ```bash python -m odoo_mcp ``` ## MCP Client Configuration (stdio) ```json { "mcpServers": { "odoo": { "command": "odooclaw-mcp", "env": { "ODOO_URL": "https://yourcompany.odoo.com", "ODOO_DB": "your_database", "ODOO_USERNAME": "your_username", "ODOO_PASSWORD": "your_password", "ODOO_MCP_DEFAULT_LIMIT": "50", "ODOO_MCP_MAX_LIMIT": "80" } } } } ``` ## Scope - 38+ MCP tools for Odoo operations (CRUD + business actions) - Pydantic validation for all tool payloads - Odoo 18 compatibility helpers (customer_rank / supplier_rank / payment_state) - Security guards (model allowlist, denylisted fields, action guard, unlink blocked) - Structured logging and audit actions ## Security Model The server uses standard Odoo JSON-RPC endpoints and executes operations as the configured Odoo session user. For production, use a dedicated least-privilege Odoo account. ## Production Notes - This is a `stdio` MCP server, not an HTTP API service. - Docker/Compose support is mainly for packaging or controlled runtime scenarios. - In nor…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.