Installation¶

As a Claude plugin (recommended)¶

/plugin marketplace add Transgenia/MCP-Odoo-Tools-CE-EE-and-online
/plugin install odoo-tools
/odoo-tools:odoo-setup-mcp

The plugin's mcpServers entry launches the server with:

uvx --from ${CLAUDE_PLUGIN_ROOT}/server odoo-mcp

This way uv builds and runs the packaged server from source — no PyPI publication is needed.

Run the MCP server directly¶

# with uv (recommended; brings its own Python)
uvx --from ./server odoo-mcp

# or from a checkout with your own Python 3.11+
cd server && pip install -e . && python -m odoo_mcp

Requirements¶

MCP server: uv/uvx (brings its own Python), or Python 3.11+ to run python -m odoo_mcp from server/.
Fallback CLI (optional): Node.js 18+.

Optional extras¶

pip install -e "./server[cache]"    # schema cache with TTL (cachetools)
pip install -e "./server[metrics]"  # Prometheus metrics at /metrics
pip install -e "./server[otel]"     # OpenTelemetry traces (OTLP)

The extras never block startup: if they are not installed, those capabilities simply stay inactive (graceful degradation).

Configuration (environment variables)¶

Variable	Required	Notes
`ODOO_URL`	yes	`https://host` (no trailing path)
`ODOO_DB`	yes	database name
`ODOO_LOGIN`	yes	login email
`ODOO_API_KEY`	yes*	Odoo ≥ 14; created in Account Security
`ODOO_PASSWORD`	yes*	use it in Odoo < 14 (no API keys)
`ODOO_TRANSPORT_PREF`	no	`auto` (default) / `jsonrpc` / `xmlrpc`
`ODOO_TIMEOUT`, `ODOO_CACHE_TTL`	no	integers (seconds)
`ODOO_METRICS`, `ODOO_OTEL_ENDPOINT`	no	optional observability

* you must set one of ODOO_API_KEY or ODOO_PASSWORD.

Credentials stay in your environment; nothing is sent to Anthropic nor persisted to disk by the plugin.

Fallback CLI (optional)¶

/odoo-tools:odoo-setup-cli

Requires Node.js 18+. It installs the CLI in ~/.claude/tools/odoo-cli. See the Fallback CLI page for the command details.

Docker (HTTP transport, optional)¶

The repository's docker/ directory includes an example of a multi-tenant HTTP deployment, where clients pass X-Odoo-Url/Db/Login + Bearer headers.

Verify¶

Call the odoo_version tool (or run /odoo-tools:odoo-doctor). A successful response reporting version, edition, deployment and transport confirms the end-to-end installation. See Connection and discovery.