Wat is de Odoo API?
API staat voor application programming interface: een vaste manier waarop twee programma's met elkaar praten. Via de API van Odoo kan een ander programma klanten opzoeken, een order aanmaken of een voorraad opvragen. Niemand hoeft nog iets over te tikken.
Elke oproep gebeurt met een API-sleutel die aan een Odoo-gebruiker hangt. Die software ziet en mag dus precies wat die gebruiker ziet en mag. Een koppeling die alleen orders moet aanmaken, krijgt daarom best een eigen gebruiker met alleen die rechten.
Welke gegevens je via de API bereikt, verschilt per database. Odoo toont dat voor elke database op de pagina /doc. Dat is vooral handig voor de ontwikkelaar die de koppeling bouwt.
Welk Odoo-abonnement heb je nodig voor de API?
De externe API zit alleen in het Custom-abonnement. Met One App Free of Standard kan je hem niet gebruiken, ook niet voor een kleine koppeling. Zo staat het in de officiele documentatie van Odoo.
Op Odoo Online werkt de API dus wel, op voorwaarde dat je Custom hebt. Wat daar niet kan, is eigen code installeren. Een connector uit de App Store met eigen code draait daarom meestal op Odoo.sh of een eigen server. Het verschil lees je in Odoo Online, Odoo.sh of on-premise.
XML-RPC, JSON-RPC of JSON-2: wat verandert er?
Sinds Odoo 19 is er een nieuwe API, de JSON-2 API. Een programma stuurt zijn vraag naar het adres /json/2 van je database en meldt zich aan met een API-sleutel. De oudere XML-RPC- en JSON-RPC-API werken nog, maar Odoo raadt ze af en schrapt ze in stappen.
| Wat | Status volgens Odoo | Wat doe je ermee |
|---|---|---|
| JSON-2 API (/json/2) | Nieuw sinds Odoo 19, de vervanger van XML-RPC en JSON-RPC | Nieuwe koppelingen hierop bouwen |
| Databaseservice van XML-RPC en JSON-RPC | Verdwenen in Odoo 20 en in Odoo Online 19.1 | Bij een upgrade naar Odoo 20 nakijken of een koppeling databases aanmaakt of beheert |
| Rest van XML-RPC en JSON-RPC | Verdwijnt in Odoo 22 (najaar 2028) en in Odoo Online 21.1 (winter 2027) | Bestaande koppelingen voor die datum laten ombouwen |
Zit je op Odoo Online, dan komt die datum het snelst. Odoo Online loopt voor op de versies voor eigen hosting, en een update gebeurt daar automatisch. Vraag aan wie je koppeling bouwde of ze al op JSON-2 draait.
Bron: officiele documentatie van Odoo over de externe JSON-2 API en de externe RPC API, geraadpleegd op 2 november 2026.
Wat is een Odoo MCP-server?
MCP staat voor Model Context Protocol, een open standaard waarmee een AI-tool veilig met andere software praat. In Odoo wordt je database zelf de MCP-server. Je koppelt er een AI-tool aan, zoals Claude, ChatGPT, Codex of Google Antigravity, en stelt daarna gewoon je vragen.
Het verschil met de API zit in wie beslist. Bij de API heeft een ontwikkelaar vooraf vastgelegd wat er gebeurt. Bij MCP kiest de AI-tool zelf welke actie hij nodig heeft, binnen de acties die jij openzet.
De MCP-server zit in de AI-app van Odoo 20 en van Odoo Online 19.4. In Odoo 19 op Odoo.sh of een eigen server zit hij niet. Installeer je de AI-app op het Standard-abonnement, dan stuurt Odoo je door naar Custom.
Aanmelden kan op twee manieren. Odoo raadt OAuth aan: je logt in via je browser en kiest hoe lang de toegang geldig blijft. De andere manier is een API-sleutel waarbij je als type MCP kiest. Wat Odoo 20 verder brengt, lees je in Odoo 20: wat is er nieuw.
Wat kan je met MCP in Odoo vragen?
De documentatie van Odoo geeft zelf voorbeelden. Vier daarvan herkent elke kmo meteen.
- 01Hoeveel hebben we vorig kwartaal gefactureerd, tegenover dit kwartaal?Een vraag die je anders beantwoordt met een rapport en een export naar Excel.
- 02Toon mijn open opportuniteiten per fase, en zet de waarde per verkoper in een grafiek.Handig voor het salesoverleg op maandag, zonder dat iemand eerst filters moet zetten.
- 03Heeft deze klant een btw-nummer? Zo niet, vul het in.Deze vraag wijzigt iets in je database. Ze werkt pas als je die actie zelf openzet.
- 04Maak contacten aan voor deze vijf leads.Je plakt de gegevens in je AI-tool en Odoo maakt de contacten aan.
Standaard kan een AI-tool via MCP alleen lezen: modellen en velden opvragen, zoeken en groeperen. Alles wat gegevens wijzigt, staat uit. Je zet het per actie aan in de serveracties van Odoo, met de optie Available in MCP.
Bron: officiele documentatie van Odoo 20 over de AI MCP-server, geraadpleegd op 2 november 2026.
Hoe houd je een koppeling met Odoo veilig?
Een koppeling is een sleutel tot je database. Vier afspraken houden die sleutel in de juiste handen.
Een eigen gebruiker per koppeling
Laat een koppeling nooit draaien op de login van je zaakvoerder of je beheerder. Geef ze een eigen gebruiker met alleen de rechten die ze nodig heeft.
Sleutels met een einddatum
Een API-sleutel krijgt in Odoo een looptijd van maximaal drie maanden. Noteer wanneer hij vervalt, anders stopt je koppeling op die dag.
Alleen AI-tools die jij goedkeurt
Bij MCP met OAuth leg je in de instellingen vast welke AI-tools toegang mogen vragen. De optie die elke tool toelaat, laat je beter uit.
Toegang meteen intrekken
Elke koppeling, ook via MCP, staat als API-sleutel bij de gebruiker onder Voorkeuren, Beveiliging. Verwijder je die sleutel, dan is de toegang weg. Hoe Odoo je gegevens verder beschermt, lees je in is Odoo veilig?
API, webhook, n8n of MCP: wat kies je wanneer?
Ze lossen elk een ander probleem op. Deze tabel helpt je kiezen.
| Manier | Wanneer | Wat je nodig hebt |
|---|---|---|
| API | Een ander programma moet geregeld gegevens lezen of schrijven, zoals een webshop die orders doorstuurt. | Het Custom-abonnement en een ontwikkelaar. |
| Webhook | Odoo moet meteen reageren op iets in een ander systeem, of zelf een signaal versturen als er iets wijzigt. | Odoo Studio, dat in het Custom-abonnement zit. Tussen twee Odoo-databases zonder code, met andere systemen meestal met wat code. |
| n8n, Make of Zapier | Je wil gegevens overzetten tussen tools zonder zelf te programmeren. | Een workflowtool die via de API met Odoo praat, dus ook het Custom-abonnement. |
| MCP | Je wil vanuit een AI-tool in gewone taal vragen stellen aan je Odoo-gegevens. | Odoo 20 of Odoo Online 19.4, de AI-app en een AI-tool die MCP ondersteunt. |
Een workflowtool lijkt de snelste weg, maar elke update van een van de tools kan de koppeling breken. Wanneer dat de moeite loont, lees je in procesautomatisering in je kmo. Voor je webshop, je bank of je betaalprovider kijk je eerst of Odoo het al standaard kan, in Odoo koppelen met je webshop, bank en betaalprovider.
Wie bouwt en onderhoudt je koppeling?
Een koppeling via de API is maatwerk. Ze moet getest worden voor ze live gaat, en nagekeken bij elke upgrade van Odoo. Leg vooraf vast welk systeem de baas is over welke gegevens. Anders overschrijven twee programma's elkaars werk.
Bij OBS bouwden we zo onder meer EDI-koppelingen met retail en groothandels. MCP gebruiken we ook in onze eigen werking, op onze eigen Odoo.