- Home
- Odoo Integration
- Odoo MCP
Odoo MCP: the server built into Odoo 20, its 27 tools and how clients sign in
Yes. Odoo 20, released in September 2026, has its own MCP server at your database address plus /mcp. An AI client such as Claude, ChatGPT or Codex signs in by OAuth or an API key and at first sees 5 tools, all of them read-only, until someone on your side turns on the tools that write.
Odoo 20 ships its own MCP server
Odoo’s release notes for Odoo 20 say it plainly: “Connect to your database via MCP”. Odoo 20 came out in September 2026. MCP stands for Model Context Protocol, an open standard for linking AI apps to outside systems. Through it, an AI client can use another system’s tools.
In Odoo’s design, your database is the server. You point an AI client at your database address with /mcp on the end. The client asks Odoo which tools it may use and keeps that list for the session. Then you type a request in plain words, and the client picks a tool and calls it.
Three points from Odoo’s pages set the scope:
- Odoo 20, by the docs. The MCP page is in the 20.0 docs, and Odoo 20’s release notes list it. The same address in the 19.0 docs returned 404 Not Found when we fetched it on 19 November 2026. The pages we read do not say whether Odoo Online’s in-between versions had it sooner.
- No beta label. Neither Odoo MCP page we read calls the server a beta or a preview.
- Part of Odoo AI. Odoo’s AI overview lists the MCP server as one way to use Odoo AI, and installing the AI app on the Standard plan moves a database to the Custom plan. Odoo’s Compare Editions table has no row for the MCP server, so we could not place it in an edition. The table does mark the AI line under Invoicing as Enterprise only.
Two ways to sign in: OAuth or an MCP API key
Odoo recommends OAuth. You approve access from the client, and nobody copies or pastes a key by hand. OAuth works only for internal users, though. Portal users, such as customers and suppliers who log in to your portal, must use an API key.
Scroll the table sideways to see every column.
| OAuth | MCP API key | |
|---|---|---|
| Who can use it | Internal users only | Internal users, and the only way for portal users |
| Clients Odoo gives steps for | Claude, Grok and ChatGPT | Claude (Desktop or Claude Code), Antigravity and Codex |
| What you set | How long access lasts, on Odoo’s Grant Access page | The MCP scope and an expiry, such as 1 month |
| What runs on your machine | Nothing extra | Node.js, which runs a bridge called mcp-remote |
| When it ends | The client asks you to sign in again | The key stops; Odoo shows it only once, so save it |
Your admin decides which AI apps may ask for OAuth access. Approved apps are listed in Settings, under Integrations, MCP OAuth, by their metadata address (Odoo calls it a CIMD). An app that has no such address needs Dynamic Client Registration switched on. Odoo warns that this lets any app register. To block one, archive it under Settings, Technical, OAuth Clients, in developer mode.
Every connection, by OAuth or by key, shows up as an API key in the user’s My Preferences, on the Security tab. Delete it there and the client is cut off.
Each request carries that user’s identity, and Odoo checks it against the user’s permissions. So the AI acts as the person, or the user, it signed in as. Odoo’s API docs advise one key per service, which makes each one easy to trace and revoke. The same reasoning points to a separate Odoo user for each AI client.
27 tools, and only 5 are on at the start
We counted the tools on Odoo’s Available MCP tools page on 19 November 2026. There are 27, in 6 groups. Odoo lists a suggested Readonly status for each: Readonly for 22 of them, not for 5. No tool name contains Delete.
Scroll the table sideways to see every column.
| Group | Tools | Tools that write |
|---|---|---|
| Setup | 1: Retrieve initial context, which runs on its own when a session starts | None |
| Data querying | 8, such as Get Models, Get Fields, Search and Read group | Update Records, Create Records |
| Navigation | 9, such as tools that open a list, kanban, graph or pivot view in Odoo | None |
| Website styling | 4 | Write Custom CSS, Apply HTML to Page |
| Media generation | 3 | Generate an Image, which runs only when you ask for it |
| Additional tools | 2: Web Search and Load Skills | None |
By default a database shows the client just 5 tools: Get Fields, Get Models, Retrieve initial context, Search and Read group. All 5 only read. The rest stay hidden.
To add a tool, turn on developer mode and open Settings, Technical, Server Actions. Each tool is a server action there. Tick Available in MCP on its Usage tab. A server action your developers write can join the list too: turn on Use in AI, then Available in MCP, both on its Usage tab.
Be careful with the Readonly box. It is a hint. Odoo says it does not hide a tool. It only tells the client that the tool is safe to run without asking you. The MCP standard itself says a person should always be able to refuse a tool call. So leave Readonly off any tool that writes.
What Odoo’s own examples ask an AI client to do
Odoo’s MCP page sorts its sample prompts into three groups. One is data analysis and reporting. One is working in Odoo’s screens, which Odoo calls navigation and UI interaction. The last is custom styling of your website. Two examples show how far the tools reach:
- “Create contacts for these five leads I’m pasting in.” That uses Create Records, so it needs that tool exposed.
- “Does Azure Interior have a Tax ID on file? If not, set it to XX0123456789.” That reads a record, then edits it with Update Records.
The reporting prompts, such as comparing this quarter’s invoices with last quarter’s, are on our Odoo dashboards page. The planning prompt about the Master Production Schedule is on our Odoo MRP page.
On Odoo Online, the built-in server is the route
We searched Odoo’s Apps Store on 19 November 2026. With version 20.0 picked, a search for “mcp” returned 202 apps. Turn on the Odoo Online filter and that search, now across all versions, finds 0. The filter does return apps: with no search term, it listed 123 on 18 November 2026.
That matches Odoo’s docs, which say Odoo Online is incompatible with modules from the Apps Store. An MCP module from the store needs Odoo.sh or your own server. On Odoo Online, plan on the server Odoo builds in.
Community MCP servers for Odoo are not Odoo’s
Developers outside Odoo publish their own Odoo MCP servers on GitHub. Odoo did not build them, and they run on your side, holding your Odoo login. Here are two, read from their own repository pages on 19 November 2026:
- ivnvxd/mcp-server-odoo, under the MPL-2.0 licence. It runs on your own computer, not on the Odoo server. For production it needs Odoo 16.0 or later with its own Odoo MCP module installed. A test mode works on any version with XML-RPC on. Its feature list includes deleting records. Its README says that on Odoo 20 the key needs the RPC scope.
- erpipe-org/mcp-odoo, which used to be tuanle96/mcp-odoo, under the MIT licence. Its README says it talks XML-RPC to Odoo 16 to 18 and JSON-2 to 19 and later, and elsewhere that JSON-2 is an opt-in for Odoo 19, with XML-RPC the default. It lists 41 tools and 11 prompts in its full local pack. Direct create, write and unlink are blocked; an approved write needs live metadata, a same-session token, explicit confirmation and an environment switch. The same maintainer also runs a hosted gateway.
A server that uses XML-RPC has an end date. Odoo plans to remove the common and object services of its old RPC API in Odoo 22, due in fall 2028. On Odoo Online it happens sooner, in version 21.1, due in winter 2027. Read a community server’s code and know who maintains it before you give it a key.
Where MCP stops and an agent starts
MCP fits a person who asks questions or makes small edits from a chat window. The person types, reads the answer and decides. A job with no one typing is different. Take a supplier’s emailed bill that should become a draft in Odoo. That needs software that runs on its own.
Odoo’s own agents can run on a trigger. When an automation starts them, Odoo says they create or update records without asking first. Odoo leaves no approval step in that path, so a person-in-the-loop check is something you add. Our Odoo AI agents page covers those builds. Our Odoo integration page compares MCP with the API, webhooks and modules, and our MCP server explainer covers the protocol itself.
Our team has taken Odoo live.
The first call is free.
Questions
Does Odoo have an official MCP server?
Yes. Odoo's release notes for Odoo 20 list it under Connect Odoo to anything, and its docs call the database a remote MCP server. The address is your database URL with /mcp added. An outside AI client can read data through it, and it can change data once your admin exposes the tools that write. The pages we read do not call it a beta.
Which Odoo versions have the MCP server?
Odoo 20, by Odoo's docs. The MCP page exists in the 20.0 docs, and the same address in the 19.0 docs returned 404 Not Found when we fetched it on 19 November 2026. Community servers on GitHub cover older versions, and they are not Odoo's software. ivnvxd/mcp-server-odoo asks for Odoo 16.0 or later with its module, and erpipe-org/mcp-odoo talks XML-RPC to Odoo 16 to 18.
Which AI clients have setup steps in Odoo's MCP docs?
Five products, across two sign-in methods. Odoo's MCP page gives OAuth steps for Claude, Grok and ChatGPT. In ChatGPT you add a custom MCP server under Settings, then Plugins. It also gives API key steps for Claude Desktop, Claude Code, Antigravity and Codex. Those run a small bridge called mcp-remote through Node.js on your own machine.
Can an AI client delete Odoo records through MCP?
Not with the 27 tools on Odoo's list, read on 19 November 2026: no tool name contains Delete. Odoo does not mark five as read-only: Update Records, Create Records, two website styling tools and Generate an Image. A server action your team writes and exposes could delete, so review custom tools first. One community server on GitHub lists a delete tool.
Does the Odoo MCP server work on Odoo Online?
Odoo's MCP docs name no hosting limit, and their own example address, example.odoo.com/mcp, has the form an Odoo Online database uses. Apps Store modules are another matter. Odoo's docs say Odoo Online cannot run them, and a search for mcp with the Odoo Online filter on returned 0 apps on 19 November 2026.
Does an AI client spend Odoo AI credits through MCP?
We could not find out. Odoo's AI overview says Odoo AI uses In-App Purchase credits for AI requests, and offers an outside agent through the MCP server as the alternative. Two of Odoo's 27 tools, Web Search and Generate an Image, do AI work inside Odoo. Odoo's pages do not say whether those spend credits when an outside client calls them.
How do we stop an AI client from changing the wrong records?
Start with the person or user it signs in as. Odoo checks every MCP request against that user's identity and permissions, so give the AI a user of its own with only the access its job needs. Leave the writing tools off until a job needs them. To cut it off, delete its key under My Preferences, Security.
Sources
Every source behind a figure or a vendor fact on this page, with the day we read it.
- Odoo 20 documentation, AI MCP serverRead 19 Nov 2026
- Odoo 20 documentation, Available MCP toolsRead 19 Nov 2026
- Odoo 19 documentation, AI MCP server (returned 404)Read 19 Nov 2026
- Odoo, Odoo 20 release notesRead 19 Nov 2026
- Odoo 20 documentation, Standard and extended supportRead 18 Nov 2026
- Odoo 20 documentation, AI server actionsRead 18 Nov 2026
- Odoo 20 documentation, AIRead 18 Nov 2026
- Odoo 20 documentation, Odoo OnlineRead 18 Nov 2026
- Odoo 20 documentation, eCommerceRead 19 Nov 2026
- Odoo 20 documentation, External RPC APIRead 18 Nov 2026
- Odoo Apps Store, search for mcp, version 20.0Read 19 Nov 2026
- Odoo Apps Store, search for mcp, Odoo Online filterRead 19 Nov 2026
- Model Context Protocol, ToolsRead 18 Nov 2026
- GitHub: ivnvxd/mcp-server-odooRead 19 Nov 2026
- GitHub: erpipe-org/mcp-odooRead 19 Nov 2026
- Odoo, Compare EditionsRead 18 Nov 2026
- Odoo Apps Store, Odoo Online filter with no search termRead 18 Nov 2026
- Odoo 20 documentation, External JSON-2 APIRead 18 Nov 2026
- Odoo, PricingRead 18 Nov 2026
Pick the Odoo tools your AI client may use
The first call is free. Bring the jobs you want an AI client to do in Odoo and the Odoo version you run, and we can talk through which tools each job needs.