Odoo MCP server for Odoo 16, 17, 18, 19 and Community
Odoo 20 now includes its own MCP server: the gateway that lets Claude or ChatGPT read and change your data. It is only available on Odoo 20 Enterprise, though. If your database runs version 16, 17, 18 or 19, or Community, you don't get it. Here is what the native server does, what it needs, and how Aidoo gives every version the same access, with no module to install.
Esteban ANTONIO-MOTA · Data verified on 10 November 2026
📌 Key takeaways
- Odoo's native MCP server is only documented from version 20 onwards. It is part of the AI app, which Odoo Community does not include.
- On Odoo 16, 17, 18 and 19, and on any Community database, Odoo provides no MCP server.
- Aidoo is a hosted MCP server that connects to Odoo 16 to 20, Community or Enterprise, on Odoo Online, Odoo.sh or your own server.
- Nothing to install in Odoo: an Odoo API key is enough, and the Odoo user's access rights apply to every request.
- On Odoo 20 Enterprise, the two work side by side: the native server exposes your custom actions, Aidoo adds ready-to-use tools, a request log and agents.
MCP in two sentences
The Model Context Protocol (MCP) is an open standard, published by Anthropic in November 2024, that defines how an AI assistant calls external tools. An MCP server is the program that exposes those tools: "search quotations", "read a customer record", "create a draft invoice".
Without an MCP server, Claude or ChatGPT can't see your Odoo: they only answer with what you paste into them. With an MCP server, they query the database themselves, with your access rights.
Say you handle 200 quotations a month. Instead of exporting a spreadsheet, you ask: "Which quotations over €5,000 haven't been followed up in 15 days?" The assistant searches Odoo and replies with the list. For the protocol details, read our complete guide to MCP.
What Odoo 20's native MCP server does
With Odoo 20, Odoo documents an MCP server built into its AI app. A compatible client connects to it (the documentation mentions Claude Code, Antigravity and Codex) and calls the tools the administrator has exposed.
- Tools: these are Odoo server actions you choose to expose to the client. Nothing is available until you configure it.
- Authentication: OAuth for internal users (the method Odoo recommends), API key for portal users.
- Client registration: dynamic client registration (DCR) can be turned on, but the documentation warns that it then lets any application register.
- Documented uses: data analysis and reporting, navigating the Odoo interface.
Who doesn't get native MCP
Odoo maintains its last three major versions. Yet many SMEs stay on an older version for years, because a migration takes time and means reworking custom developments. Others chose Community to avoid paying for a license. For them, waiting for Odoo 20 Enterprise before connecting AI is not an option.
| Your Odoo | Native MCP server | Aidoo |
|---|---|---|
| Odoo 16, 17, 18 or 19 (Community or Enterprise) | No: documented from Odoo 20 onwards | Yes |
| Odoo 20 Community | No: the AI app is not in Community | Yes |
| Odoo 20 Enterprise (on-premise, Odoo.sh or Odoo Online) | Yes | Yes, alongside it |
Would you rather upgrade anyway? Our Odoo 20 migration page walks through the process, version by version.
Aidoo: a hosted MCP server for every version
Aidoo is a hosted MCP server at a single address: https://mcp.aidoo.ai/mcp. It connects to your Odoo with an Odoo API key, over XML-RPC, or through the JSON API on databases that no longer expose XML-RPC: it picks the right protocol on its own. No module is installed in your database.
The tools are ready as soon as you connect, with no server action to write:
- Read: search with filters and sorting, record reading, model and field structure, aggregated reports (revenue by month, by salesperson, by product).
- Documents: PDFs of quotations, invoices or delivery slips; when you allow it, attachment upload through a secure link and reading of PDFs or scanned documents.
- Write, only if you allow it: create, update, delete, Odoo buttons (confirm a quotation, validate an invoice).
The full list is in the MCP tool reference.
Native server or Aidoo: side by side
Both rely on the same protocol and respect Odoo's access rights. They differ in the versions they cover, the setup and what you get out of the box.
| Criterion | Odoo 20 native MCP server | Aidoo |
|---|---|---|
| Odoo versions | 20 | 16, 17, 18, 19 and 20 |
| Editions | Enterprise (AI app) | Community and Enterprise |
| Setup | AI app to install and configure in Odoo | No module: an Odoo API key |
| Tools | The server actions you expose | Ready-to-use tools: read, reports, PDF, write when allowed |
| Connection | OAuth (internal users), API key (portal) | OAuth (Claude, ChatGPT, Claude Code), API key (Cursor, Windsurf) |
| Access rights | The Odoo user's rights | The Odoo user's rights, plus the rights checked per connector (read-only by default) |
| Call tracking | Not detailed in the documentation | Log of every request, writes can be undone for 7 days |
| Autonomous agents | Agents in the Odoo 20 AI app | Aidoo agents, scheduled or triggered by an Odoo event |
On Odoo 20 Enterprise, you don't have to choose: the native server handles your custom actions, Aidoo brings its generic tools, its log and its agents. Not sure about your case? Write to us and we'll look at your version and how you use it.
Connect Aidoo to your Odoo in four steps
Allow a few minutes if you already have access to your Odoo and your AI assistant.
Step 1. Create your Aidoo workspace
Sign up for Aidoo. The free trial lasts 14 days, and plans are detailed on the pricing page.
Step 2. Link your Odoo
Enter your Odoo address, the database name, your login and an Odoo API key (in Odoo: Preferences ‣ Account Security ‣ New API Key). Aidoo tests the connection and picks the protocol. Details are in Connect your Odoo.
Step 3. Add the connector to your assistant
The server address is the same for every assistant. Follow the guide for yours: Claude, ChatGPT or Claude Code.
MCP server addresshttps://mcp.aidoo.ai/mcpStep 4. Authorize access, then ask a question
When you connect, you choose the workspace and the connector's rights. Only read access is checked by default. Try: "What are my last 5 quotations?"
Security: what protects your data
Connecting AI to an ERP raises a real question of control. Here are Aidoo's safeguards:
- Every request runs under the member's Odoo identity: Odoo's access rules apply, record by record.
- Write rights are off by default and are checked connector by connector. A workspace owner can limit members to read-only.
- Odoo credentials are encrypted (AES-256-GCM) in Aidoo.
- Every call is recorded in the dashboard log, and writes can be undone for 7 days, depending on the workspace settings.
- Two-factor authentication is available on Aidoo accounts.
Permission details are on the security and permissions page.
Further reading
Frequently asked questions
Does Odoo 19 have an MCP server?
Not in the official documentation: the MCP server page only exists from Odoo 20 onwards. For Odoo 19, as for 16, 17 and 18, you need an external MCP server, such as Aidoo.
Is the Odoo 20 MCP server available in Community?
No. It is part of the AI app, which is not in the Odoo Community 20 source code. Aidoo works with both Community and Enterprise.
Do I need to install a module in Odoo to use Aidoo?
No. Aidoo connects with an Odoo API key, over XML-RPC or through the JSON API. Nothing is installed in your database.
Does Aidoo work with Odoo Online and Odoo.sh?
Yes, and with Odoo hosted on your own server, from version 16 to version 20.
Which AI assistants can I connect?
Claude (on the web, in Claude Desktop and in Claude Code) and ChatGPT through OAuth, with no key to copy. Cursor, Windsurf and other MCP clients connect with an Aidoo API key.
What happens when Odoo removes XML-RPC?
Odoo plans to remove XML-RPC and JSON-RPC in Odoo 22 (autumn 2028) and in Odoo Online 21.1 (winter 2027). Aidoo already uses the JSON API on databases that no longer expose XML-RPC.
Sources
- Odoo 20 documentation: AI app MCP server
- Odoo Community 20 source code (modules)
- Odoo documentation: supported versions
- Odoo 20 documentation: external API and XML-RPC removal
- Odoo: Community and Enterprise editions
- Anthropic: Model Context Protocol announcement
- Model Context Protocol specification
Updated on 10 November 2026
Have an Odoo project, or want to put your ERP to work with AI?
Let's talk about your version, your use cases and the rights to give AI. One conversation is enough to know whether Aidoo fits your database.