TV MCP Server — Expose Odoo to AI Agents (Claude/Cursor)
by TechnoVista Consult https://technovista.ae$ 127.32
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 1345 |
| Technical Name |
tv_odoo_mcp_server |
| License | OPL-1 |
| Website | https://technovista.ae |
| Versions | 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 1345 |
| Technical Name |
tv_odoo_mcp_server |
| License | OPL-1 |
| Website | https://technovista.ae |
| Versions | 17.0 18.0 19.0 |
TV MCP Server
Expose your Odoo instance to AI agents — securely, with full audit control.
What it does
TV MCP Server turns your Odoo instance into a Model Context Protocol (MCP) server. Any MCP-compatible AI client — including Claude Desktop, Claude Code, Cursor, and OpenAI Codex CLI — can read and act on your Odoo data in natural language, bounded by Odoo's own user permissions and record rules.
The module is secure by default: nothing is MCP-accessible at install time, all write operations are disabled by a single global toggle, and every API call is logged with full context. You decide exactly which models an AI agent can touch and what it can do with them.
A single codebase covers Odoo 17, 18, and 19 — Community and Enterprise — with verified compatibility tests across all three series.
Key features
Read-only by default
A single toggle in the MCP Server config locks all write tools globally. When disabled, create, write, and delete tools are hidden from clients entirely — they do not appear in the MCP tools list. Finance teams and auditors can grant AI read access without any risk of accidental data modification.
MCP Server config: global read-only toggle (default: on)
Per-model access control
No models are MCP-accessible at install time. Admins explicitly add each model to the allow-list with independent Read, Create, Write, and Delete flags. An optional domain filter per model lets you restrict what records an AI agent can reach — for example, limiting a partner model to a single company.
Per-model allow-list: independent R/C/W/D flags + optional domain filter
Full audit log
Every MCP call — whether it succeeds or fails — is logged with timestamp, database name, user, tool name, model accessed, domain filter applied, record count returned, call latency, and outcome. The log is searchable and filterable from the Odoo UI and is not deletable by non-admin users. A configurable retention policy (default 90 days) keeps storage manageable.
Audit log: every MCP call recorded with full context
Connect any MCP client in minutes
Point any MCP-compatible client at your Odoo URL with a standard Odoo API key. No extra credential stores, no external processes, no XML-RPC bridges. The module includes ready-to-use connection snippets for Claude Desktop, Claude Code, and Cursor so your team can be up and running quickly.
Connecting Claude Desktop — standard API key, no extra setup
Full feature list
| Feature | Detail |
|---|---|
| Read-only mode | Single global toggle. Write tools hidden from MCP tools/list when disabled. Default: on. |
| Secure-by-default exposure | No models exposed at install time. Each model must be explicitly added to the allow-list before it is accessible via MCP. |
| Per-model permissions | Independent Read / Create / Write / Delete flags per allowed model, plus an optional domain filter to scope which records are reachable. |
| Audit log | Every call logged: timestamp, DB, user, tool, model, domain, record count, latency, outcome. Searchable from Settings menu. Configurable retention (default 90 days). |
| Native Odoo authentication | Uses standard Odoo API keys (res.users.apikeys). Each AI agent runs as its mapped Odoo user; ACLs and record rules apply automatically. No extra credential store. |
| MCP tool surface | odoo_search_read, odoo_fields_get, odoo_create, odoo_write, odoo_unlink. Write tools enforce allow-list permissions at dispatch. |
| 14 prompt templates | Curated business and developer prompts exposed via MCP prompts/list and prompts/get. Covers aged receivables, dunning emails, sales pipeline, inventory reorder, schema introspection, and more. |
| Transport | MCP Streamable HTTP (2025-06-18 spec) via native Odoo HTTP controller. No external process. No SSE transport. |
| Multi-version compatibility | Single codebase, verified tests green on Odoo 17.0, 18.0, and 19.0. Handles version-specific API differences at runtime (no manual configuration needed). |
| Odoo.sh + on-premise | Works on Odoo.sh and self-hosted instances. Supports multi-DB header routing (X-Odoo-Database) for Odoo.sh environments. |
Why it's safer than alternatives
Most MCP modules for Odoo ship with write access enabled and all models exposed by default. That means an AI agent can modify your data the moment it connects, without any further configuration. TV MCP Server takes the opposite approach.
- Read-only default. The global write-disable toggle is on at install. An AI agent cannot create, update, or delete any record until you explicitly enable write access.
- Nothing exposed until you allow it. The model allow-list is empty at install. No Odoo model is reachable via MCP until an admin adds it. This prevents accidental exposure of sensitive models (HR, payroll, access keys).
- Runs as a scoped Odoo user. Each AI client authenticates with a standard Odoo API key tied to a specific user. Odoo's own ACLs and record rules apply to every tool call — no elevated privileges, no sudo bypasses.
- Full audit log. Every call is logged, including failed or rejected ones. If something unexpected happens, you have a complete, tamper-resistant record of what the AI agent accessed and when.
Includes 14 business and developer prompt templates
TV MCP Server is one of very few modules on the App Store to implement the MCP
prompts/list
and
prompts/get
primitives. Connecting clients (Claude Desktop, Cursor, and any prompt-capable MCP client)
will automatically discover these templates and make them available without any re-prompting.
Sample prompts include: aged receivables summary, dunning email draft, overdue sales orders, inventory reorder suggestions, top customers by revenue, schema introspection, domain builder, and access troubleshooter — plus more.
Compatibility
| Odoo version | Edition | License | Price | Status |
|---|---|---|---|---|
| Odoo 17.0 | Community + Enterprise | OPL-1 | $129 | Available |
| Odoo 18.0 | Community + Enterprise | OPL-1 | $129 | Available |
| Odoo 19.0 | Community + Enterprise | OPL-1 | $129 | Available |
Support
For technical questions, installation help, and bug reports:
- Email: tech@technovistaconsult.com
- Website: https://www.technovistaconsult.com
We respond to support requests within 2 business days (UAE time, Sunday–Thursday).
About TechnoVista Consult
TechnoVista Consult FZC is an Odoo implementation consultancy based in Sharjah Publishing City Free Zone, UAE. We implement Odoo for businesses across the Gulf, publish apps on the Odoo App Store, and sell Odoo Enterprise subscriptions with ongoing support. Our App Store modules are built and tested by the same team that implements Odoo for clients — not outsourced.
TV MCP Server — OPL-1 — $129 per Odoo version
TechnoVista Consult FZC — Sharjah Publishing City Free Zone, UAE — https://www.technovistaconsult.com
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module