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.6.3

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.6.3
File Size Uploaded Provenance Actions
odoo_mcp_tools-1.6.3.tar.gz 437.7 kB With provenance Details for odoo_mcp_tools-1.6.3.tar.gz

Built distribution (wheel)

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

Total release size: 645.5 kB

Release files / odoo_mcp_tools-1.6.3.tar.gz

Download URL odoo_mcp_tools-1.6.3.tar.gz
Size 437.7 kB
Tags Source
SHA-256 checksum
How to use checksums
cd82a8c467f68e8177c8db554a4b152d7bf9db457e8dc96c868138ffdaa7ac55
BLAKE2b-256 checksum
How to use checksums
d9926d8d29676d7c6feba5c159390e1d5405998b35a56b57a77fa712489f1b73
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 Nov 10, 2026.

Transparency log

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

Download URL odoo_mcp_tools-1.6.3-py3-none-any.whl
Size 207.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d6a5ffd1f0b3fe8c758d82a2302e92fb5fa6513b9cc1afebe2bb3ba48fee48bd
BLAKE2b-256 checksum
How to use checksums
b6de795594eac92513a9825eaebce86eb098ada508da98ac8396ea71011a8c67
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 Nov 10, 2026.

Transparency log

Security for odoo-mcp-tools 1.6.3

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.6.3.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 Nov 10, 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