Skip to main content

odoo-mcp-tools (server)

Clean-room MIT MCP server for Odoo — Community, Enterprise and online (SaaS), across major versions 10 to 19. This is the Python package that backs the MCP-Odoo-Tools-CE-EE-and-online Claude plugin.

It exposes 28 generic Odoo tools (search / read / search_read / create / write / unlink / execute / export / translate / report / version / connections, plus the Odoo Online tools: profile / API catalog / access check / record documents / import preview / import; see the root README) over a transport layer that speaks JSON-2 (Odoo saas~18.4 / 19.0+, with an API key) or JSON-RPC, with automatic XML-RPC fallback, and a cross-version compatibility layer that resolves model/field names so a single tool call works across every supported version.

Not derived from any AGPL project; relies only on Odoo's public RPC interfaces. It has no third-party runtime dependencies: the MCP stdio protocol and the transports use only the Python standard library. Requires Python 3.9+.

Install & run

python3 run_stdio.py               # from a checkout of server/, nothing to install
pip install . && odoo-mcp          # or install the package, then the entry point

The Claude plugin runs python3 ${CLAUDE_PLUGIN_ROOT}/server/run_stdio.py directly, so nothing is installed when the plugin starts. A Dockerfile is in the repository's docker/ folder.

Configure via environment: ODOO_URL, ODOO_DB, ODOO_LOGIN, ODOO_API_KEY (or ODOO_PASSWORD). Optional: ODOO_TRANSPORT_PREF (auto|jsonrpc|xmlrpc), ODOO_TIMEOUT, ODOO_CACHE_TTL, ODOO_METRICS, ODOO_OTEL_ENDPOINT.

See the repository root README for the full plugin, the CLI fallback, and the compatibility matrix.

License

MIT © Transgenia (Centrum Transgenia SAS)

Metadata

Release files for odoo-mcp-tools 1.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for odoo-mcp-tools 1.5.0
File Size Uploaded Provenance Actions
odoo_mcp_tools-1.5.0.tar.gz 335.9 kB With provenance Details for odoo_mcp_tools-1.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for odoo-mcp-tools 1.5.0
File Interpreter ABI Platform Actions
odoo_mcp_tools-1.5.0-py3-none-any.whl Python 3 none any Details for odoo_mcp_tools-1.5.0-py3-none-any.whl

Total release size: 512.6 kB

Release files / odoo_mcp_tools-1.5.0.tar.gz

Download URL odoo_mcp_tools-1.5.0.tar.gz
Size 335.9 kB
Tags Source
SHA-256 checksum
How to use checksums
aeb2ca82e91035659c1b5e1a0747e6d46b02b2e31b87ef7116a9080cb57287df
BLAKE2b-256 checksum
How to use checksums
820317e1c562576fea7e5c075a62cfa6c555b001c77986a46ff6ed45ab56311e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / odoo_mcp_tools-1.5.0-py3-none-any.whl

Download URL odoo_mcp_tools-1.5.0-py3-none-any.whl
Size 176.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3b1b692c50aaf5be62131210efe867698316292b63886a8c181ba2b083fa022a
BLAKE2b-256 checksum
How to use checksums
d12481674c15eaa6a3a759bc1126cf4769a36db261e1eab8147cea9698fa879e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for odoo-mcp-tools 1.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for odoo_mcp_tools-1.5.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page